Hey HN! Built a template for distributing AI agent skills via npm.
Problem: AI coding tools (Claude Code, Cursor, Windsurf) support custom
"skills" but distribution is manual - copy files to ~/.tool/skills/,
repeat for updates, no versioning.
Solution: Standard npm packages with lifecycle hooks:
npm install -g @org/my-skill
npm update -g @org/my-skill
Benefits:
- Semantic versioning (^1.2.0 for auto-updates)
- Private registries for enterprise
- Standard CI/CD integration
- Discoverable on npmjs.com
It's a GitHub template - fork, customize SKILL.md, publish. Works
across Claude Code, Cursor, Windsurf, and compatible tools.
Repo: https://github.com/RaoHai/agent-skill-npm-boilerplate
Curious if others have solved this differently?
BarryMilo•4w ago
davely•4w ago
After all, Claude, codex and Gemini-cli are all distributed via npm.