SkillPro

Zero-config skill discovery for AI coding agents. One command detects your tech stack and suggests the best-matched skills from a 3,900+ skill registry.

npx skillpro

How It Works

┌─ Detect ──────────────┐   ┌─ Match ───────────────┐   ┌─ Install ─────────────┐
│ package.json reader   │ → │ Registry lookup       │ → │ npx skills add <repo> │
│ priority hierarchy    │   │ priority scoring      │   │ project-scoped        │
│ build-noise filtering │   │ dedup + alternatives  │   │ + CLAUDE.md updater   │
└───────────────────────┘   └───────────────────────┘   └───────────────────────┘

No network calls at runtime for matching. The skill registry ships with the package (3,906 skills from skills.sh + Anthropic's official catalog), updated via npm run build:registry. The actual skill content is fetched once per install from the source repo.

Quick Start

# Interactive: stack detection → checkbox picker → install
npx skillpro

# Preview recommendations without installing
npx skillpro --dry-run

# Install all recommended skills (no prompt)
npx skillpro -y

# Show all matches including alternatives
npx skillpro --dry-run --all

# Export to Cursor .mdc rules after install
npx skillpro --export cursor

# Export to Codex AGENTS.md
npx skillpro --export codex

In the interactive picker:

Key	Action
`↑` `↓` / `k` `j`	Move cursor
`space`	Toggle current skill
`a`	Check all
`n`	Uncheck all
`enter`	Install checked skills
`q` / `esc`	Cancel

Already-installed skills show in cyan with an installed badge and start unchecked so pressing enter doesn't overwrite them. Press space on an installed skill to re-install it.

Detection

Reads package.json and config files, then resolves your stack via a priority hierarchy:

expo (95)      →  overrides react-native, react
react-native   →  overrides react
nextjs (85)    →  overrides react
nuxt (85)      →  overrides vue
sveltekit (85) →  overrides svelte

Build-noise filtering: A React Native project has react and a Gemfile (CocoaPods), but its actual stack is React Native. SkillPro knows that and ignores the Ruby dependency.

Supported stacks: 40+ including Next.js, React Native, Expo, Vue, Svelte, Angular, Astro, Remix, Flutter, Django, FastAPI, Laravel, Rails, Spring Boot, NestJS, Supabase, Prisma, Firebase, Vercel, Cloudflare Workers, Stripe, Playwright, Vitest, Tailwind, shadcn/ui, Docker, Terraform.

Ranking

Skills are sorted by priority:

Curated map (hand-picked per stack, AutoSkills-inspired) → +1000 boost
Anthropic official (anthropics/skills repo) → +10,000
skills.sh with popularity data → +1,000 + weekly installs
Other sources → +100 + GitHub stars

Deduplication groups skills doing the same job (e.g. react-best-practices and vercel-react-best-practices). The highest-priority one is recommended; the rest become alternatives shown with --all.

Every project gets at most 20 recommendations — the best ones, not all matches.

Project-Scoped Install

Skills land in the current project, not your home directory:

your-project/
├── .claude/skills/<id>/SKILL.md   ← Claude Code reads from here
├── skills-lock.json                ← commit this for reproducible installs
└── package.json

skills-lock.json pins every skill to a content hash, just like package-lock.json. Commit it and the rest of the team gets the same skill set via npx skills experimental_install.

Re-running npx skillpro on a project that already has skills is safe — the picker detects them from skills-lock.json (falling back to scanning .claude/skills/), renders them in cyan with an installed badge, and defaults their checkbox to unchecked. Nothing gets re-installed unless you explicitly tick the box.

Monorepo Support

SkillPro detects npm/yarn/pnpm workspaces, lerna, and turborepo. Run it at your monorepo root:

$ npx skillpro
  ✔ javascript / Expo
  Expo, React Native, Next.js, NestJS, Prisma, Stripe, React, Tailwind CSS
  npm · 5 workspaces
    ↳ api     NestJS, Prisma, Stripe
    ↳ mobile  Expo, React Native, React
    ↳ web     Next.js, React, Tailwind CSS
    ↳ @repo/db Prisma
    ↳ @repo/ui React, Tailwind CSS

Skills are aggregated from ALL workspaces (union of stacks). Per-workspace breakdown shows which workspace contributes which tech.

Supported monorepo formats:

System	Detection
npm/yarn workspaces	`package.json` → `workspaces` field
pnpm	`pnpm-workspace.yaml`
Lerna	`lerna.json` → `packages` field
Turborepo	`turbo.json` + workspaces field
Nx	`package.json` workspaces field

Auto-Update System

SkillPro keeps itself fresh via three auto-update layers, all opt-in via config:

┌─ Layer 1 ─────────┐  ┌─ Layer 2 ─────────┐  ┌─ Layer 3 ─────────┐
│ CLI self-update   │  │ Registry refresh  │  │ Skill updates     │
│ 24h cache         │  │ 6h cache, ETag    │  │ Every run         │
│ Yellow banner     │  │ Silent            │  │ Notification      │
└───────────────────┘  └───────────────────┘  └───────────────────┘

Layer 1 — CLI self-update: Checks registry.npmjs.org/skillpro/latest daily. Shows banner if newer version exists. Non-blocking.

Layer 2 — Registry refresh: Fetches skills-registry.json overlay from GitHub raw with ETag. If 304 Not Modified → use local cache. Network failure → fall back to bundled. New skills added to skills.sh appear without requiring npm install.

Layer 3 — Skill updates: Compares installed skill SHAs against the registry. Flags outdated skills and breaking changes in the next run's header so you know what's stale.

Config at ~/.config/skillpro/config.json:

{
  "update": {
    "check_cli": true,
    "check_registry": true,
    "check_skills": true,
    "auto_apply_skills": false,
    "skip_breaking_changes": true
  },
  "notify": {
    "breaking_changes": "always"
  },
  "telemetry": false
}

Cache files at ~/.config/skillpro/:

File	Purpose	TTL
`config.json`	User preferences	Manual
`version-check.json`	CLI version check	24h
`registry-overlay.json`	Fresh registry data	6h
`registry-cache-meta.json`	ETag + timestamp	—
`selections.json`	Installed skills	Manual

Privacy-first: no telemetry by default. Network calls are minimized via ETag (304 Not Modified in ~5ms). Works fully offline with bundled fallback.

Example Output

  ╭──────────────────────────────────────────────────────╮
  │ ✦ SKILLPRO                              ● v2.7.7     │
  │ Zero-config skill discovery for AI coding agents     │
  ╰──────────────────────────────────────────────────────╯

  ✔ typescript / Next.js
  Next.js, React, Supabase, shadcn/ui, Tailwind CSS
  pnpm

  ✔ 20 skills (from 2805 matches)
  187 alternatives hidden — use --all to see

  Select skills to install (space toggle · a all · n none · enter install · q cancel)

  react (10/11)
  > [✓] vercel-react-best-practices  (200)  React and Next.js performance…
    [✓] web-design-guidelines  (190)  Audit UI code against Vercel's…
    [ ] next-best-practices installed  (180)  Next.js development guidelines…
    …

  supabase (1/1)
    [✓] supabase-postgres-best-practices  (150)  Postgres performance rules…

  11/13 selected

[✓] = will be installed · [ ] = will be skipped · installed = already present in this project.

CLI Reference

Usage: npx skillpro [options]

Options:
  -y, --yes          Skip confirmation, install all recommended
  --dry-run          Show skills without installing
  --all              Include alternative skills (unchecked)
  -v, --verbose      Show error details
  -a, --agent <ids>  Target specific agents (cursor,claude-code,codex)
  --sources <urls>   Add extra federated sources (comma-separated)
  --export <target>  Export after install (cursor, codex)
  -h, --help         Show this help
  --version          Show version

Architecture

Module	Responsibility
`src/detect/stack.ts`	Package manifest reader (JS/Python/Ruby/Go/Rust/Java), monorepo walker, priority hierarchy
`src/registry.ts`	Skill matching, priority scoring, dedup, platform filter
`src/install/skills-sh.ts`	Delegates to `npx skills add` (project-scoped)
`src/install/direct-fetch.ts`	Direct SKILL.md fetch for non-skills.sh
`src/install/installed.ts`	Detect already-installed skills via `skills-lock.json`
`src/export/claude.ts`	CLAUDE.md managed section
`src/export/cursor.ts`	`.cursor/rules/*.mdc` generator
`src/export/codex.ts`	AGENTS.md managed section
`src/update/config.ts`	`~/.config/skillpro/config.json` preferences
`src/update/cli-check.ts`	npm registry version check (24h cache)
`src/update/registry-refresh.ts`	GitHub overlay fetch with ETag (6h cache)
`src/update/skill-check.ts`	Installed skill diff against registry
`src/config/skills-registry.json`	Pre-built skill catalog (3,906 skills + curated maps + combos)

Zero runtime dependencies. Node ≥20 only — uses built-in fetch, parseArgs, and fs.

Rebuilding the Registry

The skill registry is regenerated periodically by fetching all skills from skills.sh and Anthropic's official marketplace:

git clone https://github.com/yajinn/skillpro
cd skillpro
npm install
npm run build:registry               # Fetches ~4000 skill pages (takes 3-5 min)
npx tsx scripts/auto-map-repos.ts    # Maps repos to tech stacks
npx tsx scripts/auto-map-skills.ts   # Per-skill stack assignment
npm run build
npm publish

Name		Name	Last commit message	Last commit date
Latest commit History 64 Commits
.claude-plugin		.claude-plugin
.github/workflows		.github/workflows
commands		commands
config		config
docs		docs
hooks		hooks
scripts		scripts
src		src
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
tsconfig.build.json		tsconfig.build.json
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

SkillPro

How It Works

Quick Start

Detection

Ranking

Project-Scoped Install

Monorepo Support

Auto-Update System

Example Output

CLI Reference

Architecture

Rebuilding the Registry

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

SkillPro

How It Works

Quick Start

Detection

Ranking

Project-Scoped Install

Monorepo Support

Auto-Update System

Example Output

CLI Reference

Architecture

Rebuilding the Registry

License

About

Resources

License

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages