agent-doc-skillsCAUTION

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

npx skills add x0c/agent-doc-skills -g

Use doc-init to establish documentation for this project from its existing authorities.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: doc-compact
description: Audit and compress bloated project documentation while preserving behavior and repairing navigation. Use for redundant docs, broken indexes, oversized AGENTS.md, malformed CLAUDE.md, or missing global documentation governance.
---

# Documentation compaction

Audit and compress documentation while preserving adopted behavior, evidence and discoverability. Follow the installed lifecycle and environment policies; use `agents-md-edit` for AGENTS.md edits. Delegate only under current user authorization.

## Choose the work

- **Read-only audit:** run `python3 scripts/audit.py PROJECT_ROOT` and inspect actual coverage, misplaced/repeated content and relevant authority. Use the audit sections of [maintenance workflow](references/maintenance-workflow.md#step-2--read-only-audit). Do not install presets, stamp or repair files.
- **Bounded cleanup:** inspect the affected domain and overlapping references, then use the relevant structure/compression/verification sections of that workflow. Do not expand a small request into a repository census.
- **Whole-project cleanup:** read [maintenance workflow](references/maintenance-workflow.md). Discover effective global instructions, audit each actual documentation host, decide structure by readability, compress content and verify the full requested scope.

## Preservation and verification

Change generated or inherited rules through their actual source; preserve managed markers and valid coverage. Use concise content summaries with the shared relevance instruction, without arbitrary reading quotas. Compression does not drop scope, exceptions, timing, evidence or machine-parsed literals.

Read [compression guide](references/compression-guide.md) before substantive compression. Distinguish a smaller file from preserved behavior. Check navigation, source/path liveness, ordinary and exceptional scenarios, and required compact-stamp coverage. Report per-domain results and unresolved factual contradictions; a successful script or stamp is limited coverage evidence.

## Migration completion and stop rule

An authorized knowledge migration is complete when the shared authority preserves the reusable knowledge's applicability and exceptions, local product contracts and evidence remain intact, generic duplication is replaced where safe, and content rereading plus navigation checks reveal no unresolved material defect. For multi-file work, reuse one concise source → authority → local retention/outcome table when useful; a small edit needs no extra ledger.

After accepted changes pass the scoped checks, close out rather than starting another harvest or wording pass. Reopen for a concrete defect, contradiction, missed authorized item, or new user direction. Additional reviews need a specific unresolved question; optional polish alone does not require another cycle.

CAUTIONgrade C · trust 79/100 Install with care. The audit found things worth knowing before you trust its output.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (4)

- On connection failure, insufficient permissions, or suspected high-risk production access, report missing items; do not bypass safety limits.

- API validation (HTTP scenarios): `curl -s -X POST http://127.0.0.1:<port>/<path> -H 'Content-Type: application/json' -d '<minimal body>'`

- Cache/state refresh (caching scenarios): `curl -s -X POST http://127.0.0.1:<port>/<refresh_path>`

When the user explicitly says “don’t ask,” “test mode,” “dry run,” “report only,” “don’t write files,” or “limit scanned files / docs / budget,” enter convergent mode and strictly respect those bounds

Gates applied: instruction_override, no_behavioural_pass.