Show HN: Distributing AI agent skills via NPM (github.com)

6 points by surgesoft ↗ HN
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?

2 comments

[ 3.1 ms ] story [ 14.9 ms ] thread
Of all the packaging systems to do this with, npm is certainly one of them.
It seems fine?

After all, Claude, codex and Gemini-cli are all distributed via npm.