Updated 3d ago
by shinpr
codex-workflows
Development workflows for Codex that keep technical rigor and edge-case handling from becoming product overengineering.
39 GitHub stars (39)
+1 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | 0 |
| Oct 3 | 0 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | 0 |
| Oct 7 | 0 |
| Oct 8 | 0 |
| Oct 9 | 0 |
| Oct 10 | 0 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | +1 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 30 skills (30 skills found in its SKILL.md files)
- 8 forks (8 forks)
- 3d ago last update (Last updated 3d ago)
Install
Skills CLI
npx skills add shinpr/codex-workflows
Asks which skills and agents to install. Just one: npx skills add shinpr/codex-workflows --skill ai-development-guide — add -g for every project.
Claude Code
git clone https://github.com/shinpr/codex-workflowscp -r "codex-workflows/.agents/skills/ai-development-guide" ~/.claude/skills/
Copies the ai-development-guide skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add shinpr/codex-workflows
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
ai-development-guide
Root-cause discipline, proportionate impact analysis, and implementation completeness assurance. Use when fixing bugs, reviewing code quality, refactoring, making technical decisions, or performing quality assurance.
.agents/skills/ai-development-guide/SKILL.md on GitHub (opens in a new tab) -
coding-rules
Repository-aware implementation rules for minimal design surface, contract safety, representative patterns, and verifiable changes. Use when implementing, refactoring, or reviewing code.
.agents/skills/coding-rules/SKILL.md on GitHub (opens in a new tab) -
documentation-criteria
Determines which PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires and where each document lives. Use when deciding documentation scope or creating or reviewing one of these artifacts.
.agents/skills/documentation-criteria/SKILL.md on GitHub (opens in a new tab) -
external-resource-context
Resolves and records one external evidence source required by a current design or verification decision. Use when repository and supplied evidence cannot determine that decision.
.agents/skills/external-resource-context/SKILL.md on GitHub (opens in a new tab) -
implementation-approach
Selects the smallest sufficient implementation strategy and verification boundary from current requirements and repository evidence.
.agents/skills/implementation-approach/SKILL.md on GitHub (opens in a new tab) -
integration-e2e-testing
Selects and specifies only integration/E2E tests whose observable boundary cannot be proven more cheaply.
.agents/skills/integration-e2e-testing/SKILL.md on GitHub (opens in a new tab) -
llm-friendly-context
Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream agents can execute without guessing. Use when writing or revising LLM-facing prompts, handoffs, planning artifacts, reviews, reports, or generated instructions.
.agents/skills/llm-friendly-context/SKILL.md on GitHub (opens in a new tab) -
recipe-add-integration-tests
Add integration/E2E tests to existing codebase using Design Docs.
.agents/skills/recipe-add-integration-tests/SKILL.md on GitHub (opens in a new tab) -
recipe-build
Execute an approved backend Work Plan autonomously through task execution, quality fixes, commits, and final verification.
.agents/skills/recipe-build/SKILL.md on GitHub (opens in a new tab) -
recipe-design
Execute from codebase-scoped analysis to design document creation.
.agents/skills/recipe-design/SKILL.md on GitHub (opens in a new tab) -
recipe-diagnose
Investigate problem, verify findings, and derive solutions through structured diagnosis.
.agents/skills/recipe-diagnose/SKILL.md on GitHub (opens in a new tab) -
recipe-front-adjust
Adjust an implemented UI with focused evidence, verification, and quality checks.
.agents/skills/recipe-front-adjust/SKILL.md on GitHub (opens in a new tab) -
recipe-front-build
Execute an approved frontend Work Plan autonomously through frontend implementation, quality fixes, commits, and final verification.
.agents/skills/recipe-front-build/SKILL.md on GitHub (opens in a new tab) -
recipe-front-design
Execute from codebase-scoped analysis to frontend design document creation including UI Spec.
.agents/skills/recipe-front-design/SKILL.md on GitHub (opens in a new tab) -
recipe-front-plan
Create frontend work plan from design document with test skeleton generation.
.agents/skills/recipe-front-plan/SKILL.md on GitHub (opens in a new tab) -
recipe-front-review
Reviews completed frontend implementation for governing-source compliance, scope economy, repository quality, and security, and applies user-approved React corrections.
.agents/skills/recipe-front-review/SKILL.md on GitHub (opens in a new tab) -
recipe-fullstack-build
Execute an approved fullstack Work Plan autonomously with layer-aware task routing, quality fixes, commits, and final verification.
.agents/skills/recipe-fullstack-build/SKILL.md on GitHub (opens in a new tab) -
recipe-fullstack-implement
Run the full-cycle implementation workflow for one outcome spanning backend and frontend layers.
.agents/skills/recipe-fullstack-implement/SKILL.md on GitHub (opens in a new tab) -
recipe-implement
Orchestrate the complete implementation lifecycle from requirements through verified repository implementation.
.agents/skills/recipe-implement/SKILL.md on GitHub (opens in a new tab) -
recipe-plan
Creates a reviewed Work Plan with value-filtered integration/E2E test skeletons. Use when planning implementation from a Design Doc.
.agents/skills/recipe-plan/SKILL.md on GitHub (opens in a new tab) -
recipe-prepare-implementation
Prepare repository-local execution tools when the user requests setup or a concrete build capability is unavailable.
.agents/skills/recipe-prepare-implementation/SKILL.md on GitHub (opens in a new tab) -
recipe-quality-profile
Proposes and, after user confirmation, creates or maintains docs/project-context/quality.yaml from repository-specific review requirements. Use when asked to generate or update a repository quality profile.
.agents/skills/recipe-quality-profile/SKILL.md on GitHub (opens in a new tab) -
recipe-reverse-engineer
Generate PRD and Design Docs from existing codebase through discovery, generation, verification, and review.
.agents/skills/recipe-reverse-engineer/SKILL.md on GitHub (opens in a new tab) -
recipe-review
Reviews completed implementation for governing-source compliance, scope economy, repository quality, and security, and applies user-approved corrections.
.agents/skills/recipe-review/SKILL.md on GitHub (opens in a new tab) -
recipe-update-doc
Update existing design documents (Design Doc / PRD / ADR) with review and consistency verification.
.agents/skills/recipe-update-doc/SKILL.md on GitHub (opens in a new tab) -
requirement-convergence
Converges future-state requirements around outcome, exclusions, and rough cost. Use when users ask 'do we need this?', 'how far should we go?', or request a feature or scope change.
.agents/skills/requirement-convergence/SKILL.md on GitHub (opens in a new tab) -
reviewee-judgment
Evaluates received review results before they generate work by separating problems from proposed fixes and comparing responses in a fixed decision order. Use whenever review results may lead to artifact changes; does not produce reviews.
.agents/skills/reviewee-judgment/SKILL.md on GitHub (opens in a new tab) -
subagent-delegation
Sets delegation scope, completion waiting, and evidence-based intervention. Use when spawning, waiting for, or steering any subagent, including a single ad hoc agent or a custom workflow agent.
.agents/skills/subagent-delegation/SKILL.md on GitHub (opens in a new tab) -
subagents-orchestration-guide
Coordinates custom specialists through workflow phases, artifact handoffs, approval gates, and autonomous implementation. Use when executing a workflow recipe or routing its next specialist.
.agents/skills/subagents-orchestration-guide/SKILL.md on GitHub (opens in a new tab) -
testing
Repository-aware test execution rules for TDD, observable proof, and boundary selection. Use when writing, reviewing, or fixing tests.
.agents/skills/testing/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.