Borrowing it
Nothing to install: this file belongs to christopher-buss/bedrock. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/christopher-buss/bedrock/main/.agents/skills/diataxis/SKILL.mdgit clone --depth 1 https://github.com/christopher-buss/bedrockWrote 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.
[](https://agentmods.dev/skills/christopher-buss/bedrock/diataxis)<a href="https://agentmods.dev/skills/christopher-buss/bedrock/diataxis"><img src="https://agentmods.dev/badge/skills/christopher-buss/bedrock/diataxis/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.
<a href="https://agentmods.dev/skills/christopher-buss/bedrock/diataxis"><img src="https://agentmods.dev/badge/skills/christopher-buss/bedrock/diataxis.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.00069 | $0.01447 |
| Opus 5.5 | $0.00028 | $0.00579 |
| Sonnet 5.5 | $0.00014 | $0.00289 |
| Haiku 4.5 | $0.00007 | $0.00145 |
Grade A, and why
diataxis 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 1mo 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.
How it starts
The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Diátaxis Documentation Governance
This skill enforces the Diátaxis framework for documentation. Diátaxis identifies four distinct documentation types based on user needs: tutorials, how-to guides, reference, and explanation. Each serves a different purpose and must be written differently.
Operating Modes
This skill operates in one of the following modes:
- classify: Identify which quadrant content belongs to
- audit: Analyze a doc set for gaps, imbalances, and violations
- generate: Create new documentation in a specified quadrant
- restructure: Split or reorganize existing mixed-mode content
The mode must be inferred from the user request or explicitly stated. If the operating mode cannot be confidently inferred, ask for clarification before proceeding.
Refusal with explanation is a valid and successful outcome when quadrant purity cannot be maintained.
Generate Mode Policy
For generate mode, one of the following must be true before producing content:
- The user explicitly states the target quadrant ("write a How-to for X"), OR
- The agent classifies the request, presents reasoning with confidence+evidence, and receives user confirmation
The Diátaxis Compass
Use this decision tree to classify content into exactly ONE quadrant:
| If content... | ...and serves user's... | ...then it belongs to... |
|---|---|---|
| informs action | acquisition (study) | Tutorial |
| informs action | application (work) | How-to Guide |
| informs cognition | application (work) | Reference |
| informs cognition | acquisition (study) | Explanation |
Two questions to ask:
- Does this inform action (doing) or cognition (knowing)?
- Does this serve acquisition (learning/study) or application (working)?
Quadrant Summary
Tutorial (learning-oriented)
A lesson that takes the learner through a practical experience. The instructor is responsible for the learner's success. Focus on doing, not explaining. Deliver results early and often. Minimize explanation. No choices or alternatives.
What ships with it
3 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.
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.
- 1mo ago First seen · 158 lines · 69 tokens per session scan A b6991beae28a
diataxis is a skill published in the GitHub repository christopher-buss/bedrock (19 stars, last pushed today), licensed MIT. It adds 69 tokens to every session and 1,447 once invoked, about $0.0003 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-01.
Other skills, from other repositories
x-demand-radar
A radar for spotting fast-rising topics, tools, and projects on X, the social network formerly known as Twitter.
null-axiom-twitter
A writing tool that creates Twitter/X posts and threads in the Null Axiom persona, with a style aimed at indie developers and data-focused investigators. It can also draft replies to Twitter/X posts and send drafts to Feishu for review on a schedule.
roblox-site-architect
Orchestrate an evidence-backed seven-stage Roblox site growth pipeline from opportunity assessment through keyword research, source collection, site planning, SEO QA, freshness, and growth. Use when work needs staged artifacts and explicit handoffs rather than a one-click site generator.
site-keyword-research
A website keyword-research workflow that studies what people search for, expands related terms, and analyses competition in search results.
roblox-homepage-ranking-auditor
Audit a Roblox or game-site homepage against the RB Auto Golden Homepage model. Use when Codex must inspect a live homepage or repository, identify the primary player job and main engine, score structural ranking potential across eight dimensions, detect empty query modules, weak information gain, root/child intent…
roblox-hit-evaluator
Evaluate a Roblox game's 30-day breakout potential from public evidence with auditable scores, missing-data bounds, frozen forecasts, and outcome reviews.