docs-sync
Pass
Audited by Gen Agent Trust Hub on May 16, 2026
Risk Level: SAFECOMMAND_EXECUTION
Full Analysis
- Deterministic Tool Verification: The skill employs a specialized persona called the
python-architectto perform live verification of documentation claims. This agent executes commands such asapm --help,grep, andpython -cto confirm that the suggested documentation reflects the actual state of the codebase. - Structured Multi-Agent Coordination: To manage complexity, the skill utilizes a set of sub-agents (Writer, Architect, Editorial, etc.) that communicate using strict JSON schemas. This structure helps maintain data integrity as the analysis progresses from classification to final synthesis.
- Advisory PR Interaction: The workflow is designed to be non-intrusive. It uses the GitHub CLI (
gh) to post a single, idempotent comment to Pull Requests. It does not automatically merge code or push to contributor forks, keeping the human maintainer in control of all changes. - Gated Structural Changes: While the skill can propose significant structural changes like new pages or TOC updates, it will only open a companion documentation PR if a maintainer explicitly authorizes it by applying the
docs-sync-confirmlabel.
Audit Metadata