Skip to main content

Getting Started

Your AI coding assistant is only as good as the instructions you give it. Skills are those instructions — packaged, versioned, and installable in one command. You'll be up and running in under 30 seconds.

Try it right now — no account needed

npx @skills-hub-ai/cli install code-review

This installs a code review skill. Then type /code-reviewin Claude Code or Cursor to use it. That's the entire workflow.

The full walkthrough

1. Install your first skill

No setup, no config files. Just this:

npx @skills-hub-ai/cli install code-review

This downloads the skill's SKILL.md file to ~/.claude/skills/code-review/ (or ~/.cursor/skills/ for Cursor with --target cursor).

2. Use it

Type /code-review in Claude Code or Cursor. Done. Your AI now knows exactly how to review code the way you want it to. No prompt engineering, no copy-pasting instructions every session.

If a skill is a composition(a pipeline of multiple skills), all dependencies are installed automatically. For example, installing a "full story lifecycle" skill that chains /arch-review then /story-implementer then /pr will install all three child skills alongside the parent.

3. Works everywhere

Skills aren't locked to one tool. The skills-hub MCP server exposes your installed skills as prompts in any MCP-compatible AI tool — including Windsurf, Copilot, and others.

Claude Code

claude mcp add skills-hub -- npx @skills-hub-ai/mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "skills-hub": {
      "command": "npx",
      "args": ["@skills-hub-ai/mcp"]
    }
  }
}

Any other MCP client

Point your tool at npx @skills-hub-ai/mcp as a stdio MCP server. The server scans both ~/.claude/skills/ and ~/.cursor/skills/ and serves each installed skill as an MCP prompt.

4. Browse and search

The skill catalog has hundreds of skills from Anthropic, Microsoft, Google, Cloudflare, and the developer community. Search by keyword, natural language, or filter by company, category, and platform. Every skill shows quality scores, install counts, and community ratings.

Or search from your terminal:

npx @skills-hub-ai/cli search "code review"
npx @skills-hub-ai/cli search --category review --sort highest_rated

5. Publish your own

Got a workflow that works? Package it. A skill is just a SKILL.md file with YAML frontmatter:

---
name: My Skill
description: What this skill does in one sentence
version: 1.0.0
category: code-quality
platforms:
  - CLAUDE_CODE
---

Your skill instructions go here. This is the content
that will be injected into the AI assistant's context.

Then publish via the CLI or web:

npx @skills-hub-ai/cli login          # sign in (GitHub, Google, or email)
npx @skills-hub-ai/cli publish        # publishes ./SKILL.md

You can control who sees your skill with --visibility: public (default), unlisted, private, or org (organization members only). Published skills go through an automated AI quality review.

Or use the web publish page — you can describe what you want and AI generates the name, description, category, tags, and instructions for you.

FieldRequiredDescription
nameYesDisplay name (1-100 chars)
descriptionYesShort summary (10-1000 chars)
versionYesSemver (e.g. 1.0.0)
categoryYesOne of the available categories
platformsYesCLAUDE_CODE, CURSOR, CODEX_CLI, or OTHER
tagsNoUp to 10 searchable tags

6. Guided setup

Run init for a guided walkthrough that checks your platform, auth status, installed skills, and suggests popular skills:

npx @skills-hub-ai/cli init

Next steps