plan
Lightweight planning with optional interview
How do I install this agent skill?
npx skills add https://github.com/yeachan-heo/oh-my-codex --skill planIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill 'plan' is a set of instructions for an AI agent to manage planning workflows, including requirement gathering and plan generation. It does not contain any malicious code, external network requests, or security vulnerabilities.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
<Use_When>
- Planning before implementation — "plan this", "let's plan"
- Requirements are vague and need scoping — use
--interview - Reviewing an existing plan —
--review</Use_When>
<Do_Not_Use_When>
- Want direct execution — execute the scoped task directly; use
ultragoalonly for durable goals orteamfor coordinated parallel work - Simple focused fix with obvious scope — skip planning </Do_Not_Use_When>
<Execution_Policy>
- Auto-detect interview vs direct;
--interviewforces Socratic mode,--directskips it - Ask one question at a time; gather codebase facts first
omx exploreis deprecated. Use normal repository inspection for codebase facts;omx sparkshellonly for explicit shell-native evidence- Plans must be evidence-backed: 80%+ claims cite file/line, 90%+ criteria testable
- Right-size steps to scope; save to
.omx/plans/</Execution_Policy>
Mode Selection
| Mode | Trigger | Behavior |
|---|---|---|
| Interview | --interview or broad request | Socratic requirements gathering |
| Direct | --direct or detailed request | Generate plan immediately |
| Review | --review | Critic evaluation of existing plan |
Interview (--interview)
- Classify the request and gather discoverable codebase facts before asking a question
- Ask one focused question for the remaining intent/preference gap through the available question surface below
- Build on answers; consult Analyst for hidden requirements
- Create plan when user signals readiness
Direct
- Quick analysis (optional Analyst)
- Generate plan immediately
- Optional Critic review if requested
Review (--review)
- Read plan from
.omx/plans/ - Evaluate via Critic; verdict APPROVED/REVISE/REJECT
- Use a separate Critic reviewer when the current lane authored the plan; if independent review is unavailable, report that gap without claiming approval
Output
Every plan includes: Requirements Summary, Acceptance Criteria (testable), Implementation Steps (with file refs, adaptive count), Risks/Mitigations, Verification. Saved to .omx/plans/.
Outcome-first framing: apply outcome-first framing, concise visible updates for multi-step planning. Local overrides for the active workflow branch apply via newer user task updates. If the user says continue, continue the current branch instead of restarting.
<Tool_Usage>
omx exploreis deprecated. Use normal repository inspection;omx sparkshellonly for explicit shell-native evidence- In attached OMX tmux, use
omx questionwithOMX_QUESTION_RETURN_PANEset to the current pane. Outside tmux, use native structured input when available; otherwise ask one concise plain-text question and wait for the answer - Use only the host's exposed native subagent tools with the installed
planner/analyst/criticroles when the selected planning step needs them; report an unavailable required reviewer instead of inventing a tool </Tool_Usage>
<Escalation_And_Stop_Conditions>
- Stop interviewing when requirements are clear — do not over-interview
- Escalate on irreconcilable trade-offs requiring business decision
- "just do it" / "skip planning" → continue the authorized scoped task through direct execution; use
$ultragoalonly when explicitly requested or required for durable goals, preserving any active workflow's gates </Escalation_And_Stop_Conditions>
<Final_Checklist>
- Acceptance criteria testable (90%+ concrete)
- Claims cite file/line (80%+)
- Risks have mitigations, no vague terms
- Plan saved to
.omx/plans/</Final_Checklist>
Review Quality Criteria
| Criterion | Standard |
|---|---|
| Clarity | 80%+ claims cite file/line |
| Testability | 90%+ criteria concrete |
| Verification | File refs exist |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/yeachan-heo/oh-my-codex/plan">View plan on skillZs</a>