Claude-skill-registry codex-claude-cursor-loop
Orchestrates a triple-AI engineering loop where Claude plans, Codex validates logic and reviews code, and Cursor implements, with continuous feedback for optimal code quality
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/codex-claude-cursor-loop" ~/.claude/skills/majiayu000-claude-skill-registry-codex-claude-cursor-loop && rm -rf "$T"
manifest:
skills/data/codex-claude-cursor-loop/SKILL.mdsource content
Codex-Claude-Cursor Engineering Loop Skill
Core Workflow Philosophy
This skill implements a 3-way sequential validation engineering loop:
- Claude Code: Architecture and planning, final review
- Codex: Plan validation (logic/security), code review (bugs/performance)
- Cursor Agent: Code implementation and execution
- Sequential Validation: Claude plans → Codex validates → Cursor implements → Codex reviews → Claude final check → repeat
Phase 1: Planning with Claude Code
- Start by creating a detailed plan for the task
- Break down the implementation into clear steps
- Document assumptions and potential issues
- Output the plan in a structured format
Phase 2: Plan Validation with Codex
- Ask user (via
):AskUserQuestion- Model:
orgpt-5gpt-5-codex - Reasoning effort:
,low
, ormediumhigh
- Model:
- Send the plan to Codex for validation:
echo "Review this implementation plan and identify any issues: [Claude's plan here] Check for: - Logic errors - Missing edge cases - Architecture flaws - Security concerns" | codex exec -m <model> --config model_reasoning_effort="<effort>" --sandbox read-only
- Capture Codex's feedback and summarize to user
Phase 3: Plan Refinement Loop
If Codex finds issues in the plan:
- Summarize Codex's concerns to the user
- Refine the plan based on feedback
- Ask user (via
): "Should I revise the plan and re-validate, or proceed with implementation?"AskUserQuestion - Repeat Phase 2 if needed until plan is solid
Phase 4: Implementation with Cursor Agent
Once the plan is validated by Codex:
Session Management
-
Ask user (via
): "Do you want to start a new Cursor session or resume an existing one?"AskUserQuestion- New session: Start fresh
- Resume session: Continue previous work
-
If resuming:
# Note: cursor-agent ls requires interactive mode and may not work in --print mode # Alternative: Ask user for chat ID from their previous session # Or use: cursor-agent resume (resumes latest session without ID) # Store session ID for subsequent calls
- Ask user (via
): Which Cursor model to useAskUserQuestion- Available models:
,sonnet-4
,sonnet-4-thinking
,gpt-5
,gpt-4ocomposer-1 - Recommended:
for balanced performance,sonnet-4
for complex reasoningsonnet-4-thinking
- Available models:
Implementation
- Send the validated plan to Cursor Agent:
For new session:
cursor-agent --model "<model-name>" -p --force --output-format json --approve-mcps "Implement this plan: [Validated plan here] Please implement the code following these specifications exactly."
For resumed session (with chat ID):
cursor-agent --resume <chat-id> --model "<model-name>" -p --force --output-format json "Continue implementation: [Validated plan here]"
For resumed session (latest chat):
cursor-agent resume --model "<model-name>" -p --force --output-format json "Continue implementation: [Validated plan here]"
Useful options:
: Structured output for parsing (recommended for automation)--output-format json
: Auto-approve MCP servers (useful in headless mode)--approve-mcps
: Real-time progress monitoring (use with --output-format stream-json)--stream-partial-output
: Enable browser automation if needed--browser
- IMPORTANT: Store the session ID from the output for all subsequent Cursor calls
- Capture what was implemented and which files were modified
Phase 5: Codex Code Review
After Cursor implements:
- Send Cursor's implementation to Codex for code review:
echo "Review this implementation for: - Bugs and logic errors - Performance issues - Security vulnerabilities - Best practices violations - Code quality concerns Files modified: [list of files] Implementation summary: [what Cursor did]" | codex exec --sandbox read-only
- Capture Codex's code review feedback
- Summarize findings to user
Phase 6: Claude's Final Review
After Codex code review:
- Claude reads the implemented code using Read tool
- Claude analyzes both:
- Codex's review findings
- The actual implementation
- Claude provides final assessment:
- Verify if it matches the original plan
- Confirm Codex's findings are valid
- Identify any additional concerns
- Make final architectural decisions
- Summarize overall quality and readiness
Phase 7: Iterative Improvement Loop
If issues are found (by Codex or Claude):
- Claude creates a detailed fix plan based on:
- Codex's code review findings
- Claude's final review insights
- Send the fix plan to Cursor Agent using the same session:
# IMPORTANT: Use --resume with the stored session ID cursor-agent --resume <chat-id> --model "<model-name>" -p --force --output-format json "Fix these issues: [Detailed fix plan] Issues from Codex: [list] Issues from Claude: [list]" # Or resume latest session: cursor-agent resume --model "<model-name>" -p --force --output-format json "Fix these issues..."
- After Cursor fixes, repeat from Phase 5 (Codex code review)
- Continue the loop until all validations pass
- Note:
- Use same Codex model for consistency
- Always use the same Cursor session ID to maintain context
- Session maintains full history of changes
Recovery When Issues Are Found
When Codex finds plan issues (Phase 2):
- Claude analyzes Codex's concerns
- Refines the plan addressing all issues
- Re-submits to Codex for validation
- Repeats until Codex approves
When Codex finds code issues (Phase 5):
- Claude reviews Codex's findings
- Creates detailed fix plan
- Sends to Cursor for fixes
- After Cursor fixes, back to Codex review
- Repeats until Codex approves
When Claude finds issues (Phase 6):
- Claude creates comprehensive fix plan
- Sends to Cursor for implementation
- After fixes, Codex reviews again
- Claude does final check
- Repeats until Claude approves
Best Practices
- Always validate plans with Codex before implementation
- Never skip Codex code review after Cursor implements
- Never skip Claude's final review for architectural oversight
- Maintain clear handoff between all three AIs
- Document who did what for context
- Use same models throughout (same Codex model, same Cursor model)
- Session Management:
- Always use
with same session ID for iterative fixes--resume <chat-id> - Store session ID at the start and reuse throughout
- Use
to resume latest session (no ID needed)cursor-agent resume - Note:
requires interactive mode (may not work in scripts)cursor-agent ls - Only start new session when beginning completely new feature
- Always use
- Output Format:
- Use
for structured, parseable output--output-format json - Use
with--stream-partial-output
for real-time progressstream-json - Helps with error detection and progress monitoring
- Use
Command Reference
| Phase | Who | Command Pattern | Purpose |
|---|---|---|---|
| 1. Plan | Claude | TodoWrite, Read, analysis tools | Claude creates detailed plan |
| 2. Validate plan | Codex | | Codex validates logic/security |
| 3. Refine | Claude | Analyze Codex feedback, update plan | Claude fixes plan issues |
| 4. Session setup | Claude + User | Ask new/resume, ask for chat ID if resuming | Setup or resume Cursor session |
| 5. Implement | Cursor | New: <br> Resume: <br> Latest: | Cursor implements validated plan |
| 6. Review code | Codex | | Codex reviews for bugs/performance |
| 7. Final review | Claude | Read tool, analysis | Claude final architectural check |
| 8. Fix plan | Claude | Create detailed fix plan | Claude plans fixes from all feedback |
| 9. Apply fixes | Cursor | OR | Cursor implements fixes in same session |
| 10. Re-review | Codex + Claude | Repeat phases 6-7 | Validate fixes until perfect |
Advanced Cursor Agent Features
Available Command-Line Options
: Choose AI model (sonnet-4, sonnet-4-thinking, gpt-5, gpt-4o, composer-1)--model <model>
: Print mode for scripts (headless, non-interactive)-p, --print
: Auto-approve commands unless explicitly denied-f, --force
: Output format (text | json | stream-json)--output-format <format>
: Stream partial output as deltas (with stream-json)--stream-partial-output
: Auto-approve all MCP servers (headless mode only)--approve-mcps
: Enable browser automation support--browser
: Resume specific chat or latest if no ID provided--resume [chatId]
Session Management Commands
: Create new empty chat and return IDcursor-agent create-chat
: Resume latest chat session (no ID needed)cursor-agent resume
: Resume specific chat by IDcursor-agent --resume <chat-id>
: List sessions (requires interactive mode, not for scripts)cursor-agent ls
Model Recommendations
- sonnet-4: Best balance of speed and quality (recommended default)
- sonnet-4-thinking: Deep reasoning for complex architectural decisions
- gpt-5: Latest OpenAI model with strong coding capabilities
- gpt-4o: Fast responses, good for iterative fixes
- composer-1: Cursor's native composer model
Output Format Strategies
-
For automation/scripts:
--output-format json- Structured, parseable output
- Easy error detection
- Better for Claude to process results
-
For real-time monitoring:
--output-format stream-json --stream-partial-output- See progress as it happens
- Detect issues early
- Cancel if going wrong direction
-
For human review:
(default)--output-format text- Readable format
- Good for debugging
Error Handling
- Monitor Cursor Agent output for errors (easier with JSON output)
- Summarize Cursor's implementation results and Claude's review
- Ask for user direction via
if:AskUserQuestion- Significant architectural changes needed
- Multiple files will be affected
- Breaking changes are required
- When issues appear, Claude creates a detailed fix plan before sending to Cursor
- JSON parsing: When using
, parse the output to extract:--output-format json- Files modified
- Commands executed
- Error messages
- Session ID for resume
The Perfect Loop
1. Plan (Claude) ↓ 2. Validate Plan (Codex) → if issues → refine plan → repeat ↓ 3. Implement (Cursor) ↓ 4. Code Review (Codex) → captures bugs/performance issues ↓ 5. Final Review (Claude) → architectural check ↓ 6. Issues found? → Fix Plan (Claude) → Implement Fixes (Cursor) → back to step 4 ↓ 7. All passed? → Done! ✅
This creates a triple-validation, self-correcting, high-quality engineering system where:
- Claude: All planning, architecture, and final oversight
- Codex: All validation (plan logic + code quality)
- Cursor Agent: All implementation and coding