# docs-sync

> Claude/Codex skill by [@openai](https://omgskills.com/library/openai/index.md) · 29k stars · Updated 2026-08-31

Analyze main branch implementation and configuration to find missing, incorrect, or outdated documentation in docs/. Use when asked to audit doc coverage, sync docs with code, or propose doc updates/structure changes. Only update English docs under docs/\*\* and never touch translated docs under docs/ja, docs/ko, or docs/zh. Provide a report and ask for approval before editing docs.

Tags: agents, ai, framework, harness, llm, openai, python

## Install

```sh
git clone https://github.com/openai/openai-agents-python /tmp/openai-agents-python && ln -s /tmp/openai-agents-python/.agents/skills/docs-sync ~/.claude/skills/docs-sync
```

## From README

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. Workflow Confirm scope and base branch Identify the current branch and default branch (usually main). Prefer analyzing the current branch to keep work aligned with in-flight changes. If the current branch is not main, analyze only the diff vs main to scope doc updates. Avoid switching branches if it would disrupt local changes. Prefer read-only inspection such as git show main: . If a separate checkout is genuinely required, stop and obtain the explicit approval required by AGENTS.md before creating or switching a worktree. Build a feature inventory from the selected scope If on main: inventory the full surface area and review docs comprehensively. If not on main: inventory only changes vs main (feature additions/changes/removals).

## Links

- HTML page: https://omgskills.com/skills/openai/openai-agents-python/docs-sync/
- GitHub: https://github.com/openai/openai-agents-python
- Author: [@openai](https://omgskills.com/library/openai/index.md)

## More from this repo

- [code-change-verification](https://omgskills.com/skills/openai/openai-agents-python/code-change-verification/index.md) — Used to run the required final formatting, lint, type, and test checks after eligible SDK changes pass review.
   - [@openai](https://omgskills.com/library/openai/index.md) · 29k stars
- [credit-note-fixer](https://omgskills.com/skills/openai/openai-agents-python/credit-note-fixer/index.md) — Used to fix the tiny credit-note formatting bug and rerun the exact targeted test command.
   - [@openai](https://omgskills.com/library/openai/index.md) · 29k stars
- [csv-workbench](https://omgskills.com/skills/openai/openai-agents-python/csv-workbench/index.md) — Used to analyze CSV files in /mnt/data and return concise numeric summaries.
   - [@openai](https://omgskills.com/library/openai/index.md) · 29k stars