Skip to content

feat(skills): publish via npx skills add #45

@KemingHe

Description

@KemingHe

Related

Problem

Skills in KemingHe/common-devx are currently installed by manual copy-paste from the agent-skills/ directory into each consuming project. This requires knowing the repo exists, browsing the directory, and manually syncing updates. There is no versioned install or update path.

Proposed Solution

Restructure agent-skills/ to the skills/ path that the vercel-labs/skills CLI discovers automatically, so users can install and update skills via:

npx skills add KemingHe/common-devx

Required changes:

  • Rename or symlink agent-skills/ to skills/ (CLI discovers skills/ by default)
  • Verify each SKILL.md has valid YAML frontmatter with name and description fields (all current skills already satisfy this requirement)
  • Add npx skills add KemingHe/common-devx install instructions to README

This enables per-skill installs, multi-agent targeting, and npx skills update for downstream consumers without changing the SKILL.md format or content.

Alternatives Considered

  • Keep manual copy-paste (current working state, no urgency to change)
  • Publish to npmjs as a standalone package (heavier overhead, overkill for SKILL.md files)

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions