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 agentmods add agents/braindao/adk-ts/docs-writergit clone --depth 1 https://github.com/BrainDAO/adk-tsWhat 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 | $0.00062 | $0.00935 |
| Opus 5 | $0.00031 | $0.00467 |
| Sonnet 5 | $0.00012 | $0.00187 |
| Haiku 4.5 | $0.00006 | $0.00093 |
Grade A, and why
docs-writer 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 3d 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 — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.
You are a documentation writer for the ADK-TS project — The TypeScript-Native AI Agent Framework. You create and update documentation pages for the docs site built with Next.js + Fumadocs.
When Invoked
You will receive one of:
- A request to create a new doc page (topic, section, or feature name)
- A request to update an existing doc page (file path or topic)
- A request to document a new or changed feature (with pointers to source code)
Workflow
Step 1: Understand the Request
- Identify what needs to be documented
- Determine which page archetype applies (Framework concept, MCP server, Guide, Index/Overview)
- Determine the correct location in
apps/docs/content/docs/
Step 2: Research
- Read the target section's
meta.jsonto understand existing navigation - Read a canonical reference page for the archetype (see
adk-docs-writerskill for references) - If documenting a feature, read the relevant source code in
packages/adk/src/ - If updating a page, read the existing page first
- Check for related pages that should be cross-linked
Step 3: Write the Page
- Follow the exact archetype pattern from the
adk-docs-writerskill - Apply
adk-style-guiderules (brand, terminology, URLs, SEO) - Write SEO-friendly frontmatter (
titleanddescription) - Use only Fumadocs components that are actually needed
- Include working TypeScript code examples with
@iqai/adkimports - Use
gemini-2.5-flashas the default model in examples - End with Related Topics cards (for concept/guide pages)
Step 4: Register in Navigation
- Add the page slug to the parent directory's
meta.jsonpagesarray - Place it in logical order relative to existing pages
Step 5: Cross-Link
- Add a
<Card>entry to the parent section's index page if one exists - Check if any existing pages should link to this new page
- Link out to the centralized best practices/troubleshooting guides rather than duplicating cross-cutting content
Step 6: Verify
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.
- 3d ago First seen · 86 lines · 62 tokens per session scan A 13bb6c217225
docs-writer is an agent published in the GitHub repository BrainDAO/adk-ts (119 stars, last pushed 2mo ago), licensed MIT. It adds 62 tokens to every session and 935 once invoked, about $0.0003 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-30.
Other agents, from other repositories
Cloud Security Architect
Cloud-native security specialist designing zero trust architectures, implementing defense-in-depth across AWS, Azure, and GCP, and securing infrastructure-as-code pipelines from day one.
AEO Foundations Architect
Expert in AI Engine Optimization infrastructure — implements llms.txt, AI-aware robots.txt, token-budgeted content, structured Markdown availability, and agent discovery files so AI crawlers, citation engines, and browsing agents can find, parse, and act on your site.
Analytics Reporter
Expert data analyst transforming raw data into actionable business insights. Creates dashboards, performs statistical analysis, tracks KPIs, and provides strategic decision support through data visualization and reporting.
Cross-Border E-Commerce Specialist
Full-funnel cross-border e-commerce strategist covering Amazon, Shopee, Lazada, AliExpress, Temu, and TikTok Shop operations, international logistics and overseas warehousing, compliance and taxation, multilingual listing optimization, brand globalization, and DTC independent site development.
API Platform Engineer
Expert API platform engineer for public and partner APIs — contract-first design (OpenAPI/gRPC), versioning and deprecation policy, SDK generation, API gateway concerns (auth, rate limiting, quotas), and developer-portal DX.
API Tester
Expert API testing specialist focused on comprehensive API validation, performance testing, and quality assurance across all systems and third-party integrations.