Codex Is All You Need
中文 | English
Codex Is All You Need is a public-safe V2 Codex plugin-first preset system.
It is not a private machine dump. It distills a real local production setup
into a reusable source catalog, installable plugin package, sanitized examples,
management scripts, and a read-only dashboard.
In one line:
source catalog -> plugin package -> marketplace install
Use this repository to:
- Install Codex Next as a plugin that bundles the public skills into one reusable workflow pack.
- Copy public-safe examples to build your own local agent / skill catalog.
- Learn how to design Codex agents and skills around a plugin-first workflow.
- Migrate or inspect old V1 suite/composition setups when needed.
Who This Is For
- Developers who want to turn repeated workflows into Codex skills.
- Teams or individuals who want custom agents for different work domains.
- Users migrating Claude Code-style agent / skill patterns into Codex.
- People who want plugin-first shared skills, with V1 suite docs only for migration or local experiments.
- People who want to publish structure and examples without leaking private prompts, paths, templates, or machine state.
What This Is Not
- It is not an official OpenAI directory standard.
- It is not a one-command installer for a complete production setup.
- It is not a mirror of a private
~/.codex home or private business skills.
- It does not make a parent
.codex automatically inherited by every child git repository. Codex repo-level discovery is bounded by the current project root. See Architecture and Discovery Boundaries.
Repository Layout
dashboard/
build_dashboard.py # read-only dashboard generator
templates/index.html
examples/config.example.toml
scripts/
sync_codex_entrypoints.py # batch sync repo-local .codex entrypoints
docs/
usage-guide.md # full bilingual usage guide
architecture.md # V2 plugin-first architecture
agent-design.md # custom agent design
skill-design.md # skill design
agent-skill-map.md # agent and skill responsibility map
discovery-boundaries.md # sanitized discovery boundary conclusions
user-global-agents-example.md # public-safe user-level AGENTS.md example
model-catalog-override.md # custom Codex model catalog override guide
global-git-ignore.md # user-level Git ignore profile
v1/ # legacy suite/composition docs and migration notes
architecture-first-sdlc-flow.md
claude-to-codex-migration.md
public-private-strategy.md
plugins/
codex-next/ # installable skills plugin
examples/
catalog/ # sanitized public agent / skill source catalog
runtime/ # runtime AGENTS.md example
suites/ # V1 suite fixture pointer
Current V2 Model
source catalog
Stores real agent TOML files and skill folders.
Example: examples/catalog/dev/agents/dev_python_engineer.toml
examples/catalog/dev/skills/dev-python-quality/SKILL.md
plugin package
Production distribution surface for public-safe shared skills.
Example: plugins/codex-next/skills/dev-python-quality/SKILL.md
.agents/plugins/marketplace.json
marketplace install
User-facing installation path for the plugin package.
Example: codex plugin add codex-next@codex-is-all-you-need
V1 suite/composition docs are kept only for migration and compatibility. Start
there only if a machine still exposes shared skills through ~/.codex/suites
or repo-local .codex/skills links: docs/v1/.
For the full V2 explanation, read docs/usage-guide.md
and docs/architecture.md.
3-Minute Quick Start
1. Inspect the public catalog
find examples/catalog -maxdepth 3 \( -path '*/agents/*.toml' -o -path '*/skills/*/SKILL.md' \)
Public examples include:
| Pack | Agents | Skills | Use Case |
|---|
common | 6 | 2 | Planning, orchestration, docs verification, quality review, context summaries, file organization |
sdlc-manager | 7 | 21 | Architecture-first SDLC control: BRD/URS/PRD, SRS/NFR, HLD/LLD, ADR, domain boundaries, SPEC, handoff |
dev | 14 | 20 | Code mapping, implementation, tests, reviews, APIs, CLI, frontend, Python, security, performance |
data | 5 | 4 | Data profiling, SQL, cleaning, pipelines, analysis reports |
office | 5 | 5 | Meeting minutes, weekly reports, project reports, briefing notes, deck outlines |
research | 4 | 3 | Material processing, evidence tables, deduplication, synthesis, gap review |
See docs/agent-skill-map.md for the full responsibility map.
2. Install Codex Next
