npx skills — CLI Reference

npx skills (officially npx skills-ws) installs agent skills for AI coding assistants — Claude Code, OpenClaw, Cursor, Codex, and Gemini CLI. Run it inside any project to install all 85 skills, or pass --skill name for one.

Install all skills

$ npx skills-ws

Installs all 85 skills into your project. Works with any SKILL.md-compatible agent.

Install a single skill

$ npx skills-ws --skill seo-geo

Install only the skill you need. Replace seo-geo with any skill name.

What gets installed

Skills are added to your project directory. The exact location depends on your agent:

Claude Code: .claude/skills/
OpenClaw: ~/openclaw/skills/
Cursor: .cursor/skills/
Codex: .codex/skills/

SKILL.md format

Every skill follows the same structure. The frontmatter tells the agent when to activate, the body tells it what to do:

---
name: seo-geo
description: "SEO & GEO optimization for websites.
  Use when the user wants to improve search
  visibility, audit SEO, or optimize for AI
  search engines."
---

# SEO & GEO Optimization

## Initial Assessment
Understand the site context before auditing:
- What type of site? (SaaS, e-commerce, blog)
- What keywords are priorities?
- Current organic traffic level?

## Technical SEO Audit
### Crawlability
- Check robots.txt for unintentional blocks
- Verify XML sitemap exists and is submitted
...

Common command variations

People type the install command many ways. They all resolve to the same thing — skills-ws on npm.

$ npx skills-ws
Canonical form. Installs the full catalog.
$ npx skills
Common shorthand — resolves to skills-ws on npm.
$ npx skills-ws --skill seo-geo
Install one specific skill.
$ npx skills-ws@latest
Force the latest version on npm.
$ npx skill
Singular typo — same package.

How do I list installed skills?

Skills install as SKILL.md files in your agent's skills directory. List them with your file explorer or:

$ ls .claude/skills # Claude Code
$ ls ~/openclaw/skills # OpenClaw
$ ls .cursor/skills # Cursor
$ ls .codex/skills # Codex

Compatible agents

These skills work with any agent that supports the SKILL.md standard:

OpenClaw
Claude Code
Cursor
Codex
Gemini CLI
Any SKILL.md agent