Summary
Implement a dev-assets-import command that lets users import skill, agent, and hook definitions from external sources (GitHub repos, npm packages, URLs) into their local catalog.
Motivation
The current workflow for adding community-maintained entries requires manually copying files and adapting them to the catalog schema. A first-class import command would lower the barrier significantly.
Proposed UX
# Import a specific skill from a GitHub repo
forge-kit import github:org/repo/skills/my-skill
# Import all entries from an npm package
forge-kit import npm:@myorg/forgekit-skills
# Import from a URL (raw GitHub, gist, etc.)
forge-kit import https://example.com/catalog/skill.json
Behavior
- Fetch the remote definition
- Validate it against the catalog schema (
pnpm catalog:validate logic)
- Detect ID conflicts with existing local entries and prompt for resolution
- Write to the appropriate
packages/catalog/catalog/<kind>/ directory
- Optionally add to a collection of the user's choosing
References
- Proposed in
docs/roadmap.md as dev-assets-import
- Related: plugin system design (#TBD)
- Catalog schema lives in
packages/catalog/
Summary
Implement a
dev-assets-importcommand that lets users import skill, agent, and hook definitions from external sources (GitHub repos, npm packages, URLs) into their local catalog.Motivation
The current workflow for adding community-maintained entries requires manually copying files and adapting them to the catalog schema. A first-class import command would lower the barrier significantly.
Proposed UX
Behavior
pnpm catalog:validatelogic)packages/catalog/catalog/<kind>/directoryReferences
docs/roadmap.mdasdev-assets-importpackages/catalog/