Understand an unfamiliar repository
Find entry points, project boundaries, conventions, dependencies, tests, generated code, configuration, and the files that actually control the requested behavior.
Codex Skills for Coding give Codex a dependable process for understanding a codebase, planning changes, writing code that matches local conventions, debugging failures, adding tests, and verifying the result. Download the skills to make feature work, bug fixes, refactoring, and maintenance more consistent.
task: add export feature
inspect:
- project structure
- existing patterns
- test commands
verify: behavior + tests + diffCoding tasks often fail because the implementation starts before the repository is understood. Existing abstractions, naming, tests, error patterns, platform constraints, and generated files all affect what a correct change looks like.
These skills teach Codex to inspect first, make a focused plan, edit the smallest useful surface, test realistic behavior, and explain anything that remains uncertain.
Find entry points, project boundaries, conventions, dependencies, tests, generated code, configuration, and the files that actually control the requested behavior.
Turn requirements into small edits that reuse existing patterns, preserve public behavior, handle errors, and avoid unrelated rewrites.
Reproduce the failure, trace inputs and state, test competing explanations, identify the root cause, and add a regression check.
Run relevant tests and builds, inspect the final diff, check edge cases, remove temporary work, and report the outcome clearly.
The workflow scales from a one-line correction to a feature spanning several modules while keeping scope and evidence visible.
Identify the user-visible outcome, inputs, edge cases, compatibility limits, acceptance criteria, and what must remain unchanged.
Trace the current implementation, tests, types, configuration, call sites, data flow, and conventions before selecting an approach.
Update code and tests together, preserve established patterns, handle failure states, and avoid speculative abstractions.
Use targeted tests first, then wider validation in proportion to risk. Confirm every changed line belongs to the task.
The skills work from the repository's language, tooling, and conventions, whether the project is new or mature.
Build features, workflows, state transitions, validation, persistence, and user-facing behavior.
Design stable APIs, preserve compatibility, add types and tests, update documentation, and prepare releases.
Create command-line utilities, scripts, generators, migrations, scheduled jobs, and developer tooling.
Fix bugs, update dependencies, remove dead code, improve reliability, and simplify difficult areas safely.
The process adapts its depth to the size and risk of the requested change.
These skills help anyone who wants Codex to work like a careful contributor inside an existing repository.
Delegate contained implementation, debugging, tests, refactoring, and documentation while keeping the work reviewable.
Use an ordered process that explains the code path, decisions, errors, and verification instead of returning unexplained code.
Apply shared expectations for scope, conventions, tests, security, and handoff across different repositories.
Move faster on product code without losing track of regressions, unfinished edge cases, or repository cleanliness.
The skills improve coding discipline, but generated changes still require review. Production, safety-critical, security-sensitive, financial, and privacy-related software need testing and approval appropriate to their risk.
Install the skills in the repository for local conventions or at user level for a general coding process.
Keep SKILL.md with included checklists, debugging guidance, testing rules, and supporting files.
Use project scope when instructions should travel with one repository, or personal scope for habits you want everywhere.
Add architecture notes, formatting rules, generated-file warnings, platform support, security constraints, and preferred patterns.
List approved setup, build, test, lint, type-check, format, and local-run commands with any required environment notes.
State the desired behavior, examples, edge cases, files or areas in scope, and the checks that must pass.
Answers about languages, existing projects, tests, debugging, and reviewing generated changes.
They can guide work in languages and toolchains Codex can inspect and run in your environment. Project-specific instructions make the result more reliable.
Yes. The workflow is designed to inspect current structure and conventions before editing, then keep changes focused and compatible.
The skills direct Codex to add or update tests when behavior changes and to run relevant existing checks. The exact test strategy follows the project and risk.
An error message is a useful starting point. The workflow also seeks a reproduction, traces the relevant path, tests the suspected cause, and verifies a regression fix.
Yes. Review the diff and test important behavior. The skills make the reasoning and verification clearer, but responsibility for merging and releasing remains with the project owner.
Read first. Change deliberately. Test real behavior. Hand off cleanly.