A tool for organizing software documentation with Johnny.Decimal, a numbered folder system for grouping information into areas. It can create, validate, index, classify, and move documentation, including documentation for monorepos, which are repositories containing multiple related projects.

Use it to create or validate a docs tree, add areas, regenerate an index, classify loose files, move documents, or create project-specific subtrees.

It replaces an ad hoc documentation layout with a consistent structure and helps keep indexes and file locations aligned with that structure.

jd-docs — Skill for Claude Code and Codex by joaquimscosta

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.

Any agent

npx skills add joaquimscosta/arkhe-claude-plugins --skill jd-docs

Clone the repo

git clone --depth 1 https://github.com/joaquimscosta/arkhe-claude-plugins

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/joaquimscosta/arkhe-claude-plugins/jd-docs/github.svg)](https://agentmods.dev/skills/joaquimscosta/arkhe-claude-plugins/jd-docs)

Your own site

<a href="https://agentmods.dev/skills/joaquimscosta/arkhe-claude-plugins/jd-docs"><img src="https://agentmods.dev/badge/skills/joaquimscosta/arkhe-claude-plugins/jd-docs/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/joaquimscosta/arkhe-claude-plugins/jd-docs"><img src="https://agentmods.dev/badge/skills/joaquimscosta/arkhe-claude-plugins/jd-docs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 97 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,234 The whole file, excluding the scripts and references it only reads on demand.

Security scan C 2 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.

Model	Per session	Once invoked
Fable 5.1	$0.00097	$0.01234
Opus 5.5	$0.00039	$0.00494
Sonnet 5.5	$0.00019	$0.00247
Haiku 4.5	$0.00010	$0.00123

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

Security

Grade C, and why

jd-docs scanned grade C with 2 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.

The scan reads SKILL.md. This mod also ships 7 executable files (scripts/jd_add_area.py, scripts/jd_add.py, scripts/jd_classify.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

| `uv` not found | `curl -LsSf https://astral.sh/uv/install.sh \| sh` or run with `python3 scripts/jd_init.py` |

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| `uv` not found | `curl -LsSf https://astral.sh/uv/install.sh \| sh` or run with `python3 scripts/jd_init.py` |

plugins/doc/skills/jd-docs/SKILL.md · 108 lines

How it starts

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

Johnny.Decimal Documentation

Scaffold, validate, and maintain Johnny.Decimal documentation structure with sensible defaults and per-project customization.

Quick Start

# Scaffold a new structure
uv run scripts/jd_init.py --dry-run   # Preview first
uv run scripts/jd_init.py             # Create docs/ with defaults
uv run scripts/jd_init.py --diataxis  # Include Diataxis areas (41-44)

# Validate existing structure
uv run scripts/jd_validate.py --dir docs

# Regenerate README index
uv run scripts/jd_index.py --dir docs

# Day-2: Add a new area
uv run scripts/jd_add_area.py --prefix 40 --name operations --dry-run

# Day-2: Classify unorganized files
uv run scripts/jd_classify.py docs/*.md
uv run scripts/jd_classify.py docs/*.md --diataxis  # With quadrant info

# Day-2: Move a file to an area
uv run scripts/jd_add.py docs/roadmap.md 00 --dry-run

See WORKFLOW.md for the full methodology.

Capabilities

Scaffolding (jd_init.py) — Create J.D directory tree with README templates; supports --product for monorepo sub-trees, --init-config to generate .jd-config.json, and --diataxis to include Diataxis quadrant areas (41-44)
Validation (jd_validate.py) — Check NN-kebab-case naming, detect orphan files, verify README presence per area; --strict for CI enforcement
Index generation (jd_index.py) — Generate/update root README with table or tree index; preserves custom content via  markers
Migration (Claude-driven) — Classify flat docs into J.D areas using naming heuristics, present a move plan, execute interactively

Day-2 Operations

Add area (jd_add_area.py) — Create a new J.D area with prefix, name, README stub, config update, and auto re-index
Classify (jd_classify.py) — Classify files into areas using keyword heuristics with confidence scoring (high/medium/low); --diataxis adds Diataxis quadrant column, --diataxis-move routes files to quadrant areas (41-44)
Add/move file (jd_add.py) — Move a file to an area with auto-normalized kebab-case naming and cross-reference detection

Read the full file on GitHub · 108 lines

Files

What ships with it

10 files 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.

yesterday First seen · 108 lines · 97 tokens per session scan C ab0de2d1ba09

Subscribe to this mod's changes

jd-docs is a skill published in the GitHub repository joaquimscosta/arkhe-claude-plugins (21 stars, last pushed yesterday), licensed MIT. It adds 97 tokens to every session and 1,234 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-16.

Project management Writing and docs ai-agents ai-developer-tools anthropic claude-code-agents claude-code-plugins

issue-triage

Use when the user wants to triage GitHub issues - decide whether an issue is still relevant, reproducible, closeable, a duplicate, or what concretely needs doing. Selects and prioritizes first (never dumps all issues at once), then deep-triages the chosen issues via parallel subagents, recommends actions for the owner…

Marcel-Bich/marcel-bich-claude-marketplace · 97 tokens

requirements-verbatim

Capture a user requirement, decision, approval, or constraint word-for-word into an append-only dated log so it survives context compaction and can never be trimmed, softened, or reinterpreted. Use whenever the user states or approves a requirement, gives a GO, sets a constraint, or makes any decision that later work…

Marcel-Bich/marcel-bich-claude-marketplace · 101 tokens

pm

Universal, project-agnostic PRODUCT MANAGER playbook — the scope-disciplined PM that plans a project, gates its launch, and says no. Five modes, one workflow each: prd (turn a spec or a user request into a build-ready PRD — objectives, in-scope, out-of-scope guards, an acceptance-criteria table mapping every success…

endorphin-ai/hasbrains-agent-kit · 310 tokens

docs-project-management

Universal, project-agnostic playbook for managing an ENTIRE project inside the repo's docs/ folder — the docs/-native system of record, reusable in any project, new or existing, with no external issue tracker. Defines WHAT it manages: the work-item TAXONOMY (Roadmap → docs/ROADMAP.md + docs/roadmap.json, PRD →…

endorphin-ai/hasbrains-agent-kit · 319 tokens

execute

Execute phase — wave-based crew dispatch with critic gates and evidence-based verification.

fakoli/fakoli-plugins · 16 tokens

recipe-block-focus-time

Create recurring focus time blocks on Google Calendar to protect deep work hours.

fakoli/fakoli-plugins · 19 tokens

jd-docs