markdown-vault-mcp: Skill for Claude Code

.agents/skills/roadmapping/SKILL.md

roadmapping is a skill for Claude Code, Codex from pvliesdonk/markdown-vault-mcp. It costs 59 tokens per session (4,388 once invoked), scanned A, original, MIT.

A roadmap-planning procedure for work that spans several pull requests or a large project milestone. A roadmap describes direction, order, and unknowns without pretending to specify implementation details too early.

In plain words
What is it for?
Use it to chart or revise a roadmap, organise epics and release milestones, and decide the order of larger bodies of work.
Why use it?
It prevents long-range plans from being filled with unsupported file-level details and makes uncertainty explicit before implementation planning begins.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents); mentions AGENTS.md.

This is pvliesdonk/markdown-vault-mcp's own configuration. It tells Claude Code and Codex how to work on markdown-vault-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything markdown-vault-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to pvliesdonk/markdown-vault-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/pvliesdonk/markdown-vault-mcp/main/.agents/skills/roadmapping/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/pvliesdonk/markdown-vault-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for roadmapping

README.md
[![agentmods](https://agentmods.dev/badge/skills/pvliesdonk/markdown-vault-mcp/roadmapping/github.svg)](https://agentmods.dev/skills/pvliesdonk/markdown-vault-mcp/roadmapping)
Your own site
<a href="https://agentmods.dev/skills/pvliesdonk/markdown-vault-mcp/roadmapping"><img src="https://agentmods.dev/badge/skills/pvliesdonk/markdown-vault-mcp/roadmapping/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for roadmapping

Your own site · 80×15
<a href="https://agentmods.dev/skills/pvliesdonk/markdown-vault-mcp/roadmapping"><img src="https://agentmods.dev/badge/skills/pvliesdonk/markdown-vault-mcp/roadmapping.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 59 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,388 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00059 $0.04388
Opus 5.5 $0.00024 $0.01755
Sonnet 5.5 $0.00012 $0.00878
Haiku 4.5 $0.00006 $0.00439

Measured yesterday against content hash 4e2bc3a8e916, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

roadmapping scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

2 near-identical copies found in the catalogue:

.agents/skills/roadmapping/SKILL.md · 393 lines

How it starts

The opening of the file, as written. The whole thing — 393 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Roadmapping

A roadmap answers three questions: which direction, in what order, and what we do not yet know. It does not answer how. The moment it starts answering how, it has stopped being a roadmap and has become a plan that will be wrong.

Planning skills have one resolution setting. Point them at six months of work and they produce file paths and schemas for things nobody has looked at yet; reviewers then correctly attack that precision and the whole artefact loses credibility. The fix is to plan at a declared resolution and defend it.

The evidence rule

If you do not have hard evidence, you cannot be certain. It is not your job to obtain that evidence during charting.

An explicit request to research or implement authorizes that work. This rule prevents silently turning a roadmap pass into an investigation; it does not override the user's scope or previously authorized work.

Both halves matter. When you reach a gap, the tempting move is to read the code or open five files until you can say something concrete. Do not. That is how a roadmap fills with confident detail about work nobody has scoped.

Assert it, or file it as a known unknown. Never research to promote it.

Every unknown gets a resolved by pointer: which piece of work, when finished, answers it. When nothing planned will answer it and not knowing changes what you do next, the finding out is itself work: file a research issue (see Everything is work). The evidence rule defers research; it does not cancel it.

The model

Three GitHub objects and one document, each holding one kind of fact. This is the fleet-wide definition; the words mean nothing else here.

Object Is Holds
Epic a parent issue with native sub-issues, labelled epic the story, its frozen outcome ("Done when"), its children, its refinement issue
Package a milestone titled NNN <content-name> the payload of exactly one release cut
Issue a feature, bug, research spike or refinement task, labelled by kind executable work, at whatever resolution it has earned
Index docs/design/roadmap.md the argument: why this direction, why this order, what we do not know

Read the full file on GitHub · 393 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday Changed · +3 lines 4e2bc3a8e916
  2. 18d ago Changed 9dedcb22ef2d
  3. 25d ago Changed · +4 lines ddbd494edd00
  4. 1mo ago First seen · 386 lines · 59 tokens per session scan A 5648dba5dc2f

Subscribe to this mod's changes

roadmapping is a skill published in the GitHub repository pvliesdonk/markdown-vault-mcp (35 stars, last pushed today), licensed MIT. It adds 59 tokens to every session and 4,388 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-14.

Related

Other skills, from other repositories

Folio Tables

Work with Folio data tables (kind table) through foliotable MCP tools — schema-first, column types, filters, and typical schemas for a risk register, sprint plan, or backlog.

evergreen-it-dev/folio · 44 tokens

folio-wiki

Search, read and update the team's Folio wiki (pages, data tables, whiteboards, forms, bases, interactive artifacts) through the Folio MCP tools. Use when the task mentions the wiki, Folio, team conventions, runbooks, decisions, release notes or a Folio link, when you should write something down for the team, or when…

evergreen-it-dev/folio · 87 tokens

release-notes

Compare the repository with the team's Folio wiki and write release notes: read git log since the last tag, read the Roadmap table, create or update a Release notes page and add what the roadmap table is missing. Use when asked for release notes or to sync the wiki with the code.

evergreen-it-dev/folio · 63 tokens

tasks

View and manage the task stack and processing queue. Shows pending work, active tasks, completed items, and queue state. Triggers on "/tasks", "show tasks", "what's pending", "task list", "queue status".

agenticnotetaking/arscontexta · 49 tokens

docs-rag

Use when a project's markdown docs, specs, ADRs or decision logs need to be searchable by meaning from the agent, when a searchnotes tool (docs-rag-mcp) is connected, when its results carry labels like [semantic 0.71], [both], [exact match] or [superseded → ...], when it answers "No relevant results", or when a…

andreaselmi/docs-rag-mcp · 95 tokens

grooming

Shape ambiguous work into an agreed, executable plan. Use when the user asks to groom, scope, decompose, or prepare work before implementation.

docouno/notarium · 33 tokens