Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a claude-code
Open on GitHub

What 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-roadmap to 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-plan for an authorized item.

How to install w-roadmap

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-roadmap -a claude-code

2Manually: put the files in place

~/.claude/skills/w-roadmap/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-roadmap/

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

Similar skills

All skills for Git and GitHub →
oh-my-issues thedotmack oh-my-issues — a skill for Claude Code and Codex clusters GitHub issue backlogs by root cause into plan-master issues. Runs during backlog triage and consolidation. CX Codex +1 4,500installs plan-documentation-roadmap gtmagents plan-documentation-roadmap turns signals from analytics, tickets and stakeholder asks into a quarterly documentation roadmap with priorities, staffing and KPIs. CX Codex +1 ★ 450repo stars gh-issue-sync mitsuhiko gh-issue-sync — a skill for Claude Code, Codex, Cursor and other platforms that maps GitHub Issues to local Markdown files. The agent pulls, edits and pushes issues from inside the repo without touching the browser. CX Codex +1 28,500installs create-github-issues-for-unmet-specification-requirements official github create-github-issues-for-unmet-specification-requirements is a GitHub Copilot skill that checks a codebase against a specification and creates GitHub Issues for unmet requirements. CX Codex +1 8,900installs roadmap-communicator Alireza Rezvani roadmap-communicator — a Claude Code skill for drafting roadmap narratives, release notes, and stakeholder updates. Each output is shaped to its audience — board, engineering team, or customers get different structures and emphasis. CX Codex +1 586installs load-issues NeoLabHQ load-issues — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that pulls all open issues from a GitHub repository and writes each one as a separate markdown file. CX Codex +1 1,200installs

From the same set45

The whole set →
w-onboard The w-onboard Claude Code skill takes a developer from cloning a repository to a running local app. It follows project setup instructions and checks that the app can reach its API. CX Codex +1 647installs w-api-docs The w-api-docs Claude Code skill refreshes API documentation from its source schema or routes. It steps in when an API change needs to be reflected in generated docs. CX Codex +1 647installs w-docs w-docs — a skill for Claude Code updates project docs after code or feature changes. It selects the docs layer that owns the change. CX Codex +1 647installs w-architecture The w-architecture Claude Code skill plans an implementation structure against a project's architecture docs and ADRs. It runs on requests to plan a change. CX Codex +1 647installs w-clarify The w-clarify Claude Code skill finds missing decisions that could block correct work. It checks the request against the project’s code and documentation first. CX Codex +1 647installs w-deslop The w-deslop Claude Code skill removes AI-generated noise from branch changes compared with main. It checks comments, defensive code, and any casts. CX Codex +1 647installs w-coderabbit The w-coderabbit Claude Code skill fetches CodeRabbit feedback on a PR or uncommitted diff. It applies clear fixes, then runs local checks. CX Codex +1 647installs w-release w-release is a Claude Code skill that reviews release impact, changelog changes, and template contracts. Invoke it manually; automatic invocation is disabled. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open