Show HN: Distributing AI agent skills via NPM

6 points

5 months ago

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