your-skill-name

Publish and manage Claude Code agent skills as npm packages with versioning.

25|6|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/afx-team/agent-skill-npm-boilerplate --skill your-skill-name-afx-team
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: your-skill-name
Source: https://github.com/afx-team/agent-skill-npm-boilerplate/tree/main
Command: npx skills add https://github.com/afx-team/agent-skill-npm-boilerplate --skill your-skill-name-afx-team

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @agentskill/installer, and includes scripts (resource) components.

What problem does it solve?

Distribute and manage Claude Code agent skills as npm packages with semantic versioning, lifecycle hooks, and global discovery, replacing manual file transfers and ad hoc scripts.

Core Features & Use Cases

  • Standardized packaging: Package skills with npm metadata, versioning, and scopes for organization.
  • Multi-tool compatibility: Works with Claude Code, Cursor, Windsurf, and other tools that support skill formats.
  • Lifecycle & discovery: Includes postinstall/uninstall hooks and a manifest-driven discovery mechanism.
  • Use Case: A team publishes a skill under an org scope and updates it across all developer machines with a single npm publish, ensuring consistency.

Quick Start

Fork or clone the template, customize SKILL.md and package.json, then publish your skill to npm.

Frequently Asked Questions about your-skill-name

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish Claude Code agent skills as npm packages with versioning?

Publish Claude Code agent skills as npm packages with versioning by customizing SKILL.md and package.json, then using npm publish to distribute them with semantic versioning and lifecycle hooks. This replaces manual file transfers and ad hoc scripts.

Can I use the same agent skills across Claude Code, Cursor, and Windsurf?

Yes, agent skills packaged with this method support multi-tool compatibility across Claude Code, Cursor, and Windsurf. Standardized SKILL.md frontmatter validation and progressive disclosure ensure consistent packaging and discovery in multi-tool environments.

What is the best way to distribute AI skills to an entire development team?

Distribute AI skills to an entire development team by publishing under an npm org scope. A single npm publish updates all developer machines globally, enforcing standardized skill packaging and consistent discovery across project and global scopes.

Does agent skill packaging support installation lifecycle hooks?

Yes, agent skill packaging supports installation lifecycle hooks including postinstall and uninstall scripts. These hooks enforce the installation lifecycle and SKILL.md frontmatter validation to ensure consistent packaging and manifest-driven discovery.