Audit and update repository documentation, agent guidance, specifications, decisions, and runbooks while keeping tactical plans and tracker work out of the documentation surface.
99
—
Does it follow best practices?
Impact
99%
1.11xAverage score across 6 eval scenarios
Passed
No findings from the security scan
{
"context": "Tests whether the docs skill rewrites verbose operational documentation for agent retrieval: current supported state first, complete operational facts, no irrelevant negative inventory or history, and precise decision-changing limitations paired with a valid path.",
"type": "weighted_checklist",
"checklist": [
{
"name": "Current runtime leads",
"description": "docs/runtime.md leads with the current worker/runtime contract rather than historical background or a list of unavailable systems",
"max_score": 10
},
{
"name": "Start and health commands preserved",
"description": "docs/runtime.md preserves the exact `pnpm run scheduler` and `curl http://127.0.0.1:6120/status` commands",
"max_score": 10
},
{
"name": "Current configuration preserved",
"description": "docs/runtime.md maps `RUN_STORE_PATH`, `ARTIFACT_DIR`, and `SMTP_URL` to run records, generated artifacts, and completion or failure notices",
"max_score": 10
},
{
"name": "Owned paths preserved",
"description": "docs/runtime.md preserves `src/scheduler/main.ts` as the entrypoint and `src/runs/repository.ts` as run persistence",
"max_score": 8
},
{
"name": "Recovery path preserved",
"description": "docs/runtime.md keeps the `artifact write failed` recovery guidance and exact `pnpm run scheduler:retry -- <run-id>` command",
"max_score": 10
},
{
"name": "Negative inventory removed",
"description": "docs/runtime.md omits `SENTRY_DSN`, `PAGERDUTY_TOKEN`, `DATADOG_API_KEY`, `PROMETHEUS_URL`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `LOKI_URL`, the named observability-system inventory, and its categorical restatement about hosted log search, metrics scraping, or a telemetry collector",
"max_score": 12
},
{
"name": "Historical narrative removed",
"description": "docs/runtime.md omits the 2023/2025 CloudWatch and Splunk migration story and the closing historical recap",
"max_score": 8
},
{
"name": "Decision-changing limitation retained",
"description": "docs/runtime.md states that live log streaming is unsupported and pairs the boundary with paging `GET /v2/runs/:id/logs?after=<cursor>` every 5 seconds",
"max_score": 12
},
{
"name": "Agent-first structure and budget",
"description": "docs/runtime.md has at most 45 non-empty lines and uses task-shaped headings, bullets or mappings, and compact command blocks instead of novel-like paragraphs",
"max_score": 10
},
{
"name": "Report and factual restraint",
"description": "doc-report.md identifies preserved operational facts, removed context debt, and verification; neither output invents capabilities, commands, paths, or configuration",
"max_score": 10
}
]
}