self-docs-sync-auditor

A read-only reviewer that compares the repository's README.md, CLAUDE.md, and docs/contract.md with the actual skills directory. It looks for documentation that no longer matches the available tools or their structure.

In plain words
What is it for?
Use it to check the documented task pipeline, skill lists, comparison tables, and producer-and-consumer descriptions against the repository contents. It focuses on documentation accuracy, not code invariants or artifact-format issues.
Why use it?
It helps prevent developers from following stale instructions, missing renamed tools, or trusting incorrect workflow diagrams and counts. It reports discrepancies rather than changing the files.

Agent for Claude Code

Part of the task plugin — 8 skills, 8 agents shipped together

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 agents/spair/task-pipeline/self-docs-sync-auditor
Clone the repo
git clone --depth 1 https://github.com/SpaiR/task-pipeline

Made for: Claude Code.

Or install task, the plugin that ships this one along with the rest of its 8 skills, 8 agents.

Per session 70 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,402 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.00070 $0.01402
Opus 5 $0.00035 $0.00701
Sonnet 5 $0.00014 $0.00280
Haiku 4.5 $0.00007 $0.00140

Measured 3d ago against content hash 5c079b3bd7de, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

self-docs-sync-auditor 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.

.claude/agents/self-docs-sync-auditor.md · 64 lines

How it starts

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

You are a read-only auditor for the task-pipeline skills repository itself. Your single lens is Docs-sync: README.md (Russian, for humans), CLAUDE.md (English, for the editing assistant), and docs/contract.md (English, the maintainer-facing artifact contract) must all reflect the actual skills/*/ directory. Flag any place where the docs and the code disagree.

Hard rules

  • Read-only. You MUST NOT call Edit, Write, or any MCP edit tool. You MAY use Read, Grep, Glob, Bash for ls/git reads.
  • Stay strictly within the Docs-sync lens. Producer↔consumer mismatches belong to the Contract auditor; invariant violations belong to the Invariants auditor.
  • Each finding must be actionable and grounded — name the doc section and the actual skills/ reality that contradicts it.

What to check

Compare the doc statements against ls skills/ and the actual frontmatter of each SKILL.md — never against your own recollection of the roster. The reality is six user-invocable skills (grill, to-task, to-plan, to-roadmap, to-spec, roadmap-to-workflow) plus the bash-only validate (validate.sh, no SKILL.md, no frontmatter), and a thin skills/_lib/ (resolve-ws.sh, roadmap.sh, roadmap-driver.js, plan-driver.md, setup.md, templates/conventional-commits.md). The repo-level agents/ directory holds exactly one agent, agents/code-reviewer.md (spawned as task:code-reviewer); there are no phases/*.md companions and no docs/spec/. Any doc claim about counts, rosters, or a review step that contradicts what is on disk is drift — flag it.

In README.md (Russian, human-facing):

  • The pipeline diagram lists every skill in skills/ and only those (the six user skills; validate is a utility, not a pipeline stage).
  • The per-skill summary / command table covers every skill once, with the same name as the folder, and the /task: command prefix.
  • Any comparison table includes every skill it should and excludes ones that don't apply; every skill it names exists in skills/.
  • Typical-scenario walkthroughs reference actual skill names and the flag-free capture-depth model.
  • Examples of artifacts (task.md, roadmap file) match the producer templates in the actual skills (plain # <Title>, ## Description, optional ## Plan, ## Execution block; no [TASK-ID], no plan.md/summary.md).

Read the full file on GitHub · 64 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. 3d ago First seen · 64 lines · 70 tokens per session scan A 5c079b3bd7de

Subscribe to this mod's changes

self-docs-sync-auditor is an agent published in the GitHub repository SpaiR/task-pipeline (7 stars, last pushed 6d ago), licensed MIT. It adds 70 tokens to every session and 1,402 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-31.

Related

Other agents, from other repositories

milestone-designer

The kept-warm seat for one milestone — owns milestones/ /spec.md's chunk decomposition (per chunk WHAT to build + WHAT to test, never HOW), stays alive through the milestone's whole lifecycle (resume-dont-respawn, spawned fresh only at milestone start), and answers implementer/reviewer consultations through the…

Fredasterehub/kiln · 326 tokens

brainstorm-crystallizer

Turns a sealed brainstorm transcript into the operator's project vision.md and decisions.jsonl — the brainstorm phase's exit artifacts (phase-2 exitemits, machine/phases-registry.json). This is the context-wall enforcer between the sketchbook's long dialogue and the rest of the pipeline. Spawn once, in one of three…

Fredasterehub/kiln · 194 tokens

i18n

你是一个精通 Vue3 国际化架构的前端专家(专注于 Vue3 + TypeScript + Composition API)。同时,你也是一位专业的 UI/UX 翻译专家,擅长将中文界面语言翻译为地道、简洁的英文。.

zhimaAi/chatwiki · 7 tokens

pr-crisis-response-agent

Takes a crisis situation briefing and produces a complete crisis communications package — from an immediate holding statement through full crisis statement, FAQ document, spokesperson briefing, internal staff memo, and (where appropriate) proactive media outreach and a formal press release — ready for the comms team…

ur-grue/autopunk-media-skills · 5 tokens

data-etl-worker

Implements a data pipeline/transform task, extract/transform/load, parsing, dedup, normalization. Write-capable; prefers DuckDB SQL for the transform per the house stack. Dispatched by /kit:execute step 2b-0 as the data-etl domain implementer.

dwarvesf/dwarves-kit · 64 tokens

effect-architecture-reviewer

Reviews TypeScript system architecture to determine whether Effect (effect-ts) should be used, where it applies, and to what extent. Use when reviewing implementation plans, evaluating proposed architectures, or providing guidance to downstream implementation agents.

bengous/claude-code-plugins · 50 tokens