Agentic Skill Mill

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

Install (No Clone)

bash <(curl -fsSL https://agenticskillmill.com/install.sh) --all

powershell -ExecutionPolicy Bypass -Command "& ([ScriptBlock]::Create((Invoke-RestMethod 'https://agenticskillmill.com/install.ps1'))) --all"

Or use npx directly:

npx --yes agentic-skill-mill@latest inventory --json

Local Development

git clone https://github.com/barretts/AgenticSkillMill.git
cd AgenticSkillMill
npm install && npm run build && npm run compile
node install.js --all

git clone https://github.com/barretts/AgenticSkillMill.git
cd AgenticSkillMill
npm install
npm run build
npm run compile
node install.js --all

Compilation 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`