| name | kb-mint |
| description | Mints skills from KB topics, packages skills into plugins, and prepares them for Cowork. Use when asked to create a skill from KB content, convert to a plugin, package for distribution, or make something cowork-ready. Also triggers on `convert this to a skill`, `package as plugin`, `mint a skill`, or `make this a plugin`. |
| argument-hint | [--skill <topic-path> | --plugin <skills...> | --cowork <skills...>] |
| effort | max |
| hooks | {"PostToolUse":[{"matcher":"Write|Edit|Bash","hooks":[{"type":"command","command":"uv run ${CLAUDE_SKILL_DIR}/../kb-learn/scripts/validate_kb.py --hook"}]}]} |
/kb-mint — KB-to-Skill-to-Plugin Pipeline
1. Routing
Parse $0 to determine mode:
--skill <topic-path> → Section 2--plugin <skills...> → Section 3--cowork <skills...> → Section 4- Otherwise → show:
/kb-mint --skill|--plugin|--cowork <args>
2. Skill Conversion (--skill)
Convert a KB concept topic into a KB-backed skill.
- Load: Use
/kb-find to discover all notes in the target topic
- Assess: Classify per reference/skill-conversion-guide.md (what/where/when →
index.md, how → skill/, data → reference/, templates → assets/, automation → scripts/)
- Author: If
/skill-creator is available in the environment, delegate skill creation to it. Otherwise, follow reference/skill-authoring-guide.md for description writing, workflow patterns, token efficiency
- Present plan → ask for approval
- Execute: Scaffold from assets/skill-scaffold/SKILL.md.template, slim
index.md, create symlink (ln -s ../../knowledge/<topic>/skill .claude/skills/<name>), validate (uv run ${CLAUDE_SKILL_DIR}/../kb-learn/scripts/validate_kb.py --quiet --json)
- Records: Prepend
knowledge/CHANGELOG.md ([maintenance]). If from monitoring, return control.
3. Plugin Packaging (--plugin)
- Resolve skills via
.claude/skills/ symlinks or direct paths
- Name plugin: Derive from common prefix per reference/plugin-packaging-guide.md. Single skill → name = skill name. Multiple →
plugin:action namespace. Confirm with user.
- Present plan: name, namespace, layout, hooks/MCP/agents extraction
- Execute: Create plugin dir, generate
plugin.json from assets/plugin-scaffold/plugin.json.template, copy skills, extract hooks to hooks/hooks.json (merge skill frontmatter hooks: — deduplicate by matcher + command), extract MCP to .mcp.json, create agents
- Finalize: Validate, present for review
4. Cowork Packaging (--cowork)
Run Section 3 first, then add Cowork-specific considerations per reference/plugin-packaging-guide.md § Cowork: connectors (MCP as GUI connectors), GUI installation (no CLI-only steps), non-dev users (user-invocable: false), marketplace labels. Present additions for approval.
5. Validation
After completing KB or skill changes, run the validator to catch broken links, frontmatter issues, and structural errors:
uv run ${CLAUDE_SKILL_DIR}/../kb-learn/scripts/validate_kb.py --quiet --json
Fix any reported errors before finishing.
6. Scripts and Testing
