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.
npx skills add tkumata/AGENTS.md --skill brain-dump-docsgit clone --depth 1 https://github.com/tkumata/AGENTS.mdWrote 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/tkumata/agents.md/brain-dump-docs)<a href="https://agentmods.dev/skills/tkumata/agents.md/brain-dump-docs"><img src="https://agentmods.dev/badge/skills/tkumata/agents.md/brain-dump-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.
<a href="https://agentmods.dev/skills/tkumata/agents.md/brain-dump-docs"><img src="https://agentmods.dev/badge/skills/tkumata/agents.md/brain-dump-docs.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.00072 | $0.01368 |
| Opus 5.5 | $0.00029 | $0.00547 |
| Sonnet 5.5 | $0.00014 | $0.00274 |
| Haiku 4.5 | $0.00007 | $0.00137 |
Grade A, and why
brain-dump-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 27d 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 — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Brain Dump Docs Skill
- この Skill は、ユーザか
issue-workflowスキルがbrain-dump-docsを明示的に指定した場合のみ使用し、自動選択や文脈推定によって使用しない。 - ユーザの意図を保ったまま、開発に必要な文書だけを作成または更新する。ソースコードは変更しない。
- 相談や方針確認だけの依頼では文書を生成しない。実装計画を文書化しても、ユーザの承認なしに実装を開始しない。
- ユーザの目標が何だと思うか、そしてユーザが解決しようとしている問題が何かを、あなた自身の言葉で言い換えてください。
Rules
- 開発文書はリポジトリ規約に従い、指定がなければ日本語で作成する。
- ユーザの明示的な指示とリポジトリ固有の文書規約を優先する。
- 確定事項、仮定、候補、未決定事項を区別する。
- 実装結果を左右し、既存情報から解決できない不明点だけを Open Questions に残す。
- 依頼に必要な文書とコードだけを確認し、無関係な履歴や過去の計画を網羅的に調査しない。
- 変更した文書と直接参照する仕様の範囲で確認する。
- 実装後の再計画、完了処理、Finalization は行わない。
- 規則が競合する場合は依頼範囲を広げない。
- 一文には一つの要求または一つの操作だけを書く。
- 主語と対象を省略しない。
- 指示語 (これ、それ、あれ) を原則として使用しない。
- 「場合」「とき」「際」の使い分けを統一する。
- 「〜することができる」ではなく、可能なら「〜できる」と書く。
- 同一概念には常に同一の用語を使用する。
- 同義語を使い分けない。 例: 削除 / 消去 / クリア → 「削除」に統一
- 「適切に」「必要に応じて」「なるべく」など、判定基準が不明確な表現を使用しない。
- 条件を先に書き、その後に動作を書く。
- 否定を重ねない。
- 長い修飾節を避ける。
- 一文は原則として60文字以内とする。
- 箇条書きを使用できる場合は長い並列表現を避ける。
- MUST / SHOULD / MAY に相当する要求レベルを明示する。
- 用語集に登録されている語を優先する。
- 日本語と英語の間は半角空白文字を入れる。
- 記号は原則半角文字を使用する。
Artifacts
リポジトリに文書の名称、配置、形式、承認規約がある場合はそれに従う。規約がない場合は以下を既定とする。
docs/current/PRD.md: 背景、対象ユーザ、ゴール、スコープ、成功指標docs/current/REQUIREMENTS.md: 要求、制約、受け入れ条件docs/current/SPECIFICATIONS.md: 外部動作、入出力、状態、エラー、境界条件docs/current/DESIGN.md: 責務、依存関係、外部境界、主要データ構造docs/adr/NNNN-short-title.md: 長期的な変更コストを持つ設計判断docs/plans/active/YYYY-MM-DD-short-name.md: 小規模変更は会話で範囲を提示できるようにし、plan は明示要求・複数段階・別セッションへの引き継ぎに限定
- ADR は上書きせず、判断を変更する場合は新しい ADR を作成する。
- 承認済み範囲は維持し、変更された範囲だけを未承認として扱う。ユーザ承認なしに approved と記録しない。
Active Plan
- 各タスクに対象範囲、必要な仕様、受け入れ条件、検証方法を記載する。未決定事項は Open Questions に残す。
- 独立して実装・検証できる単位で分割する。
- 既存 plan は既存構造を優先し、テンプレート適合だけを目的に書き換えない。
Templates
新規作成時は以下のテンプレートに従うこと。
references/prd-template.md: PRD のテンプレートreferences/requirements-template.md: 要件定義のテンプレートreferences/specifications-template.md: 仕様のテンプレートreferences/design-template.md: 設計のテンプレートreferences/adr-template.md: ADR のテンプレートreferences/active-plan-template.md: Active Plan のテンプレート
What ships with it
6 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.
- 27d ago Changed · +4 lines · +37 tokens per session 8ada42d14b9d
- 1mo ago Changed · +17 lines 6136752a2991
- 1mo ago Changed · +9 lines 85b506ab6ba8
- 1mo ago First seen · 48 lines · 35 tokens per session scan A abe01bac6706
brain-dump-docs is a skill published in the GitHub repository tkumata/AGENTS.md (1 stars, last pushed today), licensed MIT. It adds 72 tokens to every session and 1,368 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-16.
Other skills, from other repositories
codex-autoresearch
Run repeated, measured Git experiments toward a numeric target; keep improvements and revert failures. Use for autonomous optimization or managing an autoresearch run, not one-shot edits.
clipboard
Copy text to clipboard with optional rich formatting. Triggers on "copy to clipboard", "copy that", "pbcopy", "copy formatted", "copy rich text".
neo4j-modeling-skill
Design, review, and refactor Neo4j graph data models. Use when choosing node labels vs relationship types vs properties, migrating relational/document schemas to graph, detecting anti-patterns (generic labels, supernodes, missing constraints), designing intermediate nodes for n-ary relationships, enforcing schema with…
rexai-image-generation
An image-generation skill that uses RexAI to create new images from text or transform existing images from other images. It returns the result as a local file.
ox-cli-attest
Publish a frozen Attest run to SageOx with ox attest publish --from --out . Read BEFORE publishing an Attest report, regenerating a report from a checkout, or debugging a failed or interrupted publish — ox publishes the frozen export only and never reconstructs a report from current files.
code-that-fits-in-your-head
Software-engineering heuristics based on Mark Seemann's Code That Fits in Your Head (2021), updated for agent-driven development. Use when writing or reviewing code, refactoring accidental complexity or a Big Ball of Mud, controlling technical or architectural debt in generated code, designing APIs and invariants…