Docs Sync

Audits your codebase against your English docs to find missing features, outdated config examples, and incorrect defaults. It compares what's in your main branch (public APIs, env vars, CLI flags, agent implementations) with what's actually documented, then gives you a detailed report of gaps and proposes specific edits. Smart enough to scope itself to just your branch diff if you're not on main, and it won't touch translated docs. The workflow is thorough but requires approval before making changes, which is the right call since documentation structure is never one size fits all. Most useful when you've shipped features faster than you've updated the docs and need to close the gap systematically.

skills.sh installs: 231
GitHub stars: 30.6K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add openai/openai-agents-python --skill docs-sync --agent claude-code

Installs into .claude/skills of the current project.

Files

Docs Sync

Overview

Identify doc coverage gaps and inaccuracies by comparing main branch features and configuration options against the current docs structure, then propose targeted improvements.

Authorization and scope

For an audit or proposal-only request, report findings without editing. When the user requests updates or has already approved a plan, complete those local edits and applicable checks without asking again. Ask only about unresolved scope, behavior, release timing, or additional authority. Keep generated translations untouched. Apply the repository's Documentation Release Timing policy before including unreleased behavior in docs/.