Three stages. Runs in under a second. No network calls — the skill registry ships with the package.
Reads package.json, pyproject.toml,
Gemfile, go.mod,
Cargo.toml, and more — then resolves the primary stack
via a priority hierarchy.
Bundled JSON with 3,906 skills from skills.sh and Anthropic's official catalog. Platform filter (web / mobile / desktop) blocks wrong-platform skills. Dedup groups similar skills.
Anthropic official first, then skills.sh weekly installs, then GitHub stars.
Max 20 per project. Alternatives hidden behind --all.
Real output from a Next.js + Supabase + shadcn/ui project.
$ npx skillpro --dry-run SkillPro v2.7.7 Zero-config skill discovery for AI agents ✓ typescript / Next.js Next.js, React, Supabase, shadcn/ui, Tailwind CSS pnpm ✓ Registry refreshed: 3906 skills ✓ 20 skills (from 2805 matches) 187 alternatives hidden — use --all to see nextjs (12) [x] vercel-react-best-practices 321.1K React and Next.js performance optimization guide [x] web-design-guidelines 256.7K Audit UI code against Vercel's Web Interface Guidelines [x] next-best-practices 64.7K Comprehensive Next.js development guidelines supabase (2) [x] supabase-postgres-best-practices 99.7K Postgres performance optimization rules shadcn (4) [x] shadcn 88.7K shadcn/ui component management
A React Native project with a Gemfile (CocoaPods) isn't a Ruby project.
Expo ≠ React Native CLI. Next.js ≠ generic React.
SkillPro resolves the actual stack via priority & build-noise filtering.
Anthropic official (+10k) > skills.sh installs (+weekly) > GitHub stars. Max 20 per project, deduped.
Mobile projects never see web-only skills (Next.js, Vercel, shadcn). Desktop apps don't get browser-specific skills.
The whole catalog ships with the npm package (~600 KB gzipped). skills.sh's 4,000 pages
+ Anthropic's official marketplace — pre-indexed, pre-tagged, ready to match.
Rebuilds via npm run build:registry.
One run curates skills for Claude Code. --export cursor
writes .cursor/rules/*.mdc.
--export codex writes a managed AGENTS.md section.
No external npm packages. Uses built-in fetch,
parseArgs, and fs.
TypeScript compiles to plain JS. 4 MB unpacked.
Three-layer auto-update: CLI version banner (24h), registry refresh via GitHub ETag (6h),
installed skill diff every run. 304 Not Modified = ~5ms.
Offline-first with bundled fallback.
Detects npm/yarn/pnpm workspaces, lerna, turborepo. Aggregates stacks across
apps/* and packages/*.
One command, per-workspace breakdown, unified skill set.
Three layers keep SkillPro, its registry, and your installed skills current — without network hits you don't need.
Queries npm/skillpro/latest, compares semver,
shows yellow banner if newer. Cached 24h.
↑ SkillPro update: 2.5.0 → 2.6.0
Run: npx skillpro@latest
Fetches fresh skill registry from GitHub raw with If-None-Match.
304 response = ~5ms. Falls back to bundled offline.
✓ Registry refreshed: 3906 skills
~/.config/skillpro/
registry-overlay.json
Every run compares your installed SHAs against registry. Flags breaking changes.
Run --update to apply.
↑ Installed updates: → next-best-practices 14→15 ⚠ BREAKING prisma 5→7
{
"update": {
"check_cli": true, // 24h banner
"check_registry": true, // 6h silent
"check_skills": true, // every run
"auto_apply_skills": false // opt-in
},
"telemetry": false // privacy-first
}
Run npx skillpro at the monorepo root. Every apps/* and packages/* is scanned. Skills aggregate from all stacks.
$ npx skillpro --dry-run SkillPro v2.7.7 ✓ 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 ✓ 20 skills (aggregated across 5 workspaces)
npx skillprointeractive install flow-y, --yesinstall all recommended--dry-runpreview only--allinclude alternatives--updateupgrade installed skills-v, --verboseshow error details-a, --agenttarget cursor,claude-code,codex--export cursor→ .cursor/rules/*.mdc--export codex→ AGENTS.md managed-h, --helpshow help--versionprint versionCurate once. Export to other agents in their native format.
One .mdc file per skill under .cursor/rules/.
Description-triggered activation, not always-on.
$ npx skillpro --export cursor ▸ Writing 14 rules to .cursor/rules/ + next-best-practices.mdc + supabase-postgres-best-practices.mdc + shadcn.mdc ! audit-website: references/ skipped
Single AGENTS.md with a managed section.
Your user content outside the markers is preserved across re-exports.
$ npx skillpro --export codex ▸ Bundling 14 skills → AGENTS.md ▸ Preserved user content outside markers # My project notes Use 2-space indent. <!-- skillpro:start --> ## next-best-practices _Activate when: Next.js..._ ... <!-- skillpro:end -->
Open any project. Run npx skillpro. Review.
Install. That's the whole workflow.
npx skillpro