Abstract network of glowing nodes representing the SkillHub catalog
Blog /

Getting started with SkillHub

Install, browse, and publish your first skill. A guided tour through the catalog and the CLI — in twelve minutes from zero to your own published skill.

SkillHub is an open marketplace for AI agent skills — small, composable behaviour packs that drop into Claude Code, the Claude Agent SDK, or any other host that speaks the skill protocol. This post is the shortest useful tour: install the CLI, find a skill that matters to you, and publish your first one. The examples use a document-handling skill, but the same three commands work for anything in the catalog — backend helpers, React components, data tools, prompts.

Install the CLI

The CLI ships as an npx package — no global install needed. Check that it runs and see what is already installed locally:

terminal
npx skillhub --help
npx skillhub list

Find a skill that matters to you

The catalog holds 72,000+ skills across 30 categories — from PDF and spreadsheet tooling to backend APIs, frontend components, and prompt libraries. Search by keyword and sort by aiScore to surface the skills an AI reviewer graded highest:

terminal
npx skillhub search "pdf" --sort aiScore --limit 5
What is aiScore? Every public skill gets a 0–100 aiScore from an AI reviewer that grades four things: instruction quality, description precision, real-world usefulness, and technical soundness. A skill moves from unreviewed to auto-scored to ai-reviewed, and to verified once a human confirms it. Sort by aiScore, start with the high-scorers, and read the full review on each skill’s page.

Install, try, decide

Pick a result and install it by its full skill ID (owner/repo/skill-name). Skills land in ~/.claude/skills/ by default:

terminal
npx skillhub install anthropics/skills/pdf
npx skillhub list

Targeting a different agent? Add --platform (claude, codex, copilot, cursor, windsurf). And if a skill is not what you wanted, remove it cleanly — no manual file deletion:

terminal
npx skillhub uninstall pdf

Publish your first skill

A skill is just a folder with a SKILL.md file at its root — a name, a description with trigger phrases, and the instructions themselves:

my-skill/
my-skill/
└── SKILL.md      # name, description (with triggers), instructions

Push that folder to a public GitHub repository, then submit the repo URL on SkillHub at skills.palebluedot.live/claim. The crawler finds every SKILL.md in the repo, adds it to the catalog, and runs the AI review automatically — there is no separate publish command to remember.

Write the README for the second user. The single best predictor of skill quality is whether the author wrote it for someone other than themselves. Name the user, name the use case, give one example of when this skill is the right tool — and one example of when it isn’t. That same clarity is exactly what the aiScore reviewer rewards.

Where to next

Open any skill’s page in the catalog to read its full AI review and per-criterion scores — the fastest way to learn what “good” looks like before you write your own. When you are ready to ship something polished, the Skill Spotlight category here is a good source of fully-worked examples.

Read next

Leave a Reply

Your email address will not be published. Required fields are marked *