{"_id":"@4meta5/skills-cli","_rev":"7-9bfa89d90514903b486eac61d1647a90","name":"@4meta5/skills-cli","dist-tags":{"latest":"0.5.3"},"versions":{"0.1.0":{"name":"@4meta5/skills-cli","version":"0.1.0","keywords":["claude","ai","skills","anthropic","cli","claude-code"],"author":{"name":"Amar Singh"},"license":"MIT","_id":"@4meta5/skills-cli@0.1.0","maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"homepage":"https://github.com/4meta5/skills#readme","bugs":{"url":"https://github.com/4meta5/skills/issues"},"bin":{"sk":"bin/skills.js","skills":"bin/skills.js"},"dist":{"shasum":"fac514ceff3d9f3e2313d29c07b5936e70b388b9","tarball":"https://registry.npmjs.org/@4meta5/skills-cli/-/skills-cli-0.1.0.tgz","fileCount":483,"integrity":"sha512-x4RJbOuXzdpjVjsWVhCd68adTkeqnH4jg/N6lRX4//0WH9bUs3gcLK3/j+qBBdpd9YordXqnb43c897m47T4Fw==","signatures":[{"sig":"MEQCIGwJeEZqCLP2RuQWkqyQKJ7+qWp32tODyhdlQ9hw+4V+AiB7yepe4eO3QsizTybGvjxyew930+KnuVNo56rLDpqqbA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1833391},"main":"dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","gitHead":"6cbe0f88d5a5d7c15ddfd34591fb179159d0def2","scripts":{"test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build && npm run generate-embeddings","generate-embeddings":"npx tsx scripts/generate-embeddings.ts"},"_npmUser":{"name":"4meta5","email":"orlandodowntownhome@gmail.com"},"repository":{"url":"git+https://github.com/4meta5/skills.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.6.2","description":"CLI for managing Claude Code skills","directories":{},"_nodeVersion":"25.2.1","dependencies":{"cac":"^6.7.14","zod":"^4.3.6","yaml":"^2.3.0","xstate":"^5.26.0","hookable":"^6.0.1","minimatch":"^10.1.1","smol-toml":"^1.6.0","simple-git":"^3.22.0","isolated-vm":"^6.0.2","@4meta5/chain":"*","@4meta5/skills":"*","@inquirer/prompts":"^7.2.1","@4meta5/skill-loader":"*","@xenova/transformers":"^2.17.2","@4meta5/project-detector":"*","@4meta5/semantic-matcher":"*","@4meta5/workflow-enforcer":"*"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.1.0_1770012948897_0.3285936197874342","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@4meta5/skills-cli","version":"0.2.0","keywords":["claude","ai","skills","anthropic","cli","claude-code"],"author":{"name":"Amar Singh"},"license":"MIT","_id":"@4meta5/skills-cli@0.2.0","maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"homepage":"https://github.com/4meta5/skills#readme","bugs":{"url":"https://github.com/4meta5/skills/issues"},"bin":{"sk":"bin/skills.js","skills":"bin/skills.js"},"dist":{"shasum":"fc1d4f4b287bbcd432153e5205fb952f49e2606b","tarball":"https://registry.npmjs.org/@4meta5/skills-cli/-/skills-cli-0.2.0.tgz","fileCount":483,"integrity":"sha512-BrRQ9hDh4j4jiYzMMvmaAo8fL4WHFwWpe/qXVk9dR7Fw213eCoUt2Hi7lIU+vpiNv0IQwMyR/K0bEHoRAz0JXA==","signatures":[{"sig":"MEQCIBh919BYVsgn3iSc33G/rIk74XqPq8R/nSXift0I595gAiBmlXuqQeUjzzwfdBaXUUFYJ9mmmyJVPNcIeDlf9CZLpA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1860162},"main":"dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","gitHead":"2e5b4abe0f62c987427f566801f373f52d275af5","scripts":{"test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build && npm run generate-embeddings","generate-embeddings":"npx tsx scripts/generate-embeddings.ts"},"_npmUser":{"name":"4meta5","email":"orlandodowntownhome@gmail.com"},"repository":{"url":"git+https://github.com/4meta5/skills.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.6.2","description":"CLI for managing Claude Code skills","directories":{},"_nodeVersion":"25.2.1","dependencies":{"cac":"^6.7.14","zod":"^4.3.6","yaml":"^2.3.0","xstate":"^5.26.0","hookable":"^6.0.1","minimatch":"^10.1.1","smol-toml":"^1.6.0","simple-git":"^3.22.0","isolated-vm":"^6.0.2","@4meta5/chain":"*","@4meta5/skills":"*","@inquirer/prompts":"^7.2.1","@4meta5/skill-loader":"*","@xenova/transformers":"^2.17.2","@4meta5/project-detector":"*","@4meta5/semantic-matcher":"*","@4meta5/workflow-enforcer":"*"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.2.0_1770170461439_0.8524621387623388","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@4meta5/skills-cli","version":"0.3.0","keywords":["claude","ai","skills","anthropic","cli","claude-code"],"author":{"name":"Amar Singh"},"license":"MIT","_id":"@4meta5/skills-cli@0.3.0","maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"homepage":"https://github.com/4meta5/skills#readme","bugs":{"url":"https://github.com/4meta5/skills/issues"},"bin":{"sk":"bin/skills.js","skills":"bin/skills.js"},"dist":{"shasum":"a585bfe587a008f220ec02fb93bdaf67dd93a963","tarball":"https://registry.npmjs.org/@4meta5/skills-cli/-/skills-cli-0.3.0.tgz","fileCount":515,"integrity":"sha512-eflICFs69cRMjD/4nLuoxRXOeIk3B7igWW9sJVWDwGxQQcCvIbt+kZpJVGqqaeIanJ2jSytCBYv/zVpacnyCiw==","signatures":[{"sig":"MEYCIQDIdKDNUFVleraeC+pyerG/A4G1+4PDkTlrM8H8Nyb48AIhAMwd2wAKe0GCm6lXN1nI7WpdftEebUVI7Um+b8795RlG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1909801},"main":"dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","gitHead":"6111ffcadc2d568e6fd96c9ec68511afc58e839c","scripts":{"test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build && npm run generate-embeddings","generate-embeddings":"npx tsx scripts/generate-embeddings.ts"},"_npmUser":{"name":"4meta5","email":"orlandodowntownhome@gmail.com"},"repository":{"url":"git+https://github.com/4meta5/skills.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.6.2","description":"CLI for managing Claude Code skills","directories":{},"_nodeVersion":"25.2.1","dependencies":{"cac":"^6.7.14","zod":"^4.3.6","yaml":"^2.3.0","xstate":"^5.26.0","hookable":"^6.0.1","minimatch":"^10.1.1","smol-toml":"^1.6.0","simple-git":"^3.22.0","isolated-vm":"^6.0.2","@4meta5/chain":"*","@4meta5/skills":"*","@inquirer/prompts":"^7.2.1","@4meta5/skill-loader":"*","@xenova/transformers":"^2.17.2","@4meta5/project-detector":"*","@4meta5/semantic-matcher":"*","@4meta5/workflow-enforcer":"*"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.3.0_1770296782185_0.4257666065053334","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@4meta5/skills-cli","version":"0.4.0","keywords":["claude","ai","skills","anthropic","cli","claude-code"],"author":{"name":"Amar Singh"},"license":"MIT","_id":"@4meta5/skills-cli@0.4.0","maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"homepage":"https://github.com/4meta5/skills#readme","bugs":{"url":"https://github.com/4meta5/skills/issues"},"bin":{"sk":"bin/skills.js","skills":"bin/skills.js"},"dist":{"shasum":"9142c79549e4a01497bea3315c92186542eb650f","tarball":"https://registry.npmjs.org/@4meta5/skills-cli/-/skills-cli-0.4.0.tgz","fileCount":519,"integrity":"sha512-eviBJvIjtSUTmPqDZJj7jsIjzMilMy7LufUVZz8xHjGZSKIGDrv/8SIZVBjBw+84t0qAa+0TUr8Yqu5XXcwWrw==","signatures":[{"sig":"MEYCIQCRvkQcU8R2DltMNfw6vsq5sJnxjMRzyRieKSGK4+WquwIhAMAHuP3bqBivCA7v0scxlfWpuHiqLHF9ZNv05ZcwYXty","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1939086},"main":"dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","gitHead":"76a6d2041fdc7810e63a0441d26574e4804ba0bb","scripts":{"test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build && npm run generate-embeddings","generate-embeddings":"npx tsx scripts/generate-embeddings.ts"},"_npmUser":{"name":"4meta5","email":"orlandodowntownhome@gmail.com"},"repository":{"url":"git+https://github.com/4meta5/skills.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.6.2","description":"CLI for managing Claude Code skills","directories":{},"_nodeVersion":"25.2.1","dependencies":{"cac":"^6.7.14","zod":"^4.3.6","yaml":"^2.3.0","xstate":"^5.26.0","hookable":"^6.0.1","minimatch":"^10.1.1","smol-toml":"^1.6.0","simple-git":"^3.22.0","isolated-vm":"^6.0.2","@4meta5/chain":"*","@4meta5/skills":"*","@inquirer/prompts":"^7.2.1","@4meta5/skill-loader":"*","@xenova/transformers":"^2.17.2","@4meta5/project-detector":"*","@4meta5/semantic-matcher":"*","@4meta5/workflow-enforcer":"*"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.4.0_1771026921937_0.5473051430252449","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@4meta5/skills-cli","version":"0.5.1","keywords":["claude","ai","skills","anthropic","cli","claude-code"],"author":{"name":"Amar Singh"},"license":"MIT","_id":"@4meta5/skills-cli@0.5.1","maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"homepage":"https://github.com/4meta5/skills#readme","bugs":{"url":"https://github.com/4meta5/skills/issues"},"bin":{"sk":"bin/skills.js","skills":"bin/skills.js"},"dist":{"shasum":"3e46549499fdd1286ed40dc1d9963762babb6bb7","tarball":"https://registry.npmjs.org/@4meta5/skills-cli/-/skills-cli-0.5.1.tgz","fileCount":519,"integrity":"sha512-X4WuEsrzvmU8kmogwqbo+gYEelWajNZRfzGC3TU7ewiWDvxgxpcEXGiPRIr2aWfDLRzphxPNRTiDsypuZVRyDQ==","signatures":[{"sig":"MEUCIQDJBk5U6+GuDSDCAzw5rqqMdlmZTo81kvKIvw5XWB30xAIgQlDV3Z6Y3InDA/Q0p+3ffLdg9Fjxw2n9f6A06qhsl0s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1945809},"main":"dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","gitHead":"52c629415cc261d1d0c4b68d86a0ad8ec06883df","scripts":{"test":"vitest run","build":"tsc","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build && npm run generate-embeddings","generate-embeddings":"npx tsx scripts/generate-embeddings.ts"},"_npmUser":{"name":"4meta5","email":"orlandodowntownhome@gmail.com"},"repository":{"url":"git+https://github.com/4meta5/skills.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.6.2","description":"CLI for managing Claude Code skills","directories":{},"_nodeVersion":"25.2.1","dependencies":{"cac":"^6.7.14","zod":"^4.3.6","yaml":"^2.3.0","xstate":"^5.26.0","hookable":"^6.0.1","minimatch":"^10.1.1","smol-toml":"^1.6.0","simple-git":"^3.22.0","isolated-vm":"^6.0.2","@4meta5/chain":"*","@4meta5/skills":"*","@inquirer/prompts":"^7.2.1","@4meta5/skill-loader":"*","@xenova/transformers":"^2.17.2","@4meta5/project-detector":"*","@4meta5/semantic-matcher":"*","@4meta5/workflow-enforcer":"*"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.5.1_1771100539055_0.5545207404653225","host":"s3://npm-registry-packages-npm-production"}},"0.5.2":{"name":"@4meta5/skills-cli","version":"0.5.2","keywords":["claude","ai","skills","anthropic","cli","claude-code"],"author":{"name":"Amar Singh"},"license":"MIT","_id":"@4meta5/skills-cli@0.5.2","maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"homepage":"https://github.com/4meta5/skills#readme","bugs":{"url":"https://github.com/4meta5/skills/issues"},"bin":{"sk":"bin/skills.js","skills":"bin/skills.js"},"dist":{"shasum":"5387d348d9e274c24b02c06877c5f0ae24c00a40","tarball":"https://registry.npmjs.org/@4meta5/skills-cli/-/skills-cli-0.5.2.tgz","fileCount":523,"integrity":"sha512-1fLg6Md9ekQ2nzzVLn/So+dBly/2RJv3Me4o0YBki8p950shDWVcQ9zV1IGGDFYLxFDvmKKDaoGxf8wuqGbTNQ==","signatures":[{"sig":"MEUCIH9QNAM7a/NEOUbPzM/88+kEJq8lWPYtoCxopSRf0VEoAiEAs4jnEtAJT0Dt86mkkJ+dwCaxZLU252gZFyjwj3kcLMs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1944861},"main":"dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","gitHead":"cd5dd7db868244a0ba173e506bac18617ebc8908","scripts":{"test":"npm run build -w @4meta5/skill-loader && vitest run","build":"tsc","typecheck":"tsc --noEmit","test:watch":"npm run build -w @4meta5/skill-loader && vitest","prepublishOnly":"npm run build && npm run generate-embeddings","generate-embeddings":"npx tsx scripts/generate-embeddings.ts"},"_npmUser":{"name":"4meta5","email":"orlandodowntownhome@gmail.com"},"repository":{"url":"git+https://github.com/4meta5/skills.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.6.2","description":"CLI for managing Claude Code skills","directories":{},"_nodeVersion":"25.2.1","dependencies":{"cac":"^6.7.14","zod":"^4.3.6","yaml":"^2.3.0","xstate":"^5.26.0","hookable":"^6.0.1","minimatch":"^10.1.1","smol-toml":"^1.6.0","simple-git":"^3.22.0","isolated-vm":"^6.0.2","@4meta5/chain":"*","@4meta5/skills":"*","@inquirer/prompts":"^7.2.1","@4meta5/skill-loader":"*","@xenova/transformers":"^2.17.2","@4meta5/project-detector":"*","@4meta5/semantic-matcher":"*","@4meta5/workflow-enforcer":"*"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.5.2_1771104601512_0.9199146041148265","host":"s3://npm-registry-packages-npm-production"}},"0.5.3":{"name":"@4meta5/skills-cli","version":"0.5.3","description":"CLI for managing Claude Code skills","type":"module","main":"dist/src/index.js","bin":{"skills":"bin/skills.js","sk":"bin/skills.js"},"scripts":{"build":"tsc","test":"npm run build -w @4meta5/skill-loader && vitest run","test:watch":"npm run build -w @4meta5/skill-loader && vitest","typecheck":"tsc --noEmit","generate-embeddings":"npx tsx scripts/generate-embeddings.ts","prepublishOnly":"npm run build && npm run generate-embeddings"},"keywords":["claude","ai","skills","anthropic","cli","claude-code"],"author":{"name":"Amar Singh"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/4meta5/skills.git","directory":"packages/cli"},"homepage":"https://github.com/4meta5/skills#readme","bugs":{"url":"https://github.com/4meta5/skills/issues"},"dependencies":{"@4meta5/skills":"*","@4meta5/skill-loader":"*","@4meta5/project-detector":"*","@4meta5/semantic-matcher":"*","@4meta5/workflow-enforcer":"*","@4meta5/chain":"*","@inquirer/prompts":"^7.2.1","@xenova/transformers":"^2.17.2","cac":"^6.7.14","hookable":"^6.0.1","isolated-vm":"^6.0.2","minimatch":"^10.1.1","simple-git":"^3.22.0","smol-toml":"^1.6.0","xstate":"^5.26.0","yaml":"^2.3.0","zod":"^4.3.6"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0","vitest":"^1.0.0"},"gitHead":"1fc8d9fd71f7225845659c0557cd818e59c8200d","types":"./dist/src/index.d.ts","_id":"@4meta5/skills-cli@0.5.3","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-s5aV607QsxCDTdEMibmHw+qlqi38RuRQNtZZBMIZ2242o45Nr0e6Ohx81NCZRaIO2QxCw/LlUNxlXkLz6tqpZg==","shasum":"5af6eddc8fc77a780e43083ea69ec29498a0bc0c","tarball":"https://registry.npmjs.org/@4meta5/skills-cli/-/skills-cli-0.5.3.tgz","fileCount":523,"unpackedSize":1945491,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDxL+HaoVaQvU50YFWyse+s7WRoCDMVxT4xVL06CUgUdQIhAPWRVceOvecg0epza/VpTVqHDWoSnLoGwrmjWEYS1JnQ"}]},"_npmUser":{"name":"4meta5","email":"orlandodowntownhome@gmail.com"},"directories":{},"maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skills-cli_0.5.3_1771107337844_0.7655682207102508"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-02T06:15:48.796Z","modified":"2026-02-14T22:15:38.170Z","0.1.0":"2026-02-02T06:15:49.098Z","0.2.0":"2026-02-04T02:01:01.781Z","0.3.0":"2026-02-05T13:06:22.375Z","0.4.0":"2026-02-13T23:55:22.149Z","0.5.1":"2026-02-14T20:22:19.249Z","0.5.2":"2026-02-14T21:30:01.686Z","0.5.3":"2026-02-14T22:15:38.040Z"},"bugs":{"url":"https://github.com/4meta5/skills/issues"},"author":{"name":"Amar Singh"},"license":"MIT","homepage":"https://github.com/4meta5/skills#readme","keywords":["claude","ai","skills","anthropic","cli","claude-code"],"repository":{"type":"git","url":"git+https://github.com/4meta5/skills.git","directory":"packages/cli"},"description":"CLI for managing Claude Code skills","maintainers":[{"name":"4meta5","email":"orlandodowntownhome@gmail.com"}],"readme":"# @4meta5/skills-cli\n\nCLI for discovering, installing, and managing Claude Code skills.\n\n## Installation\n\n```bash\nnpm install -g @4meta5/skills-cli\n```\n\n## Quick Start\n\n```bash\n# Scan your project for recommended skills\nskills scan\n\n# Install all high-confidence recommendations\nskills scan --all\n\n# List installed skills\nskills list\n\n# Add a specific skill\nskills add tdd\n\n# Show skill details\nskills show tdd\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `scan` | Analyze project and recommend skills |\n| `scan --all` | Install all HIGH confidence recommendations |\n| `scan --show-alternatives` | Show all matches, not just top per category |\n| `add <name>` | Install a skill by name |\n| `add <name> from <source>` | Install from a specific source |\n| `list` | List installed skills |\n| `list --custom` | List only custom skills (your own) |\n| `list --upstream` | List only upstream skills (from sources) |\n| `list --provenance` | Show provenance type for each skill |\n| `show <name>` | Display skill details |\n| `remove <name>` | Uninstall a skill |\n| `validate` | Validate skill files in the project |\n| `update --check` | Check for upstream skill updates |\n| `update <name>` | Update a skill from its source |\n| `update --all` | Update all upstream skills |\n| `hygiene scan` | Detect auto-generated test slop |\n| `hygiene clean --confirm` | Delete detected slop |\n| `claudemd sync` | Sync CLAUDE.md with installed skills |\n| `hook available` | List bundled hooks |\n| `hook add <names>` | Install hooks to project |\n| `hook list` | List installed hooks |\n| `hook remove <names>` | Remove hooks from project |\n| `evaluate <prompt>` | Test skill routing for a prompt |\n| `embed` | Generate skill embeddings |\n| `source list` | List configured skill sources |\n| `source add <url>` | Add a skill repository |\n| `sync <name> --push` | Push a skill to all tracked projects |\n| `stats` | Show usage analytics |\n| `init` | Initialize skills in current project |\n\n## Skill Scanning\n\nThe CLI analyzes your project to recommend relevant skills:\n\n```bash\nskills scan\n```\n\nOutput:\n```\nHIGH   tdd                    Testing workflow enforcement\nHIGH   typescript-strict      TypeScript best practices\nMEDIUM security-analysis      Security review for PRs\nLOW    aws-cdk                AWS CDK patterns\n```\n\nConfidence levels:\n- **HIGH**: Strong match based on tech stack and file patterns\n- **MEDIUM**: Partial match, likely useful\n- **LOW**: Weak match, may not be relevant\n\n## Provenance Tracking\n\nSkills track where they came from:\n\n```bash\n# See which skills are yours vs upstream\nskills list --provenance\n\n# List only skills you created\nskills list --custom\n\n# List only skills from external sources\nskills list --upstream\n```\n\n## Hooks\n\nHooks make skills activate automatically. Install them once:\n\n```bash\n# See available hooks\nskills hook available\n\n# Install hooks\nskills hook add skill-forced-eval semantic-router usage-tracker\n\n# Check what's installed\nskills hook list\n```\n\nAvailable hooks:\n\n| Hook | Purpose |\n|------|---------|\n| `setup-shims` | Prepends project-local shims to PATH (SessionStart) |\n| `skill-forced-eval` | Forces Claude to evaluate and activate relevant skills |\n| `semantic-router` | Matches prompts to skills using embeddings |\n| `usage-tracker` | Logs skill activations to `~/.claude/usage.jsonl` |\n\n## Skill Sources\n\nAdd external skill repositories:\n\n```bash\n# Add a source\nskills source add https://github.com/user/skills-repo\n\n# List configured sources\nskills source list\n\n# Install from a specific source\nskills add my-skill from my-source\n```\n\n## Updating Skills\n\nKeep upstream skills current:\n\n```bash\n# Check for available updates\nskills update --check\n\n# Update a specific skill\nskills update tdd\n\n# Update all upstream skills\nskills update --all\n\n# Update with security review\nskills update tdd --review\n```\n\n## Hygiene\n\nClean auto-generated test artifacts:\n\n```bash\n# Scan for test-skill-* directories and slop\nskills hygiene scan\n\n# Include package subdirectories\nskills hygiene scan -r\n\n# Delete detected slop\nskills hygiene clean --confirm\n```\n\n## CLAUDE.md Sync\n\nKeep your CLAUDE.md in sync with installed skills:\n\n```bash\n# Sync references to match installed skills\nskills claudemd sync\n```\n\n## Configuration\n\nThe CLI uses these directories:\n\n| Location | Purpose |\n|----------|---------|\n| `.claude/skills/` | Project-level skills |\n| `~/.claude/skills/` | User-level skills |\n| `~/.claude/usage.jsonl` | Usage tracking data |\n\n## Semantic Routing\n\nSkills activate based on prompt similarity. The router combines:\n\n- **Keyword matching** (30% weight): Fast regex patterns\n- **Embedding similarity** (70% weight): Semantic understanding\n\nActivation modes:\n- **IMMEDIATE** (>0.85): Force activation via MUST_CALL\n- **SUGGESTION** (0.70-0.85): Recommend via CONSIDER_CALLING\n- **CHAT** (<0.70): No activation\n\n## Integration\n\nThis CLI integrates with these packages:\n\n- `@4meta5/skills` - Core library for skill management\n- `@4meta5/skill-loader` - SKILL.md parsing\n- `@4meta5/project-detector` - Tech stack detection\n- `@4meta5/semantic-matcher` - Prompt-to-skill matching\n- `@4meta5/workflow-enforcer` - TDD and workflow enforcement\n- `@4meta5/chain` - Skill chaining and DAG resolution\n\n## License\n\nMIT\n","readmeFilename":"README.md"}