Fragment-composed skills compiled to 7 IDE targets, paired with a TypeScript companion CLI (skillmill) that provides structured commands for agents and humans.
Architecture
Skills (what to do) CLI Companion (tools to do it with)
skill/skills/*.md src/cli/commands/*.ts
skill/fragments/*.md src/core/*.ts
| |
v v
compiled/ (7 IDE formats) dist/ (npm link -> global CLI)
| |
+---------> Agent <----------+What It Does
Skills
Step-by-step runbooks in markdown with YAML frontmatter. They tell the agent what to do and reference the CLI by name.
Fragments
Shared knowledge blocks included by multiple skills. Edit once, recompile, and every consumer gets the update.
Compiler
Resolves includes, applies IDE-specific frontmatter transforms, and writes to 7 targets: Claude, Cursor, Windsurf, OpenCode, and Codex.
CLI
Inspect manifests, validate skills, audit exports, and forge new components. Every command supports --json for agent consumption.
CLI Commands
| Command | Description |
|---|---|
skillmill inspect-manifest | Inspect a manifest.json for correctness |
skillmill inspect-skill | Inspect a skill source .md file |
skillmill inventory | Take stock of all skills, fragments, and targets |
skillmill forge | Forge scaffolding (command, skill, fragment) |
skillmill audit-exports | Audit that src/index.ts exports match core modules |
Quick Start
npm install
npm run build
npm run compile
bash install.sh # auto-detect installed tools
bash install.sh --all # or install for all toolsCompilation Targets
| Target | Output |
|---|---|
| Claude | compiled/claude/<skill>/SKILL.md |
| Cursor (rules) | compiled/cursor/rules/<skill>.mdc |
| Cursor (skills) | compiled/cursor/skills/<skill>/SKILL.md |
| Windsurf (rules) | compiled/windsurf/rules/<skill>.md |
| Windsurf (skills) | compiled/windsurf/skills/<skill>/SKILL.md |
| OpenCode | compiled/opencode/<skill>.md |
| Codex | compiled/codex/<skill>/SKILL.md |