skillmill

One command: turn docs into an installable Agent Skill for Claude, Cursor, and Grok.

npm i -g skillmill
# or just:
npx skillmill https://docs.stripe.com --out ./skills/stripe

Works offline. No API key. Structure — not a dump.

---

See it work

~16s demo: npx skillmill ./fixtures/mini-docs → SKILL.md / INSTALL.md / references/ → install into Claude / Cursor / Grok.

Try the fixture in 30 seconds:

npx skillmill ./fixtures/mini-docs --out ./skills/mini-docs
ls ./skills/mini-docs
# SKILL.md  INSTALL.md  references/

---

Input / Output / Runtimes

Input	Output	Runtimes
Docs URL (https://…)	SKILL.md — description, when-to-use, procedures	--target claude
Local markdown / HTML / tutorials (./docs)	references/ — sourced excerpts on demand	--target cursor
	INSTALL.md — copy paths for each agent	--target grok
		--target all (default)

---

Before / After — Next.js docs

Before: paste a giant docs dump into chat, hope the agent finds the right page, re-explain App Router every session.

After:

npx skillmill https://nextjs.org/docs --out ./skills/nextjs --name nextjs --max-pages 25

skills/nextjs/
├── SKILL.md          # when to use + procedures (lean)
├── INSTALL.md
└── references/       # page excerpts the agent opens on demand

Copy into ~/.claude/skills/nextjs/, .cursor/skills/nextjs/, or your Grok skills path — see INSTALL.md.

---

Why skillmill (vs the field)

Strong tools already exist. skillmill’s wedge is one command, multi-runtime, and structure not dump.

	skillmill	Skill_Seekers	book-to-skill	site2skill
Stars (approx.)	new	~14.7k	~20.6k	small
One-liner CLI	✅ npx skillmill <url|path>	docs→Claude focused	books/PDF→skill	site→skill
Multi-runtime (claude / cursor / grok / all)	✅	Claude-oriented	skill export	limited
Local markdown / tutorial folders	✅ first-class	varies	books/PDF strength	sites
Lean SKILL.md + on-demand references/	✅	often heavier dumps	book-structured	varies
Offline, no API key	✅	check project	check project	check project

Star this repo if you want a sharp, multi-runtime docs→skill CLI — ★ levi-qiao/skillmill.

---

Usage

skillmill <url|./docs> [options]

  -o, --out <dir>        Output directory (default: ./skills)
  -n, --name <name>      Skill folder name
      --max-pages <n>    Max pages/files (default: 30)
      --target <t>       claude | cursor | grok | all  (default: all)
      --runtime <t>      Alias of --target

# Docs site → skill folder
npx skillmill https://docs.stripe.com --out ./skills/stripe

# Local tutorials
npx skillmill ./docs --name my-api --target cursor

# Claude-only install notes
npx skillmill ./docs --target claude --out ./skills

Optional: set OPENAI_API_KEY or XAI_API_KEY to polish wording. Heuristics always work without keys.

---

Fixtures

Fixture	Lang	Command
fixtures/mini-docs	EN	npx skillmill ./fixtures/mini-docs --out ./skills/mini-docs
fixtures/mini-docs-zh	中文	npx skillmill ./fixtures/mini-docs-zh --out ./skills/mini-docs-zh --name mini-docs-zh

Sample output: examples/mini-docs.

---

Contributing & license

npm install && npm test && npm run build

PRs welcome — keep the MVP sharp. MIT © levi-qiao

---

中文

skillmill —— 一条命令，把文档变成可安装的 Agent Skill（Claude / Cursor / Grok）。

npx skillmill https://docs.stripe.com --out ./skills/stripe
npx skillmill ./fixtures/mini-docs-zh --out ./skills/mini-docs-zh

默认离线、无需 API Key；输出精简的 SKILL.md + 按需阅读的 references/，而不是整站倾倒。欢迎 Star：levi-qiao/skillmill。