router

router is a skill for Claude Code, Codex from MedAdemBHA/docflow. It costs 52 tokens per session (1,196 once invoked), scanned A, original, MIT.

A document-finding guide for software projects. It directs an AI agent to discover the repository's documentation and choose the relevant specification, decision record, roadmap, or guide before reading source code.

In plain words
What is it for?
Use it to find where a feature is documented, locate specifications or ADRs, check roadmaps and open bugs, or share the right project documentation.
Why use it?
It reduces time spent searching through unrelated files and helps answer questions from the project's intended documentation. An ADR, or architecture decision record, is a document explaining an important design choice.

Skill for Claude CodeCodex

Part of the docflow plugin — 9 skills, 3 commands shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/medadembha/docflow/router
Any agent
npx skills add MedAdemBHA/docflow --skill router
Clone the repo
git clone --depth 1 https://github.com/MedAdemBHA/docflow

Made for: Claude Code, Codex.

Or install docflow, the plugin that ships this one along with the rest of its 9 skills, 3 commands.

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 router

README.md
[![agentmods](https://agentmods.dev/badge/skills/medadembha/docflow/router.svg)](https://agentmods.dev/skills/medadembha/docflow/router)
Your own site
<a href="https://agentmods.dev/skills/medadembha/docflow/router"><img src="https://agentmods.dev/badge/skills/medadembha/docflow/router.svg" alt="Measured on agentmods" height="20"></a>
Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,196 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00052 $0.01196
Opus 5 $0.00026 $0.00598
Sonnet 5 $0.00010 $0.00239
Haiku 4.5 $0.00005 $0.00120

Measured 4d ago against content hash 59ab1d911390, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

router 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 4d ago.

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.

skills/router/SKILL.md · 81 lines

How it starts

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

router

Project-agnostic. No hardcoded tree — discover, then route. Works in any repo.


1 — Discover the docs (do this first, once per session)

Run a cheap scan to learn what this project has. Cache the result mentally for the session.

# docs roots + entry points
ls README* CONTRIBUTING* 2>/dev/null
fd -t d -d 2 -i 'docs?|spec|adr|decisions|wiki|reference' 2>/dev/null \
  || find . -maxdepth 3 -type d \( -iname 'docs' -o -iname 'spec*' -o -iname 'adr' -o -iname 'decisions' \) -not -path '*/node_modules/*'
# the markdown tree under the main docs dir (swap <DOCS> for what you found)
fd -e md . <DOCS> 2>/dev/null | head -80 || find <DOCS> -name '*.md' | head -80

If a hand-maintained index exists (<DOCS>/README.md, SUMMARY.md, mkdocs.yml, docusaurus.config.*), read that — it's the authoritative map. Don't rebuild what the maintainer already wrote.


2 — Route a question → one doc

Match the question's shape to a folder by its conventional name, then Read that one doc. Don't bulk-read the tree.

Question shape Look in (by conventional name)
"What does feature X do?" (user-facing) product-spec/, docs/features/, top-level README
"How is X implemented / data flow / API contract?" specs/, docs/architecture/, design/
"Why did we choose X?" decisions/, adr/, docs/adr/ (ADR files)
"How do I do X / convention for X?" references/, docs/guides/, CONTRIBUTING.md
"What's planned / status of X?" plans/, roadmap/, docs/roadmap/, project board
"Known issues / open bugs?" reviews/bugs/, ISSUES.md, GitHub issues
"What shipped recently?" CHANGELOG.md, changelog/, releases

If names don't match these, fall back to the discovered index from step 1.

Rules

  • Map question → doc → Read exactly that doc. Grep the tree only when no index resolves it.
  • Docs reflect state when written (check dates / filenames) — verify against code before acting on stale detail.
  • For how-to-code questions, prefer the project's own coding-rules / conventions doc over re-deriving from spec.
  • Before fixing a bug, check the bug catalog / issues for an existing entry + severity.

Read the full file on GitHub · 81 lines

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. 4d ago First seen · 81 lines · 52 tokens per session scan A 59ab1d911390

Subscribe to this mod's changes

router is a skill published in the GitHub repository MedAdemBHA/docflow (41 stars, last pushed 20d ago), licensed MIT. It adds 52 tokens to every session and 1,196 once invoked, about $0.0003 per session on Opus 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-08-30.

Related

Other skills, from other repositories

opendocu

Use when a coding task needs official framework, library, SDK, runtime, or tool documentation from a local versioned docs store; when local docs are missing and should be grown from official sources; or when answering version-sensitive API questions with cited local docs instead of model memory.

yu2001-s/OpenDocu · 59 tokens

watch

File sentinel that monitors the working directory for changes and marker comments, then auto-triggers appropriate skills. Poll-based via git diff against the last scan commit. Writes intake items for batch processing and routes marker actions through /do. Use for automatic reactions to file changes; do NOT use for…

SethGammon/Citadel · 70 tokens

pr-watch

Local PR watcher. Monitors CI status, automatically fixes failing checks by reading failure logs and applying targeted fixes, then optionally merges when all checks pass. Local CLI analog to Claude Code's cloud auto-fix feature.

SethGammon/Citadel · 46 tokens

review

5-pass structured code review — correctness, security, performance, readability, consistency.

SethGammon/Citadel · 17 tokens

live-preview

Mid-build visual verification loop. Takes screenshots of components during construction, not just after. Catches visual regressions and invisible features before they compound. Requires Playwright or similar screenshot tool.

SethGammon/Citadel · 40 tokens

systematic-debugging

4-phase root cause analysis: observe, hypothesize, verify, fix. Enforces investigation before any code changes. Emergency stop after 2 failed fixes. Prevents shotgun debugging and fix cascades.

SethGammon/Citadel · 45 tokens