w-roadmap — Claude Code skill: roadmap checks and install
The w-roadmap Claude Code skill compares implementation with GitHub issues and related docs. Invoke it explicitly to see which items are shipped, partial, or missing.
MIT 647 installs ★ 1 updated 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a claude-codeWhat w-roadmap does
w-roadmap checks the implementation against GitHub issues and relevant MDX, README, and DESIGN.md files. It marks items as shipped, partial, or missing, and ties each finding to an issue, a document, or code. It does not create PRODUCT.md, ROADMAP.md, or another backlog.
When the current conversation has no reconciled exploration, the skill first follows steps 1–3 from w-council, examining issues, docs, and code. It then asks whether to edit documentation or run /w-plan for an item that has already been authorized. Automatic model invocation is disabled, so the skill requires an explicit call.
What it helps with
- compare implementation with open and recently closed GitHub issues
- spot roadmap items already reflected in code
- separate partial work from missing items
- tie each finding to an issue, document, or code
Example prompts for the agent
- Use
w-roadmapto compare the project code with GitHub issues and related docs. - Show which roadmap items are shipped, partly done, or missing.
- Check the plan against issues, MDX, and code, then ask whether to edit the docs or run
/w-planfor an authorized item.
How to install w-roadmap
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a claude-code2Manually: put the files in place
~/.claude/skills/w-roadmap/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-roadmap/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a codex2Manually: put the files in place
.agents/skills/w-roadmap/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a cursor2Manually: put the files in place
.cursor/skills/w-roadmap/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-roadmap2Manually: put the files in place
.github/skills/w-roadmap/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-roadmapManually: put the files in place
.devin/skills/w-roadmap/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about w-roadmap
How do I install w-roadmap in Claude Code?
Run npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a claude-code. The skill file is at ~/.claude/skills/w-roadmap/SKILL.md.
What does w-roadmap do?
It compares code with GitHub issues and related documentation, marking items as shipped, partial, or missing. Each finding points to an issue, a document, or code.
Which documents does w-roadmap inspect?
It reads relevant MDX and README files, plus DESIGN.md for named horizons.
Source text
SKILL.md · MIT
--- name: w-roadmap description: Diff the codebase against GitHub issues and matching docs; do not invent a backlog. disable-model-invocation: true --- Compare implementation to GitHub issues and matching MDX/README. Chat only. Do not create `PRODUCT.md`, `ROADMAP.md`, or a second backlog. 1. If this turn has no reconciled exploration, follow [council](../w-council/SKILL.md) steps 1–3 with angles on issues, matching docs, and code. 2. Read GitHub issues (open + recently closed) and matching MDX/README/`DESIGN.md` for named horizons. 3. Inspect the matching code. Note shipped, partial, and missing items. Every item cites an issue, MDX, or code. 4. Ask whether they want a docs edit or `/w-plan` for an already-authorized item.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills