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 softspark/ai-toolkit --skill documentation-standardsgit clone --depth 1 https://github.com/softspark/ai-toolkitWrote 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/softspark/ai-toolkit/documentation-standards)<a href="https://agentmods.dev/skills/softspark/ai-toolkit/documentation-standards"><img src="https://agentmods.dev/badge/skills/softspark/ai-toolkit/documentation-standards/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/softspark/ai-toolkit/documentation-standards"><img src="https://agentmods.dev/badge/skills/softspark/ai-toolkit/documentation-standards.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.00060 | $0.01773 |
| Opus 5 | $0.00030 | $0.00886 |
| Sonnet 5 | $0.00012 | $0.00355 |
| Haiku 4.5 | $0.00006 | $0.00177 |
Grade A, and why
documentation-standards 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 8d 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 — 223 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Documentation Standards
Auto-loaded knowledge skill enforcing KB document conventions across all agents and skills.
Frontmatter Specification (MANDATORY)
Every document in kb/ MUST start with YAML frontmatter:
---
title: "Document Title" # REQUIRED — English, descriptive
category: reference # REQUIRED — one of the 10 valid categories
service: ai-toolkit # REQUIRED — service identifier
tags: [tag1, tag2, tag3] # REQUIRED — minimum 1, recommended 3+
last_updated: "YYYY-MM-DD" # REQUIRED — ISO format
created: "YYYY-MM-DD" # REQUIRED — creation date
description: "One-line summary." # REQUIRED — for search indexing
version: "1.0.0" # optional — semver
---
All 7 fields above are REQUIRED. Documents without valid frontmatter fail
scripts/validate.py and block CI.
section: a legacy alias, not a second field
Older documents and the kb-migration SOP write section: where this
specification writes category:. Both names are read in the wild, so a document
may carry both — and when it does they must hold the same value. A document
filed as category: reference and section: howto is indexed twice, found
once, and the reader gets whichever the index ranked higher.
New documents should write category:. section: is accepted, never required,
and never authoritative on its own.
Category Taxonomy
| Category | Directory | Purpose | Examples |
|---|---|---|---|
reference |
kb/reference/ |
Technical specifications, catalogs, architecture notes, API docs | agents-catalog.md, architecture-overview.md |
howto |
kb/howto/ |
Step-by-step task guides | use-corrective-rag.md, configure-mcp-server.md |
procedures |
kb/procedures/ |
SOPs a person follows: release, migration, review | sop-maintenance.md, sop-release.md |
troubleshooting |
kb/troubleshooting/ |
Problem resolution, debugging guides | database-connection-issues.md |
best-practices |
kb/best-practices/ |
Guidelines, recommendations, standards | security-checklist.md |
decisions |
kb/decisions/ |
Architecture decision records and design rationale | adr-004-kb-migration.md |
runbooks |
kb/runbooks/ |
Procedures run against a live system, usually under pressure | deployment.md, incident-response.md |
planning |
kb/planning/ |
Roadmaps, PRDs, work not yet done | q3-roadmap.md |
business |
kb/business/ |
Domain model, requirements, use cases, user stories | domain-model.md, user-stories.md |
templates |
kb/templates/ |
Reusable document templates | adr-template.md, sop-template.md |
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.
- 8d ago First seen · 223 lines · 60 tokens per session scan A 5b57d0ca5ce7
documentation-standards is a skill published in the GitHub repository softspark/ai-toolkit (172 stars, last pushed yesterday), licensed Apache-2.0. It adds 60 tokens to every session and 1,773 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-09-03.
Other skills, from other repositories
tech-doc-writer
A guide for writing, reviewing, and improving technical documents such as API documentation, design documents, runbooks, and incident reports.
local-transcript
Transcribe a specified local video or audio file into cleaned final .txt, .pdf, or .docx transcripts using speech recognition with Apple Silicon GPU acceleration and optional LLM-based proofreading. Use when the user wants text extracted from a local media file path such as .mp4, .mov, .mkv, .webm, .mp3, .m4a, or…
file-processor-subagent
Sous-agent de traitement de fichiers — lecture, parsing, transformation et génération de fichiers multiformats. Se déclenche avec "sous-agent fichier", "file processing agent", "agent qui traite des fichiers", "PDF agent", "Excel agent", "document processor", "file parser agent". Also triggers on "agent that parses…
llm-text-hygiene
Skill "llm-text-hygiene" from ellmos-ai/skills, covering übersicht & zweck, prüfkatalog, 2. platzhalter und baustellen-marker (eindeutig → auflösen), 4. ai-disclosure (prüfen → korrigieren) and ablauf.
tageszeitung
Creates a personalised daily newspaper from RSS feeds and web sources. Ported from the BACH news system (news.py + newspapergenerator.py). Own SQLite store (no Origin-DB). feedparser optional — XML fallback via stdlib. PDF export via Edge Headless (msedge.exe).
steuer-assistent
Points to the standalone module steuer-assistent: a local, offline-first receipt worksheet for German employee income-related expenses (Werbungskosten) -- record, sum to the cent, private ZIP export. Use this skill when Werbungskosten receipts should be prepared in a structured way -- with a clear boundary: not tax…