jasonwarrenuk/Artefacts: Create Roadmap
skills/artefact-roadmap/SKILL.md
{{ 𝚫𝚫𝚫 }} Generate the HTML roadmap dashboard deterministically via roadmap.py render.
$ install --global
skillsauthnpx skillsauth add jasonwarrenuk/goblin-mode Artefacts: Create RoadmapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 18, 2026, 7:15 AM114.2s1 file scanned
SKILL.md
- name:
- Artefacts: Create Roadmap
- description:
- {{ 𝚫𝚫𝚫 }} Generate the HTML roadmap dashboard deterministically via roadmap.py render.
- when_to_use:
- When you want to view or share the current roadmap as an interactive dashboard rather than reading roadmaps.json directly.
- model:
- haiku
- disable-model-invocation:
- true
- allowed-tools:
- ["Read", "Glob", "Bash(python3:*)", "Bash(open:*)"]
- argument-hint:
- [phase name (optional, when several are active)]
Render the interactive roadmap dashboard. The HTML is generated deterministically by roadmap.py render from the template at ~/.claude/library/templates/roadmap-artefact.html — this skill runs the command and opens the result; it writes no HTML itself. Same data in, same file out, so regenerated artefacts diff cleanly and can never drift from roadmaps.json.
Shared conventions (statuses, colour table): ~/.claude/library/references/roadmap-conventions.md.
Steps
- Check the format. Run
python3 "$HOME"/.claude/library/scripts/roadmap.py detect. Exit 3 = old simple format — stop and tell the user to runroadmap-migratefirst. Exit 2 = could not locate/parse — ask for the path. Proceed on exit 0. - Render. Run
python3 "$HOME"/.claude/library/scripts/roadmap.py render, adding--phase "$ARGUMENTS"when the user named a phase (required if several are active). Default output:{project_root}/docs/artefacts/roadmap-{slug}.html. On a validation-discrepancy note in the output, still render (the page shows a discrepancy banner) but include the discrepancies in your report. - Open and report.
openthe written file. Report: the file path; milestone and task counts plus done percentage (roadmap.py stats); the unblockedtodotasks (roadmap.py ready— surfaced directly, no need to open the file); any validation discrepancies.
Notes
- The dashboard refreshes automatically when
roadmap-maintainruns (recompute --render); invoke this skill for the first render or an on-demand refresh. - Sections, palette and behaviour live in the template. To change the dashboard's look, edit
library/templates/roadmap-artefact.html; to change status colours, change the canonical table (STATUS_STYLEinroadmap.py+ the conventions reference) — never patch a generated file. - The artefact is generated in the CLI's own canonical form (tabs, single-line JSON payload), not Prettier's. A repo that runs Prettier (or another formatter) in a pre-commit hook or CI should exclude it — add
docs/artefacts/roadmap-*.htmlto.prettierignore, the same way.claude/roadmaps.jsonis already excluded — so regenerating the dashboard never fights the formatter.
Related Skills
jasonwarrenuk/Roadmap: Build Zip
tools
VerifiedTrustedCommunity
{{ 𝚫𝚫𝚫 }} Rebuild roadmap-system.zip, the distributable snapshot of the roadmap tooling (scripts, HTML template, conventions reference, and every roadmap-touching skill, including this one).
5SKILL.mdUpdated Jul 21, 2026
jasonwarrenuk/skills/task-suggest
tools
VerifiedTrustedCommunity
--- name: "Suggest: Task" description: "{{ 𝚫𝚫𝚫 }} Suggest the next logical task — grounded in the roadmap's pre-vetted ready-set when one exists, codebase analysis otherwise" when_to_use: "When you don't know what to work on next and want a grounded recommendation rather than picking arbitrarily." model: haiku effort: low disable-model-invocation: true allowed-tools: ["Read", "Glob", "Grep", "Bash(python3:*)", "Bash(npm:*)", "Bash(bun:*)", "Bash(pnpm:*)", "Bash(deno:*)"] argument-hint: [named
5SKILL.mdUpdated Jul 17, 2026
jasonwarrenuk/Roadmap: Migrate
development
VerifiedTrustedCommunity
{{ 𝛀𝛀𝛀 }} Convert an old simple-style roadmap (single Markdown, four statuses, <a name> anchors, roadmaps.json pointer registry) into the rich phase-array format (roadmaps.json source of truth + PHASE task list + prose overview).
5SKILL.mdUpdated Jul 17, 2026
jasonwarrenuk/PR: Create
data-ai
VerifiedTrustedCommunity
{{ ƔƔƔ }} Create a pull request to main — wordy or shiny (with screenshots), ready-for-review or draft
5SKILL.mdUpdated Jul 17, 2026