specd: Skill for Claude Code

.claude/skills/docgen/SKILL.md

docgen is a skill for Claude Code from jnerytech/specd. It costs 102 tokens per session (2,638 once invoked), scanned A, original, MIT.

A documentation generator that reads a codebase and writes Markdown documents such as a README, wiki, technical overview, C4 architecture models, and UML diagrams.

In plain words
What is it for?
Creating repository documentation, business explanations, architecture overviews, C4 models, UML diagrams, and related files in a chosen language.
Why use it?
It turns the code that actually exists into project documentation instead of relying on guesses or outdated descriptions.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

This is jnerytech/specd's own configuration. It tells Claude Code how to work on specd 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 specd configures →

Reuse

Borrowing it

Nothing to install: this file belongs to jnerytech/specd. 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/jnerytech/specd/main/.claude/skills/docgen/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/jnerytech/specd

Made for: Claude Code.

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 docgen

README.md
[![agentmods](https://agentmods.dev/badge/skills/jnerytech/specd/docgen/github.svg)](https://agentmods.dev/skills/jnerytech/specd/docgen)
Your own site
<a href="https://agentmods.dev/skills/jnerytech/specd/docgen"><img src="https://agentmods.dev/badge/skills/jnerytech/specd/docgen/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 docgen

Your own site · 80×15
<a href="https://agentmods.dev/skills/jnerytech/specd/docgen"><img src="https://agentmods.dev/badge/skills/jnerytech/specd/docgen.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,638 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.00102 $0.02638
Opus 5.5 $0.00041 $0.01055
Sonnet 5.5 $0.00020 $0.00528
Haiku 4.5 $0.00010 $0.00264

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

Security

Grade A, and why

docgen 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 12d 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.

.claude/skills/docgen/SKILL.md · 293 lines

How it starts

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

DocGen — code documentation generator

Generate one or more documentation artifacts for the repository in the current working directory, from real code analysis only.

Arguments

$ARGUMENTS is a space-separated list, all parts optional and order-free:

  • repo path — a token that names an existing directory (contains /, or is ., or resolves to a directory). Defaults to the current working directory. This is the repository root: everything is read from it and output goes inside it.
  • language — --lang <code> / --lang=<code> (e.g. pt-BR, es, en). Defaults to English.
  • doc types — everything else. Empty → produce all 8, in the order listed below. Matched loosely: c4, c4-models and c4_models all select c4-models.md.

If a token matches no doc type and is not an existing directory, list the valid types and stop rather than guessing.

doc type output file
readme README.md
wiki wiki.md
business-rules business-rules.md
business-overview business-overview.md
technical-overview technical-overview.md
c4-models c4-models.md
uml-diagrams uml-diagrams.md
project-overview project-overview.md

Procedure

  1. Scan. Build a picture of the repo before writing anything: git -C <repo> ls-files (fall back to find <repo> if not a git repo) for the file inventory; read the manifest (package.json, pyproject.toml, go.mod, pom.xml, …), the entrypoints, the config, and the modules that carry the domain logic. Read enough real code to write specifics — file names, function names, class names. Skip vendored trees (node_modules, .venv, vendor, dist, build) and anything .gitignored.
  2. Write. For each selected doc type, compose the full markdown per the shared rules and the per-document spec below, then Write it to <repo>/docgen-output/<output file>. Create the directory if missing. One complete document per file — never a stub, never a placeholder.
  3. Report. List the files written with their sizes.

Read the full file on GitHub · 293 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. 12d ago First seen · 293 lines · 102 tokens per session scan A a84b8e8a3f1e

Subscribe to this mod's changes

docgen is a skill published in the GitHub repository jnerytech/specd (0 stars, last pushed 2mo ago), licensed MIT. It adds 102 tokens to every session and 2,638 once invoked, about $0.0004 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-10-02.