openai-agents-python: Skill for Codex

.agents/skills/docs-sync/SKILL.md

docs-sync is a skill for Codex from openai/openai-agents-python. It costs 15 tokens per session (1,048 once invoked), scanned A, original, MIT.

A documentation audit that compares a project's main-branch code and configuration with the English files in docs/. It looks for missing, incorrect, or outdated explanations of user-facing behavior.

In plain words
What is it for?
Use it to audit documentation coverage, identify gaps, and propose targeted updates or a clearer documentation structure. It does not update translated documentation.
Why use it?
It helps keep documentation aligned with the code as features, settings, commands, and defaults change.

Skill for Codex ✓ vendor

Written for Codex: agents/openai.yaml present. Also seen: installed under .agents/ (shared by several agents); mentions AGENTS.md; $skill-name invocation.

This is openai/openai-agents-python's own configuration. It tells Codex how to work on openai-agents-python itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything openai-agents-python configures →

About the project

OpenAI Agents SDK is a Python framework for building workflows in which multiple AI agents use tools, delegate tasks, follow safety checks, and involve people when needed. Developers use it to create and monitor agent, sandbox, realtime, and voice applications.

openai/openai-agents-python · 30,339 stars · on GitHub · openai.github.io

Reuse

Borrowing it

Nothing to install: this file belongs to openai/openai-agents-python. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/openai/openai-agents-python/main/.agents/skills/docs-sync/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/openai/openai-agents-python

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for docs-sync

README.md
[![agentmods](https://agentmods.dev/badge/skills/openai/openai-agents-python/docs-sync/github.svg)](https://agentmods.dev/skills/openai/openai-agents-python/docs-sync)
Your own site
<a href="https://agentmods.dev/skills/openai/openai-agents-python/docs-sync"><img src="https://agentmods.dev/badge/skills/openai/openai-agents-python/docs-sync/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for docs-sync

Your own site · 80×15
<a href="https://agentmods.dev/skills/openai/openai-agents-python/docs-sync"><img src="https://agentmods.dev/badge/skills/openai/openai-agents-python/docs-sync.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 15 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,048 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Snyk pass 7 Sept 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00015 $0.01048
Opus 5.5 $0.00006 $0.00419
Sonnet 5.5 $0.00003 $0.00210
Haiku 4.5 $0.00002 $0.00105

Measured 1mo ago against content hash e5989e548a13, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

docs-sync scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/docs-sync/SKILL.md · 82 lines

How it starts

The opening of the file, as written. The whole thing — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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/.

Workflow

  1. 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.
    • Use a branch diff only for a branch-scoped request. A requested topic or released-doc correction remains in scope even when it is unrelated to the current branch diff.
    • Avoid switching branches if it would disrupt local changes. Prefer read-only inspection such as git show main:<path>. If a separate checkout is genuinely required, stop and obtain the explicit approval required by AGENTS.md before creating or switching a worktree.
  2. Build a feature inventory from the selected scope

    • Bound the inventory to the requested topic or diff. Inventory the full surface only for an explicitly comprehensive audit.
    • For branch-scoped work, inspect feature additions, changes, and removals relative to the intended base.
    • Focus on user-facing behavior: public exports, configuration options, environment variables, CLI commands, default values, and documented runtime behaviors.
    • Capture evidence for each item (file path + symbol/setting).
    • Use targeted search to find option types and feature flags (for example: rg "Settings", rg "Config", rg "os.environ", rg "OPENAI_").
    • When the topic involves OpenAI platform features, invoke $openai-knowledge to pull current details from the OpenAI Developer Docs MCP server instead of guessing, while treating the SDK source code as the source of truth when discrepancies appear.

Read the full file on GitHub · 82 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +4 lines · -64 tokens per session e5989e548a13
  2. 1mo ago First seen · 78 lines · 79 tokens per session scan A 5c50f9853843

Subscribe to this mod's changes

docs-sync is a skill published in the GitHub repository openai/openai-agents-python (30,339 stars, last pushed today), licensed MIT. It adds 15 tokens to every session and 1,048 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

mem0-test-integration

Verify a Mem0 integration produced by /mem0-integrate. Runs in the same workspace on the same branch (loose coupling) — installs dependencies, runs the repo's native test suite, then exercises a real end-to-end smoke flow against the user's API key. Produces a scorecard. TRIGGER when: user has just run /mem0-integrate…

mem0ai/mem0 · 207 tokens

mem0-integrate

Integrate Mem0 into an existing repository using a goal-driven, TDD pipeline. Detects the repo's language automatically and asks the user to pick between Mem0 Platform (managed) and Mem0 Open Source (self-hosted). Writes failing tests before any implementation. Produces a local feature branch plus .mem0-integration/…

mem0ai/mem0 · 188 tokens

jamjet-durability-patterns

Production durability patterns for AI agents on the JVM — crash recovery, audit trails, human-in-the-loop, and replay testing using JamJet runtime.

jamjet-labs/jamjet · 36 tokens

publish-npm-package

Configure or troubleshoot npm package publication with GitHub Actions and npm Trusted Publishing. Use this skill for JavaScript or TypeScript packages. Also use it for the npm package in a mixed-language repository. Do not use it for applications or repositories without an npm package. Do not use it for generic CI…

btfranklin/skills · 77 tokens

django-pytest-performance-suite

Build Django performance regression tests with pytest-benchmark. Use for ORM, views, schema, transactions, or database backend behavior. Match the production database engine and topology. Do not use for one-time profiling, browser rendering, application performance monitoring, or non-Django services.

btfranklin/skills · 61 tokens

publish-python-package-pypi

Configure or troubleshoot PyPI publication for PDM packages with GitHub Actions and Trusted Publishing. Use this skill for the Python package in a mixed-language repository. Do not use it for applications or repositories without a Python distribution. Do not use it for generic CI, containers, or token uploads unless…

btfranklin/skills · 71 tokens