What is the 'docs-excellence-architect' subagent?

It is a specialized AI sub-task runner that performs focused reviews of documentation structure, style, and accuracy based on specific code diffs provided during the workflow.

How does it help with documentation maintenance overhead?

The skill identifies duplicate definitions, moves content to canonical locations, and ensures that updates cause minimal churn while strictly matching the project's existing writing style.

How does this skill ensure documentation stays accurate?

It identifies code changes—such as new CLI flags or API response shapes—and cross-checks them against existing docs, using a specialized subagent to verify all examples are runnable and consistent.

Can it handle multiple types of documentation files?

Yes, it is designed to manage and synchronize READMEs, user guides, API specifications, and operational troubleshooting documents simultaneously.

Project Documentation Architect

Name: Project Documentation Architect
Author: s-hiraoku

bys-hiraoku

0•

内容管理

Synchronizes codebase changes with technical documentation to ensure accuracy, consistency, and minimal maintenance churn.

This skill empowers developers to maintain high-quality project documentation by automating the alignment between code changes and written guides. It identifies user-facing behavior changes—such as new CLI flags, environment variables, or API updates—and utilizes a specialized 'docs-excellence-architect' subagent to perform rigorous consistency checks across READMEs, tutorials, and reference materials. By enforcing minimal churn and validating runnable examples, it ensures that your project's documentation remains reliable, professional, and perfectly in sync with the current state of the source code.

主要功能

01Specialized 'docs-excellence-architect' subagent for deep reviews

02Terminology standardization across READMEs, guides, and references

030 GitHub stars

04Validation of runnable code examples and API response shapes

05Automated doc-to-code synchronization and alignment

06Consistency checks for CLI flags, defaults, and environment variables

使用场景

01Updating READMEs and guides automatically after implementing new CLI features or API endpoints

02Consolidating duplicated definitions into canonical reference files to simplify long-term maintenance

03Reviewing existing documentation for outdated examples, private paths, or inconsistent terminology

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add s-hiraoku/synapse-a2a project-docs

For use in Claude.ai and ChatGPT

Download Skill