[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AW1R0E02MZ6N2TY8FWFVSC":3,"skill-same:01M7AW1R0E02MZ6N2TY8FWFVSC":79},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7AW1R0E02MZ6N2TY8FWFVSC","repo-doc-synchronizer",null,"Audit repository documentation coverage, detect doc drift against live code signatures, update stale references, and author missing Diátaxis documentation suites. Do not use for generic copyediting or non-technical prose.","SpectreDeath\u002FBrain-Harness","SpectreDeath","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F207463416?v=4","01M7AVGR1D4X8ADT47APKGVH2Z","JL","01M7AVGR2HSGD23BA5DBTJJTVN",0,"MIT","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: repo-doc-synchronizer\ndescription: Audit repository documentation coverage, detect doc drift against live code signatures, update stale references, and author missing Diátaxis documentation suites. Do not use for generic copyediting or non-technical prose.\n---\n\n# Repository Documentation Synchronizer\n\n`repo-doc-synchronizer` audits codebase documentation coverage, identifies stale or missing documentation across packages and plugins, and authors standardized technical documentation suites conforming to the Diátaxis taxonomy.\n\nSee [CARD.md](CARD.md) for companion cheat sheets, CLI triggers, and invariant checklists.\n\n---\n\n## Overview\n\nThe skill operationalizes documentation as an active engineering contract (\"Docs-as-Code\"):\n- **AST Symbol Inspection**: Extracts classes, callables, type annotations, and docstrings via static analysis.\n- **Coverage Auditing**: Quantifies module documentation health (docstrings, public symbol coverage, dedicated Markdown guides).\n- **Drift Detection**: Flags broken local file links and stale symbol signatures in existing documentation.\n- **Diátaxis Scaffolding**: Synthesizes structured API references, how-to recipes, and package READMEs populated with live AST data.\n- **Visual Briefs**: Emits interactive Mermaid.js diagrams illustrating coverage topology before making modifications.\n\n---\n\n## Dependencies\n\n- **[developer-docs-architect](..\u002Fdeveloper-docs-architect\u002FSKILL.md)**: Dispatched for deep Diátaxis quadrant authoring (API specs, C4 Mermaid architecture models, and developer guides).\n- **[codebase-context-architect](..\u002Fcodebase-context-architect\u002FSKILL.md)**: Dispatched when synchronizing multi-layer agent context files (`AGENTS.md`, `CLAUDE.md`).\n- **[crafting-skills](..\u002Fcrafting-skills\u002FSKILL.md)**: Followed for skill formatting, visual briefs, and summary cards.\n\n---\n\n## Quick Start\n\n### 1. Audit Repository Documentation Coverage\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py audit --root . --output coverage_scorecard.json\n```\n\n### 2. Detect Documentation Drift and Broken Links\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py drift-check --root . --output drift_report.json\n```\n\n### 3. Generate Interactive Visual Coverage Brief\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py visual-brief --root . --output %TEMP%\u002Fdoc_brief.html\n```\n\n### 4. Scaffold Missing Diátaxis Documentation\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py scaffold --module src\u002Fharness\u002Fservices\u002Fagentwikis.py --type api --output docs\u002Fapi\u002Fagentwikis.md\n```\n\n---\n\n## Utility Scripts\n\nThe skill provides `scripts\u002Fdoc_synchronizer.py` with four deterministic subcommands:\n\n1. **`audit`**:\n   - Analyzes Python modules against Markdown docs.\n   - Flags files with missing docstrings or missing dedicated documentation.\n   - Calculates overall coverage percentage against `--min-coverage` threshold.\n2. **`drift-check`**:\n   - Strips code blocks to eliminate false positives per Rule 47.\n   - Verifies relative markdown links against active filesystem files.\n3. **`scaffold`**:\n   - Ingests a module via AST.\n   - Pre-populates clean Diátaxis documentation templates (`api`, `readme`, `howto`).\n4. **`visual-brief`**:\n   - Generates a self-contained HTML file rendering a dark-mode Mermaid diagram showing documented vs. deficit modules.\n\n---\n\n## Workflow: 4-Stage Execution Loop\n\n### Stage 1: Documentation Coverage Audit\n1. Execute the `audit` subcommand across target modules or plugins.\n2. Inspect the generated JSON coverage scorecard to identify undocumented public classes, methods, and modules.\n\n### Stage 2: Drift & Integrity Inspection\n1. Execute `drift-check` across documentation directories (`docs\u002F`, `plugins\u002F`).\n2. Identify broken relative links or stale symbol names resulting from code refactoring.\n\n### Stage 3: Visual Brief & Mandatory Checkpoint\n1. Render an interactive HTML visual brief using `visual-brief`.\n2. Present findings and planned additions to the user via `implementation_plan.md` with explicit Mandatory Checkpoint review gates (`RequestFeedback: true`).\n3. Halt and await explicit user approval before writing or updating documentation files.\n\n### Stage 4: Synthesis, Scaffolding & Verification\n1. **Package-Level Diátaxis Scaffolding**: Prioritize authoring package-level `README.md` guides for core packages (`src\u002Fharness\u002Fcommands\u002F`, `src\u002Fharness\u002Fbridges\u002F`) and plugins (`plugins\u002F\u003Ccategory>\u002F\u003Cplugin>\u002F`). A package `README.md` elevates all sibling modules by providing live AST symbol tables and manifest metadata without generating file sprawl.\n2. Scaffold missing documentation using `scaffold` with appropriate Diátaxis quadrant templates.\n3. Update existing documentation files to repair broken links and update function signatures.\n4. Re-run `drift-check` and `audit` to verify 100% resolution of coverage deficits.\n\n---\n\n## Anti-Patterns\n\n- **Premature File Mutation** — Modifying existing documentation or creating new files without first auditing AST symbols and presenting an implementation plan.\n- **Ungrounded Prose** — Writing speculative narrative text instead of deriving class and function documentation directly from active AST syntax trees.\n- **Broken Relative Links** — Writing workspace-absolute `file:\u002F\u002F\u002F` URIs or unverified links that break in sandboxes or CI environments.\n- **Monolithic Conflation** — Combining tutorials, architecture rationale, and reference tables on a single page instead of adhering to Diátaxis quadrants.\n","# Repository Documentation Synchronizer\n\n`repo-doc-synchronizer` audits codebase documentation coverage, identifies stale or missing documentation across packages and plugins, and authors standardized technical documentation suites conforming to the Diátaxis taxonomy.\n\nSee [CARD.md](CARD.md) for companion cheat sheets, CLI triggers, and invariant checklists.\n\n---\n\n## Overview\n\nThe skill operationalizes documentation as an active engineering contract (\"Docs-as-Code\"):\n- **AST Symbol Inspection**: Extracts classes, callables, type annotations, and docstrings via static analysis.\n- **Coverage Auditing**: Quantifies module documentation health (docstrings, public symbol coverage, dedicated Markdown guides).\n- **Drift Detection**: Flags broken local file links and stale symbol signatures in existing documentation.\n- **Diátaxis Scaffolding**: Synthesizes structured API references, how-to recipes, and package READMEs populated with live AST data.\n- **Visual Briefs**: Emits interactive Mermaid.js diagrams illustrating coverage topology before making modifications.\n\n---\n\n## Dependencies\n\n- **[developer-docs-architect](..\u002Fdeveloper-docs-architect\u002FSKILL.md)**: Dispatched for deep Diátaxis quadrant authoring (API specs, C4 Mermaid architecture models, and developer guides).\n- **[codebase-context-architect](..\u002Fcodebase-context-architect\u002FSKILL.md)**: Dispatched when synchronizing multi-layer agent context files (`AGENTS.md`, `CLAUDE.md`).\n- **[crafting-skills](..\u002Fcrafting-skills\u002FSKILL.md)**: Followed for skill formatting, visual briefs, and summary cards.\n\n---\n\n## Quick Start\n\n### 1. Audit Repository Documentation Coverage\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py audit --root . --output coverage_scorecard.json\n```\n\n### 2. Detect Documentation Drift and Broken Links\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py drift-check --root . --output drift_report.json\n```\n\n### 3. Generate Interactive Visual Coverage Brief\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py visual-brief --root . --output %TEMP%\u002Fdoc_brief.html\n```\n\n### 4. Scaffold Missing Diátaxis Documentation\n```bash\npython .agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py scaffold --module src\u002Fharness\u002Fservices\u002Fagentwikis.py --type api --output docs\u002Fapi\u002Fagentwikis.md\n```\n\n---\n\n## Utility Scripts\n\nThe skill provides `scripts\u002Fdoc_synchronizer.py` with four deterministic subcommands:\n\n1. **`audit`**:\n   - Analyzes Python modules against Markdown docs.\n   - Flags files with missing docstrings or missing dedicated documentation.\n   - Calculates overall coverage percentage against `--min-coverage` threshold.\n2. **`drift-check`**:\n   - Strips code blocks to eliminate false positives per Rule 47.\n   - Verifies relative markdown links against active filesystem files.\n3. **`scaffold`**:\n   - Ingests a module via AST.\n   - Pre-populates clean Diátaxis documentation templates (`api`, `readme`, `howto`).\n4. **`visual-brief`**:\n   - Generates a self-contained HTML file rendering a dark-mode Mermaid diagram showing documented vs. deficit modules.\n\n---\n\n## Workflow: 4-Stage Execution Loop\n\n### Stage 1: Documentation Coverage Audit\n1. Execute the `audit` subcommand across target modules or plugins.\n2. Inspect the generated JSON coverage scorecard to identify undocumented public classes, methods, and modules.\n\n### Stage 2: Drift & Integrity Inspection\n1. Execute `drift-check` across documentation directories (`docs\u002F`, `plugins\u002F`).\n2. Identify broken relative links or stale symbol names resulting from code refactoring.\n\n### Stage 3: Visual Brief & Mandatory Checkpoint\n1. Render an interactive HTML visual brief using `visual-brief`.\n2. Present findings and planned additions to the user via `implementation_plan.md` with explicit Mandatory Checkpoint review gates (`RequestFeedback: true`).\n3. Halt and await explicit user approval before writing or updating documentation files.\n\n### Stage 4: Synthesis, Scaffolding & Verification\n1. **Package-Level Diátaxis Scaffolding**: Prioritize authoring package-level `README.md` guides for core packages (`src\u002Fharness\u002Fcommands\u002F`, `src\u002Fharness\u002Fbridges\u002F`) and plugins (`plugins\u002F\u003Ccategory>\u002F\u003Cplugin>\u002F`). A package `README.md` elevates all sibling modules by providing live AST symbol tables and manifest metadata without generating file sprawl.\n2. Scaffold missing documentation using `scaffold` with appropriate Diátaxis quadrant templates.\n3. Update existing documentation files to repair broken links and update function signatures.\n4. Re-run `drift-check` and `audit` to verify 100% resolution of coverage deficits.\n\n---\n\n## Anti-Patterns\n\n- **Premature File Mutation** — Modifying existing documentation or creating new files without first auditing AST symbols and presenting an implementation plan.\n- **Ungrounded Prose** — Writing speculative narrative text instead of deriving class and function documentation directly from active AST syntax trees.\n- **Broken Relative Links** — Writing workspace-absolute `file:\u002F\u002F\u002F` URIs or unverified links that break in sandboxes or CI environments.\n- **Monolithic Conflation** — Combining tutorials, architecture rationale, and reference tables on a single page instead of adhering to Diátaxis quadrants.\n",{"name":5,"description":7},"main","eff3b00e36d1d233ad4a4389605c82fbfa0326d3",".agents\u002Fskills\u002Frepo-doc-synchronizer","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness","https:\u002F\u002Fgithub.com\u002FSpectreDeath","I'm here to manage stress so I wouldn't expect earth shattering break throughs I'm just an enthusiast that likes making stuff. ","2026-11-15 05:32:58",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add SpectreDeath\u002FBrain-Harness --skill repo-doc-synchronizer",{"tool":37,"command":38},"bunx","bunx skills add SpectreDeath\u002FBrain-Harness --skill repo-doc-synchronizer",{"tool":40,"command":41},"pnpm","pnpm dlx skills add SpectreDeath\u002FBrain-Harness --skill repo-doc-synchronizer","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002FSKILL.md",true,[45,51,55,61,65,71,75],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"CARD.md","REFERENCE","参考文档",4469,"https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002FCARD.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"config.default.yaml",691,"https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fconfig.default.yaml",{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"scripts\u002Fdoc_ast_inspector.py","SCRIPT","脚本",6446,"https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_ast_inspector.py",{"path":62,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":63,"sourceHtmlUrl":64},"scripts\u002Fdoc_synchronizer.py",39739,"https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002Fscripts\u002Fdoc_synchronizer.py",{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},"templates\u002Fapi_reference.md.template","OTHER","其他",451,"https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002Ftemplates\u002Fapi_reference.md.template",{"path":72,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":73,"sourceHtmlUrl":74},"templates\u002Fhowto_guide.md.template",465,"https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002Ftemplates\u002Fhowto_guide.md.template",{"path":76,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":77,"sourceHtmlUrl":78},"templates\u002Fpackage_readme.md.template",379,"https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frepo-doc-synchronizer\u002Ftemplates\u002Fpackage_readme.md.template",[80,87,94,101,108,115],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7E0W6FR68J2N9CXCZTAQJFX","ui-behavior-primitive-architect","Architect, audit, and verify zero-dependency headless UI behavior primitives, WebMCP agent bridges, WAI-ARIA\u002FSSR\u002FRTL tri-modal checks, and framework expert routing. Do not use for static CSS theme styling or backend database migrations.","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fui-behavior-primitive-architect\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7E0VZ7JQNW34G271DENFGYP","trustgraph-ontology-governor","Govern knowledge graphs, SHACL-AF triple policies, OntologyRAG subclass validation, PROV-O dual named graphs, and Laya entropy decision scoring. Do not use for relational SQL queries or generic web scraping.","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Ftrustgraph-ontology-governor\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7E0VQ6Z7R45Q8QAZ4MT39EK","shim-harness-governor","Govern universal CLI agent loops, 4-tier tool permissions, ancestor-symlink workspace sandboxes, deterministic-first command routing, collision-safe MCP namespacing, and layered skill loading. Do not use for static UI styling or external SQL analytics.","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fshim-harness-governor\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M7E0VC18NMP1QBSRJ3TPQ7MB","graphiti-zep-memory-governor","Govern bi-temporal knowledge graphs with Graphiti future-edge clamping, MinHash\u002FLSH entity dedup, RRF\u002FMMR reranking, and Zep typed ontologies. Do not use for static SQL joins or generic web crawling.","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fgraphiti-zep-memory-governor\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M7E0V12ABE1RW3ZRCST8VH5Z","agora-mcp-workbench-architect","Architect, audit, and orchestrate Agora Workbench MCP servers, loopback sidecars, unified state graphs, gateway\u002Fdispatcher connectors, and policy-enforced data lakes. Do not use for static frontend CSS styling or non-MCP desktop GUI automation.","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fagora-mcp-workbench-architect\u002FSKILL.md",[],[],{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":19},"01M7BFYG6QT3484VC57TZ19V7P","skill-eval-assurance-runner","Evaluate and assure agent skills using small-N Wilson confidence intervals, unbiased pass^k reliability, deterministic trajectory graders, preflight boundary honesty, and sealed digest verification. Do not use for subjective prose review or unconstrained production deployment.","https:\u002F\u002Fgithub.com\u002FSpectreDeath\u002FBrain-Harness\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fskill-eval-assurance-runner\u002FSKILL.md",[],[]]