docs-sync

To audit documentation coverage, the Skill compares features exposed in your repository code against your docs to identify gaps and inconsistencies. It produces a structured report with evidence like file paths and symbols, plus suggested edits for approval.

Finding documentation gaps between a branch and main is handled by analyzing the current branch against main, or the diff versus main if not on main. This surfaces inconsistencies in feature alignment, accuracy, and overall documentation coverage.

You can generate targeted documentation updates for English docs located under docs/src/content/docs/**. The Skill proposes structure changes and specific edits based on code analysis, providing file paths and symbols to support the suggested improvements.

Docs-sync works with repositories like openai-agents-js to inventory features exposed in code and compare them to existing documentation. It ensures English documentation accurately reflects the main features and codebase logic.

To enforce a doc-first workflow during code review, the Skill generates a change plan with evidence from file paths and symbols. This guides reviewers through both code and documentation improvements before final approvals.