skillpm-skill 0.0.4 → 0.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillpm-skill",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Agent Skill for managing skills with skillpm — install, publish, and wire Agent Skills into AI agent directories",
   "keywords": [
     "agent-skill",

package/skills/skillpm/SKILL.md

@@ -24,6 +24,7 @@ Use this skill when the user wants to:
 - **One skill per npm package.** The skill lives in `skills/<name>/SKILL.md` inside the package.
 - **Transitive dependency resolution.** skillpm walks the full dependency tree to discover all skills and MCP server requirements.
 - **Agent directory wiring.** skillpm uses the `skills` CLI to link installed skills into 37+ agent directories (Claude, Cursor, VS Code, Codex, Gemini CLI, etc.).
+- **Config files.** Skills can include a `configs/` directory to ship native agent config files (subagent definitions, rules, prompts). The directory mirrors the workspace layout — files are copied on install with an auto-prefix (de-scoped package name, or a shorter `skillpm.configPrefix` override) to prevent conflicts.
 - **MCP server configuration.** Skills can declare MCP servers in `package.json` under `skillpm.mcpServers[]`. skillpm configures them via `add-mcp`.
 
 ## Commands
@@ -37,7 +38,7 @@ npx skillpm install <skill-name>
 # Aliases: skillpm i
 ```
 
-This runs `npm install`, scans `node_modules/` for skill packages, links them into agent directories, and configures any required MCP servers.
+This runs `npm install`, scans `node_modules/` for skill packages, links them into agent directories, copies config files, and configures any required MCP servers.
 
 ### Install all dependencies
 
@@ -103,12 +104,22 @@ my-skill/
 ├── package.json                 # keywords: ["agent-skill"], dependencies, skillpm.mcpServers
 ├── README.md
 ├── LICENSE
-└── skills/
-    └── my-skill/
-        ├── SKILL.md             # Skill definition (YAML frontmatter + Markdown body)
-        ├── scripts/             # Optional executable scripts
-        ├── references/          # Optional reference docs
-        └── assets/              # Optional templates/data
+├── skills/
+│   └── my-skill/
+│       ├── SKILL.md             # Skill definition (YAML frontmatter + Markdown body)
+│       ├── scripts/             # Optional executable scripts
+│       ├── references/          # Optional reference docs
+│       └── assets/              # Optional templates/data
+└── configs/                      # Optional — mirrors workspace layout
+    ├── .claude/
+    │   ├── agents/reviewer.md   # Claude subagent
+    │   └── rules/conventions.md # Claude rules
+    ├── .cursor/
+    │   ├── agents/reviewer.md   # Cursor agent
+    │   └── rules/conventions.md # Cursor rules
+    └── .github/
+        ├── agents/reviewer.md   # Copilot agent
+        └── instructions/conventions.instructions.md
 ```
 
 ### package.json for a skill
@@ -136,6 +147,40 @@ my-skill/
 - The `"agent-skill"` keyword is required for publishing.
 - Use `git+https://` prefix for `repository.url` (npm requires this format).
 
+### Bundling agent configs, rules, and prompts
+
+`SKILL.md` teaches agents *what to do* — instructions read at runtime. The `configs/` directory lets you also ship **config files** (subagent definitions, rules, instructions) in the native format of each agent system. It mirrors the workspace layout — files get copied to the workspace root on install, auto-prefixed to avoid conflicts.
+
+The prefix used is: `configPrefix` (if set in `skillpm` field) → de-scoped package name (e.g. `@acme/fullstack-react` → `fullstack-react`). Set `configPrefix` to a short name when the package name is long.
+
+Each agent system uses different names and directories:
+
+| Agent system | Agents | Agent directory | Rules/Prompts | Rules directory |
+|---|---|---|---|---|
+| Claude Code | Subagents | `.claude/agents/*.md` | Rules | `.claude/rules/*.md` |
+| Cursor | Custom agents | `.cursor/agents/*.md` | Rules | `.cursor/rules/*.md` |
+| GitHub Copilot | Custom agents | `.github/agents/*.md` | Instructions | `.github/instructions/*.md` |
+| Codex | — | `AGENTS.md` | — | `AGENTS.md` |
+| Gemini CLI | — | `GEMINI.md` | — | `GEMINI.md` |
+
+To ship config files, create a `configs/` directory that mirrors the workspace layout for each target system:
+
+| Source in package | Destination in workspace |
+|---|---|
+| `configs/.claude/agents/reviewer.md` | `.claude/agents/my-skill-reviewer.md` |
+| `configs/.cursor/rules/conventions.md` | `.cursor/rules/my-skill-conventions.md` |
+| `configs/.github/instructions/help.instructions.md` | `.github/instructions/my-skill-help.instructions.md` |
+
+On uninstall, all copied files are removed automatically (tracked via `.skillpm/manifest.json`).
+
+Not every skill needs `configs/` — only use it when you want to ship native agent config files. Since `configs/` contains dotfile directories, add them to `package.json` `files`:
+
+```json
+{
+  "files": ["skills/", "configs/"]
+}
+```
+
 ### SKILL.md frontmatter
 
 ```yaml