One search for your own team's files and the public ecosystem. See how real projects write their agent instructions, and bring the good ideas home.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
OpenAIAGENTS.mdopenai/codex/codex-rs/code-mode-host/AGENTS.md
Do not use timeouts or sleeps to synchronize tests. Wait for explicit signals or observable state; let the test runner enforce test-case timeouts.
Steady13 mentions in 2 weeks
No other project uses it yet
OpenAIAGENTS.mdopenai/codex/codex-rs/exec-server/src/sandbox_integrity/AGENTS.md
These checks currently emit telemetry only. Findings and preparation errors must not change sandbox construction, permissions, approvals, or command execution. Supported backends are Seatbelt, bubblewrap, and MXC; legacy Windows is out of scope. - Backends supply complete dependency inventories and interpret the request's original filesystem policy: resolve command temp directories and MXC volumes, and reuse the backend's deny-glob expansion where enforcement expands globs. - The runner prepares dependency facts and invokes each checker per dependency. Checkers remain independent of inventories…
Steady13 mentions in 2 weeks
No other project uses it yet
OpenAIReads credentialsSkillopenai/codex/codex-rs/skills/src/assets/samples/imagegen/SKILL.md
Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.
Surging13 mentions in 2 weeks
46 projects use a version of this
OpenAISkillopenai/codex/codex-rs/skills/src/assets/samples/openai-docs/SKILL.md
API first-timers, Codex/Work Q&A. If the user already has an OpenAI API integration, skip this skill for API questions and use the developer docs. Read this skill before answering how Codex or ChatGPT Work behaves, where to find a feature, or how to configure or troubleshoot this app or coding agent. This includes conversation history, model and cache behavior, instruction precedence, permissions, and tool availability. Use for API onboarding only when the user is connecting to the OpenAI API for the first time. Skip action requests, such as scheduling an automation, and tasks fully answered by supplied text or data.
Steady13 mentions in 2 weeks
31 projects use a version of this
OpenAISkillopenai/codex/codex-rs/skills/src/assets/samples/review-agent/SKILL.md
Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.
Steady13 mentions in 2 weeks
12 projects use a version of this
OpenAISkillopenai/codex/codex-rs/skills/src/assets/samples/skill-creator/SKILL.md
Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.
Steady13 mentions in 2 weeks
189 projects use a version of this
Often used withtaskflow-inbox-triagemermaid-diagram-generatorecosystem-reference
OpenAIReads credentialsSkillopenai/codex/codex-rs/skills/src/assets/samples/skill-installer/SKILL.md
Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).
Steady13 mentions in 2 weeks
46 projects use a version of this
OpenAIAGENTS.mdopenai/codex/codex-rs/tui/src/bottom_pane/AGENTS.md
When changing the paste-burst or chat-composer state machines in this folder, keep the docs in sync: - Update the relevant module docs (chat_composer.rs and/or paste_burst.rs) so they remain a readable, top-down explanation of the current behavior. - Keep implementations/docstrings aligned unless a divergence is intentional and documented. Practical check: - After edits, sanity-check that docs mention only APIs/behavior that exist in code (especially the Enter/newline paths and disable_paste_burst semantics).
Steady13 mentions in 2 weeks
No other project uses it yet
OpenAIReads credentialsAGENTS.mdopenai/openai-cookbook/AGENTS.md
The cookbook is organized around runnable examples and reference articles for OpenAI APIs. Place notebooks and Python scripts under examples/<topic>/, grouping related assets inside topic subfolders (for example, examples/agents_sdk/). Narrative guides and long-form docs live in articles/, and shared diagrams or screenshots belong in images/. Update registry.yaml whenever you add content so it appears on cookbook.openai.com, and add new author metadata in authors.yaml if you want custom attribution. Keep large datasets outside the repo; instead, document how to fetch them…
No other project uses it yet
OpenAIReads credentialsSkillopenai/openai-cookbook/.codex/skills/docs-editor/SKILL.md
Review and edit OpenAI Cookbook notebooks, Markdown, and MDX for technical accuracy, clarity, grammar, consistency, runnable examples, and repository publication requirements. Use for editorial reviews, pre-merge documentation checks, or notebook Markdown-cell sweeps in openai-cookbook.
No other project uses it yet
OpenAISkillopenai/openai-cookbook/examples/agents_api/apps/document_review/skills/expense-review-policy/SKILL.md
Review invoices and contracts against accounts-payable policy before human approval.
No other project uses it yet
OpenAIAGENTS.mdopenai/openai-cookbook/examples/agents_sdk/sandboxed-code-migration/migration_agent/AGENTS.md
You are migrating the mounted repo under repo/. - Migrate the repo according to repo/MIGRATION.md. - Preserve the public function signatures and behavior. - Run the baseline test command before editing. - Edit the app code and its tests. - Run the check command named in repo/MIGRATION.md after editing. - Run the final test command named in repo/MIGRATION.md after editing. - Return structured output that includes the exact commands, pass/fail summaries, changed files, a Markdown migration report, and the patch…
No other project uses it yet
OpenAISkillopenai/openai-cookbook/examples/evals/realtime_evals/skills/bootstrap-realtime-eval/SKILL.md
Bootstrap a new realtime eval folder inside this cookbook repo by choosing the right harness from examples/evals/realtime_evals, scaffolding prompt/tools/data files, generating a useful README, and validating it with smoke, full eval, and test runs. Use when a user wants to start a new crawl, walk, or run realtime eval in this repository.
No other project uses it yet
OpenAISkillopenai/codex-plugin-cc/plugins/codex/skills/codex-cli-runtime/SKILL.md
Internal helper contract for calling the codex-companion runtime from Claude Code
Steady3 mentions in 2 weeks
3 projects use a version of this
OpenAISkillopenai/codex-plugin-cc/plugins/codex/skills/codex-result-handling/SKILL.md
Internal guidance for presenting Codex helper output back to the user
Steady3 mentions in 2 weeks
2 projects use a version of this
OpenAISkillopenai/codex-plugin-cc/plugins/codex/skills/gpt-5-4-prompting/SKILL.md
Internal guidance for composing Codex and GPT-5.4 prompts for coding, review, diagnosis, and research tasks inside the Codex Claude Code plugin
Steady3 mentions in 2 weeks
2 projects use a version of this
OpenAIAGENTS.mdopenai/openai-python/AGENTS.md
Most SDK source is generated from the OpenAI API schema. Before editing, follow Modifying/Adding code to identify schema/generator/handwritten ownership. Keep handwritten policy, automation, tests, and examples small; alter exported APIs only when explicitly required. Read and apply contributor security requirements for credentials, synthetic fixtures, redaction, dependency provenance/hooks, pinned actions, CI isolation, and publishing. Follow SECURITY.md for private reporting; never disclose vulnerabilities in public issues, PRs, or logs. Read PYTHON_VERSION_POLICY.md for support, grace periods, release rules, and testing. pyproject.toml#requires-python owns the…
Steady5 mentions in 2 weeks
No other project uses it yet
OpenAIAGENTS.mdopenai/openai-agents-python/AGENTS.md
Skills live in .agents/skills/<name>/SKILL.md. Read the selected skill and only its relevant supporting references. These triggers authorize skill use, not additional Git or external actions. User instructions and approved scope take precedence over skill defaults.
OpenAIReads credentialsSkillopenai/openai-agents-python/.agents/skills/code-change-verification/SKILL.md
Run the required final formatting, lint, type, and test checks after eligible SDK changes pass review.
Surging2 mentions in 2 weeks
6 projects use a version of this
OpenAISkillopenai/openai-agents-python/.agents/skills/docs-sync/SKILL.md
Audit or update English SDK documentation against the requested implementation scope.
Cooling2 mentions in 2 weeks
46 projects use a version of this
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.
