ReddRadar
Agent skill
codex-explain
Explain complex code via Codex MCP. Use when: understanding complex logic, tracing data flow, onboarding to unfamiliar code. Not for: code review (use codex-code-review), exploration (use code-explore). Output: structured explanation at chosen depth.
Install this agent skill to your Project
npx add-skill https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/codex-explain
SKILL.md
Codex Explain Skill
Trigger
- Keywords: explain code, what does this do, how does this work, code walkthrough
When NOT to Use
- Code review (use
codex-code-review) - Bug investigation (use
bug-fixorissue-analyze) - Architecture overview (use
code-explore)
Workflow
Read target → [Collect context] → Codex explain → Output explanation
Step 1: Read Target File
Read file content. If --lines specified, extract only that range.
Step 2: Codex Explanation
Use mcp__codex__codex with explanation prompt. See references/codex-prompt-explain.md.
Config: sandbox: 'read-only', approval-policy: 'never'
Depth Levels
| Level | Description |
|---|---|
| brief | One-sentence summary |
| normal | Functional overview + execution flow + key concepts (default) |
| deep | + Design patterns + complexity + issues + dependencies |
Output
## Code Explanation: <target>
- **Depth**: brief / normal / deep
- **Summary**: <functional overview>
- **Execution flow**: <key paths>
- **Key concepts**: <patterns, abstractions>
Verification
- Codex independently researched project context (imports, callers)
- Explanation matches requested depth level
- Key concepts are identified and explained
References
- Explanation prompt:
references/codex-prompt-explain.md
Examples
Input: /codex-explain src/service/order/order.service.ts
Action: Read file → Codex explain (normal) → Functional summary + detailed explanation
Input: /codex-explain src/service/xxx.ts --depth deep
Action: Read file → Codex explain (deep) → Patterns + complexity + issues
Input: /codex-explain src/xxx.ts --lines 50-100
Action: Read lines 50-100 → Codex explain → Focused explanation
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
sd0xdev/sd0x-dev-flow
runbook
Generate and update feature release runbooks from existing docs and codebase. Use when: creating operational runbook, release handbook, deployment checklist, pre-release preparation. Not for: incident response (v2), code review (use codex-code-review), architecture design (use architecture).
sd0xdev/sd0x-dev-flow
ask
Context-aware Q&A with auto context gathering. Use when: user has a quick question about codebase, git history, rules, docs, or skills during development. Not for: code changes (use feature-dev), code review (use codex-review-fast), deep research (use deep-research), full code trace (use code-explore). Output: structured answer with source attribution.
sd0xdev/sd0x-dev-flow
project-brief
Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.
sd0xdev/sd0x-dev-flow
codex-test-gen
Generate unit tests for specified functions using Codex MCP
sd0xdev/sd0x-dev-flow
bug-fix
Bug fix workflow. Use when: fixing bugs, resolving issues, regression fixes. Not for: new features (use feature-dev), understanding code (use code-explore). Output: fix + regression test + review gate.
sd0xdev/sd0x-dev-flow
skill-health-check
Validate skill quality against routing, progressive loading, and verification criteria. Use when: auditing skills, checking skill health, reviewing skill design. Not for: code review (use codex-code-review) or doc review (use doc-review). Output: health report with per-skill ratings + Gate.
Didn't find tool you were looking for?