docs

A documentation tool based on Diátaxis, a method that separates docs into tutorials, task guides, reference material, and explanations. It routes a document to the appropriate type, helps write or edit it, and checks its Markdown formatting.

In plain words
What is it for?
It helps create or reorganise individual user-documentation pages, decide where they belong, and validate their Markdown.
Why use it?
It helps keep documentation focused on one purpose and catches formatting problems before publication.

Skill for Claude CodeCodex

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/backchainai/backchain-plugins/docs
Any agent
npx skills add backchainai/backchain-plugins --skill docs
Clone the repo
git clone --depth 1 https://github.com/backchainai/backchain-plugins

Made for: Claude Code, Codex.

Per session 173 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,914 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.00173 $0.03914
Opus 5 $0.00086 $0.01957
Sonnet 5 $0.00035 $0.00783
Haiku 4.5 $0.00017 $0.00391

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

Security

Grade A, and why

docs 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.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/check_markdown.py, scripts/test_check_markdown.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.

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.

scriptorium/skills/docs/SKILL.md · 253 lines

How it starts

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

Docs

Route one document to the mode it belongs in, write it under that mode's constraints, then check its markdown form.

The unit of work is one document and one next action. This skill does not plan a documentation set top-down, does not audit a whole docs/ tree in one pass, and does not produce an outline for a future set of pages.

Two paths share the same routing step: writing a new document (the write path) and assessing one that already exists (the place path). Both start at the compass below, and both end at the same markdown-form check.

Where this does not apply

Diataxis governs product documentation written for a user. It does not govern everything that happens to be a markdown file in a repository.

Check the request against this table before routing anything:

Out of scope Why
ADRs and decision records A dated historical artifact, not one of the four modes
Commit messages, PR descriptions Not user documentation
Changelogs, release notes Chronological by nature; no mode applies
Code comments and docstrings Belong to the code, not the documentation set
CLAUDE.md, agent and tool config Instructions to a machine, not a user

When the request names one of these, say which row applies and stop before opening the compass.

None of the four modes fits an artifact that is fundamentally dated, historical, or machine-facing.

READMEs are in scope: advise on README structure when asked (trim it, reorder it, link out more aggressively), but never propose extracting its parts into separate mode documents the way this skill would for a contaminated tutorial or how-to guide. A README is a landing page and legitimately hybrid.

When scope is ambiguous

  • A design doc that reads like project history belongs with ADRs, even if nobody labeled it one.
  • A "docs" folder that turns out to hold internal runbooks for the team, not instructions for a product user, is out of scope until the request is reframed around an external reader.
  • A file named NOTES.md sitting next to code is closer to a code comment than to any of the four modes; ask what reader it serves before routing it.

Read the full file on GitHub · 253 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. yesterday First seen · 253 lines · 173 tokens per session scan A ec86b859aa22

Subscribe to this mod's changes

docs is a skill published in the GitHub repository backchainai/backchain-plugins (4 stars, last pushed 26d ago), licensed Apache-2.0. It adds 173 tokens to every session and 3,914 once invoked, about $0.0009 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-31.

Related

Other skills, from other repositories

diagnose-with-memory

과거 실패 기억을 회상해 버그를 진단하고 근본원인을 다시 기억에 남길 때 사용한다.

ezBuilder/code-brain · 32 tokens

tdd-with-memory

과거 결정·컨벤션을 회상해 테스트 우선으로 구현하고 새 컨벤션을 기억에 남길 때 사용한다.

ezBuilder/code-brain · 35 tokens

a-unslop-code

Finds what makes source code read as AI-written and points you at the parts that actually ship bugs. Sorts every tell into three buckets and fixes them in that order: bugs (swallowed errors, a made-up API, a left-in "rest of the code" stub), substance (tutorial-shaped boilerplate, over-engineering, code that ignores…

imisic/claude-marketplace · 187 tokens

close-session

End-of-session ritual — audit today's patterns against accumulated memory, propose promotions, refresh MEMORY.md, and write the session handoff. Use when the user says "/memory-kit:close-session", "закрой сессию", "закрываем", "we're done for today", "wrap up".

awrshift/agent-memory-kit · 64 tokens

innate-memory

Innate procedural knowledge layer for coding, debugging, and analysis sessions. ACTIVATE when: (1) user says "remember", "save", "log", "follow this rule", "don't forget", "recall", or "what did we learn"; (2) a non-obvious solution, workaround, constraint, or invariant was discovered during this session; (3) starting…

vima-tech/Innate · 156 tokens

kayba-stage-5-action-plan

Triage each insight into discard/code-fix/prompt-fix and produce a prioritized action plan with specific recommendations. Trigger when the user says "run stage 5", "make action plan", "triage skills", or when invoked by the kayba-pipeline orchestrator. Requires eval outputs from stages 1-4.

kayba-ai/agentic-context-engine · 74 tokens