{"_id":"@alcyone-labs/agent-skills","_rev":"3-86506ab3fc3b7e6a7e6c5e35e885fd2c","name":"@alcyone-labs/agent-skills","dist-tags":{"latest":"2.1.0"},"versions":{"1.0.0":{"name":"@alcyone-labs/agent-skills","version":"1.0.0","keywords":["ai","agents","skills","cli","installer","opencode","gemini","claude","mcp"],"author":{"name":"Alcyone Labs"},"license":"MIT","_id":"@alcyone-labs/agent-skills@1.0.0","maintainers":[{"name":"nembleton","email":"nicolas.embleton@gmail.com"}],"homepage":"https://github.com/Alcyone-Labs/agent-skills#readme","bugs":{"url":"https://github.com/Alcyone-Labs/agent-skills/issues"},"bin":{"agent-skills":"dist/installer.js"},"dist":{"shasum":"668b9114f3f33e0078d63cb58f9e76a289979551","tarball":"https://registry.npmjs.org/@alcyone-labs/agent-skills/-/agent-skills-1.0.0.tgz","fileCount":18,"integrity":"sha512-b/3gu4ymI/lNQE2+RKLdNtJUeyP5I2ToBJXPh7v6Fx+3mOQy3i6txUPmqSzUb63pESohIrljEHy6ZoBJP8LLyQ==","signatures":[{"sig":"MEUCIQDfSYmvylefUCvWupVJTUlqAKSvh/5XnFiTuZt5fC7EEQIgRPCF6G2HXr/I+4IwqvqYbP0USiXUzZml3TQzeJo+6po=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62973},"main":"./dist/installer.js","type":"module","_from":"file:alcyone-labs-agent-skills-1.0.0.tgz","types":"./dist/installer.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"bun run ./src/installer.ts","build":"tsc","start":"bun run ./dist/installer.js","typecheck":"tsc --noEmit"},"_npmUser":{"name":"nembleton","email":"nicolas.embleton@gmail.com"},"_resolved":"/private/var/folders/27/xlh5p6rd54vgnqk_t2kq551c0000gn/T/3e2a1805f84a9c16411525956b9a1dd5/alcyone-labs-agent-skills-1.0.0.tgz","_integrity":"sha512-b/3gu4ymI/lNQE2+RKLdNtJUeyP5I2ToBJXPh7v6Fx+3mOQy3i6txUPmqSzUb63pESohIrljEHy6ZoBJP8LLyQ==","repository":{"url":"git+https://github.com/Alcyone-Labs/agent-skills.git","type":"git","directory":"installer"},"_npmVersion":"11.8.0","description":"Interactive installer for Agent Skills - Install AI agent skills from Alcyone Labs","directories":{},"_nodeVersion":"22.21.0","dependencies":{"@alcyone-labs/arg-parser":"^2.14.2"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.8"},"_npmOperationalInternal":{"tmp":"tmp/agent-skills_1.0.0_1770261365186_0.003231463835501991","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@alcyone-labs/agent-skills","version":"2.0.0","keywords":["ai","agents","skills","cli","installer","opencode","gemini","claude","mcp"],"author":{"name":"Alcyone Labs"},"license":"MIT","_id":"@alcyone-labs/agent-skills@2.0.0","maintainers":[{"name":"nembleton","email":"nicolas.embleton@gmail.com"}],"homepage":"https://github.com/Alcyone-Labs/agent-skills/tree/main/installer","bugs":{"url":"https://github.com/Alcyone-Labs/agent-skills/issues"},"bin":{"agent-skills":"dist/installer.js"},"dist":{"shasum":"ffeca3601f7e181538013919d7208d8a80214897","tarball":"https://registry.npmjs.org/@alcyone-labs/agent-skills/-/agent-skills-2.0.0.tgz","fileCount":30,"integrity":"sha512-gORbBdXcqU56Scx+sJBoTvesFJXeGbr1PUYO/s7rib0NP7GYYOajTxRoZ8dIf3JWE/b8fFzBHHM7jbeCjlcHUA==","signatures":[{"sig":"MEUCIFrCpdmRfh3uW2Iro/xbhunWusfswnl3WGTCrsatg+lXAiEA3eBEt92x5aiYm6SyV3DjlvtooNg84gDOhrndVY89p4A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":135157},"main":"./dist/installer.js","type":"module","_from":"file:alcyone-labs-agent-skills-2.0.0.tgz","types":"./dist/installer.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"bun run ./src/installer.ts","test":"npm run build && node --test dist/core/lifecycle.test.js","build":"tsc","start":"node ./dist/installer.js","typecheck":"tsc --noEmit"},"_npmUser":{"name":"nembleton","email":"nicolas.embleton@gmail.com"},"_resolved":"/private/var/folders/27/xlh5p6rd54vgnqk_t2kq551c0000gn/T/7b9327d24aeb35a853e0ea41a6b5327c/alcyone-labs-agent-skills-2.0.0.tgz","_integrity":"sha512-gORbBdXcqU56Scx+sJBoTvesFJXeGbr1PUYO/s7rib0NP7GYYOajTxRoZ8dIf3JWE/b8fFzBHHM7jbeCjlcHUA==","repository":{"url":"git+https://github.com/Alcyone-Labs/agent-skills.git","type":"git","directory":"installer"},"_npmVersion":"11.11.1","description":"Manifest-driven Agent Skills lifecycle CLI (.agents canonical install model)","directories":{},"_nodeVersion":"22.21.0","dependencies":{"@alcyone-labs/arg-parser":"^2.14.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.8"},"_npmOperationalInternal":{"tmp":"tmp/agent-skills_2.0.0_1773388711091_0.6661866497951225","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@alcyone-labs/agent-skills","version":"2.1.0","description":"Manifest-driven Agent Skills lifecycle CLI (.agents canonical install model)","type":"module","main":"./dist/installer.js","bin":{"agent-skills":"dist/installer.js"},"keywords":["ai","agents","skills","cli","installer","opencode","gemini","claude","mcp"],"author":{"name":"Alcyone Labs"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Alcyone-Labs/agent-skills.git","directory":"installer"},"homepage":"https://github.com/Alcyone-Labs/agent-skills/tree/main/installer","bugs":{"url":"https://github.com/Alcyone-Labs/agent-skills/issues"},"publishConfig":{"access":"public"},"dependencies":{"@alcyone-labs/arg-parser":"^3.0.0","@alcyone-labs/arg-parser-mcp":"^3.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.9.3"},"engines":{"node":">=18.0.0"},"scripts":{"generate:source-skill-index":"node ./scripts/generate-source-skill-index.mjs","build":"npm run generate:source-skill-index && tsc","dev":"bun run ./src/installer.ts","start":"node ./dist/installer.js","typecheck":"npm run generate:source-skill-index && tsc --noEmit","test":"npm run build && node --test dist/core/catalog.test.js dist/core/mcp-config.test.js dist/core/lifecycle.test.js dist/installer.test.js"},"types":"./dist/installer.d.ts","_id":"@alcyone-labs/agent-skills@2.1.0","_integrity":"sha512-WdXnYUlkNel+mfolN2qdoYdQ9mTvqmNvaHksvB7xyVz3i3tZl9OITvCwVeDK/yeEjVIU+h8DPOBZUnIDbceqDQ==","_resolved":"/private/var/folders/27/xlh5p6rd54vgnqk_t2kq551c0000gn/T/a1d506c5cdc5687ce5eac7333d1ff797/alcyone-labs-agent-skills-2.1.0.tgz","_from":"file:alcyone-labs-agent-skills-2.1.0.tgz","_nodeVersion":"22.21.0","_npmVersion":"11.11.1","dist":{"integrity":"sha512-WdXnYUlkNel+mfolN2qdoYdQ9mTvqmNvaHksvB7xyVz3i3tZl9OITvCwVeDK/yeEjVIU+h8DPOBZUnIDbceqDQ==","shasum":"854896694343d526435a190eeabff4cd28f9ef52","tarball":"https://registry.npmjs.org/@alcyone-labs/agent-skills/-/agent-skills-2.1.0.tgz","fileCount":55,"unpackedSize":297547,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDQssOhD+YnP37x7zUiwZjDTUzEAXIFDqGOtN2nQjYLIwIgD8bkViMyZjIyMhMBjbZykDyk0B1LupCfZUfMvgIaKz4="}]},"_npmUser":{"name":"nembleton","email":"nicolas.embleton@gmail.com"},"directories":{},"maintainers":[{"name":"nembleton","email":"nicolas.embleton@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-skills_2.1.0_1773420043990_0.4647532883474299"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-05T03:16:05.068Z","modified":"2026-03-13T16:40:44.329Z","1.0.0":"2026-02-05T03:16:05.352Z","2.0.0":"2026-03-13T07:58:31.243Z","2.1.0":"2026-03-13T16:40:44.177Z"},"bugs":{"url":"https://github.com/Alcyone-Labs/agent-skills/issues"},"author":{"name":"Alcyone Labs"},"license":"MIT","homepage":"https://github.com/Alcyone-Labs/agent-skills/tree/main/installer","keywords":["ai","agents","skills","cli","installer","opencode","gemini","claude","mcp"],"repository":{"type":"git","url":"git+https://github.com/Alcyone-Labs/agent-skills.git","directory":"installer"},"description":"Manifest-driven Agent Skills lifecycle CLI (.agents canonical install model)","maintainers":[{"name":"nembleton","email":"nicolas.embleton@gmail.com"}],"readme":"# @alcyone-labs/agent-skills 2.1.0\n\nManifest-driven lifecycle CLI for Agent Skills.\n\nSee [`CHANGELOG.md`](./CHANGELOG.md) for the 2.1.0 release notes and differences from 2.0.0.\n\n## What's new in 2.1.0 vs 2.0.0\n\n2.1.0 expands the installer from install-only lifecycle management into a source-skill discovery and MCP-friendly workflow layer.\n\nHighlights:\n- `list` and `find` for source-skill discovery\n- `use` for ephemeral source-skill execution without persistent `.agents` install state\n- MCP tools for `find`, `use`, and `install`\n- `print-mcp-config` for JSON-only MCP config generation\n- repeated `--allow-skill` / `--deny-skill` policy flags for MCP restriction\n- packaged generated source-skill catalog for metadata-only commands\n- BM25-ranked search over shipped skill metadata\n- command-specific auto-help via ArgParser\n- logger-safe CLI output paths instead of direct `console.*` writes in the installer entrypoint\n- improved CLI catalog rendering for `list` / `find` using colored output when the terminal supports it\n\n\n## Canonical install model\n\n- Global skills: `~/.agents/skills/<skill>`\n- Global bins: `~/.agents/bin/<command>`\n- Local skills: `./.agents/skills/<skill>`\n- Local bins: `./.agents/bin/<command>`\n\nCompatibility exports are derived from canonical `.agents` installs (Claude enabled by default).\n\n## Use without installing the package\n\n### npm / npx\n\n```bash\nnpx --yes @alcyone-labs/agent-skills --help\nnpx --yes @alcyone-labs/agent-skills list\nnpx --yes @alcyone-labs/agent-skills find \"browser markdown extraction\"\n```\n\n### pnpm / pnpx\n\n```bash\npnpm dlx @alcyone-labs/agent-skills --help\npnpx @alcyone-labs/agent-skills install lightpanda --local --dry-run\n```\n\n## Install globally\n\n### npm\n\n```bash\nnpm install -g @alcyone-labs/agent-skills\nagent-skills --help\n```\n\n### pnpm\n\n```bash\npnpm add -g @alcyone-labs/agent-skills\nagent-skills --help\n```\n\n## Command surface\n\nUse `agent-skills --help` for top-level help and `agent-skills <command> --help` for command-specific help.\n\n```bash\nagent-skills install <skill> [--local|--global] [--dry-run]\nagent-skills list\nagent-skills find <free-text request> [--limit 1..5]\nagent-skills use <skill> <skill-bin> [args...]\nagent-skills run <skill> <skill-bin> [args...]\nagent-skills validate [<skill>] [--local|--global]\nagent-skills update <skill> [--local|--global] [--dry-run]\nagent-skills uninstall <skill> [--local|--global] [--dry-run]\nagent-skills prune [--local|--global] [--dry-run]\nagent-skills reset <skill> [--local|--global] [--dry-run]\nagent-skills clean [--local|--global] [--dry-run]\nagent-skills purge <skill> [--local|--global] [--dry-run]\nagent-skills print-mcp-config [--allow-skill <name>] [--deny-skill <name>]\n```\n\nAll mutating commands honor `--dry-run`.\n\n## Discover source skills\n\nList every source skill with its description from the packaged source catalog index (no GitHub clone or local source checkout required):\n\n```bash\nagent-skills list\n```\n\nFind the most relevant 1-5 skills for a request using BM25 over the shipped skill catalog metadata:\n\n```bash\nagent-skills find \"chrome extension mv3 service worker auth\"\nagent-skills find \"browser markdown extraction\" --limit 3\nagent-skills find \"jazz service worker\" --limit 5\n```\n\n`list` and `find` are metadata-only commands. `install` and `use` still resolve real source skill contents on demand from the local repo or remote source when needed.\n\n## Run a skill without installing it\n\n`use` stages the source skill in a temporary directory, provisions its runtime if needed, runs the requested command, and removes the temporary copy afterwards.\n\n```bash\nagent-skills use lightpanda lightpanda-fetch https://example.com\n```\n\n`run` keeps its existing meaning: execute a runnable command from source or installed skill precedence.\n\n```bash\nagent-skills run lightpanda lightpanda-fetch https://example.com\n```\n\n## MCP support\n\nThe CLI exposes these MCP tools:\n\n- `find`\n- `use`\n- `install`\n\nStart the MCP server directly:\n\n```bash\nnpx --yes @alcyone-labs/agent-skills --s-mcp-serve\n```\n\nRestrict the server to an allow-list and/or deny-list of skills:\n\n```bash\nnpx --yes @alcyone-labs/agent-skills --s-mcp-serve \\\n  --allow-skill lightpanda \\\n  --allow-skill skill-forge \\\n  --deny-skill exa-search\n```\n\nPolicy rules:\n\n- default: all skills are allowed\n- deny-list wins over allow-list\n- `find` only returns allowed skills\n- `install` and `use` reject denied or out-of-scope skills\n\n## Generate MCP config JSON\n\n`print-mcp-config` writes pure JSON to stdout with no headings or extra log output.\n\nDefault config:\n\n```bash\nagent-skills print-mcp-config\n```\n\nRestricted config:\n\n```bash\nagent-skills print-mcp-config \\\n  --allow-skill lightpanda \\\n  --allow-skill skill-forge \\\n  --deny-skill exa-search\n```\n\nExample output:\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-skills\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"--yes\",\n        \"@alcyone-labs/agent-skills\",\n        \"--s-mcp-serve\",\n        \"--allow-skill\",\n        \"lightpanda\",\n        \"--deny-skill\",\n        \"exa-search\"\n      ]\n    }\n  }\n}\n```\n\n## Development notes\n\n`npm run build` regenerates `src/core/source-skill-index.generated.ts` before compiling TypeScript.\n`npm run typecheck` also regenerates the source-skill index first, so stale packaged metadata does not drift from the repo skill set.\n\nRelevant scripts:\n- `npm run generate:source-skill-index` — regenerate the packaged source catalog only\n- `npm run build` — regenerate the source catalog, then run `tsc`\n- `npm run typecheck` — regenerate the source catalog, then run `tsc --noEmit`\n\n\n## Publish checklist\n\n1. `npm test`\n2. `npm pack --dry-run`\n3. `npm publish --access public` (or with dist-tag as needed)\n\nReference docs:\n- npm publish: https://docs.npmjs.com/cli/v10/commands/npm-publish\n- npm exec/npx semantics: https://docs.npmjs.com/cli/v10/commands/npm-exec\n- pnpm dlx (`pnpx` alias): https://pnpm.io/cli/dlx\n- pnpm global add: https://pnpm.io/cli/add\n","readmeFilename":"README.md"}