CodexAI Skill Pack
Production-ready instruction framework for Codex - deterministic workflows, deliberate reasoning, domain routing, strict quality gates, and persistent project memory.
Overview
CodexAI Skill Pack turns Codex from an ad-hoc code assistant into a structured engineering partner.
Instead of relying on prompt luck, the pack enforces a repeatable flow:
Intent -> Spec -> Plan -> Route -> Implement -> Verify -> Persist -> Commit
The pack is designed for 3 outcomes:
- less generic output
- stronger workflow discipline
- deliverables that read more like accountable human engineering work
Current Stats
| Metric | Value |
|---|
| Core Skills | 28 |
| Entry-point Scripts | 69 |
| Shared Helpers | 2 |
| Reference Docs | 188+ |
| Starter Templates | 29 |
| Artifact Templates | 9 |
| Agent Personas | 8 |
| Workflow Aliases | 8 |
| Verification | 341 unit + 71 smoke = 412 tests |
| Codex Native Plugin | .codex-plugin/plugin.json + .agents/plugins/marketplace.json |
| Claude Code Plugin | .claude-plugin/plugin.json + hooks/hooks.json |
| GitHub Automation | GitHub CLI (gh) + gh auth login for PR/release workflows |
| CI/CD | .github/workflows/ci.yml + .github/workflows/release.yml |
Why This Pack Is Different
| Weakness in default AI workflows | What this pack adds |
|---|
| Vague task interpretation | codex-intent-context-analyzer locks goal, scope, and ambiguity before code |
| Plans that sound good but do not guide execution | codex-plan-writer creates verifiable, dependency-aware task breakdowns |
| Design output drifts between sessions | codex-design-system plus codex-design-md turn design intent into reusable vocabulary and a lintable DESIGN.md contract |
| Generic output with no proof | codex-reasoning-rigor plus output_guard.py force evidence-backed deliverables |
| AI-safe writing that still feels synthetic | editorial_review.py scores tone, decision clarity, tradeoffs, and scanability |
| Documents that make readers infer too much | codex-document-writer forces purpose, audience, structure, complete sentences, and reliability wording |
| No final gate before declaring done | codex-execution-quality-gate runs lint, tests, security, output quality, editorial quality, UX, and trend tracking |
| Context lost between sessions | codex-role-docs preserves role-scoped project docs, while codex-project-memory stores decisions, summaries, genome, handoffs, and changelog inputs |
| Tacit knowledge stays invisible | build_knowledge_index.py turns genome, role docs, decisions, commits, and configs into .codex/knowledge/INDEX.md |
| Fullstack prototypes start from vague prompts | codex-spec-driven-development forces spec-first acceptance criteria before $plan and implementation |
| Scrum roles live only in people's heads | codex-scrum-subagents installs project .agent kits and native .codex/agents custom agents |
| Skills only work in one agent app | Dual Codex + Claude plugin metadata lets both agents load the same skills/<name>/SKILL.md contracts |
GitHub CLI Prerequisite
Pull request and release automation use GitHub CLI (gh). Install and authenticate once before using commit/PR helpers or wrapping this pack in a project CLI:
gh auth login
gh auth status
Use GitHub CLI credential storage locally, or GH_TOKEN / GITHUB_TOKEN in CI. Never commit tokens into plugin manifests, skill docs, generated artifacts, or source files.
CI/CD Baseline
The repository ships a senior baseline GitHub Actions setup:
ci.yml: plugin validators, pack health, tool contracts, prompt-router corpus, memory-at-scale (medium), Python 3.12–3.13 × Linux/Windows matrix, Python 3.11 on main, trust harness smoke, advisory security scan, and GitHub CLI contract checks.scale-nightly.yml: weekly large-tier memory scale gate (8000 synthetic files) with JSON report artifact.release.yml: optional manual ZIP build (workflow_dispatch only).
CI validates this plugin pack only. CI/CD scripts and plugin-tools.json are capabilities for your Project CLI to invoke locally against any project-root — not a production deploy pipeline for this repo.
Local pack check (optional, before sharing a ZIP):
python skills/.system/scripts/local_release_gate.py --format json
python skills/.system/scripts/local_release_gate.py --apply --format json
See skills/.system/references/deploy-promotion.md.
Public Pipeline
