| name | do |
| description | Execute a bounded ad-hoc engineering task such as a small fix, refactor, docs update, or example without the full run-plan process. |
Codex Runtime Rules
These Z Skills are native Codex workflows derived from github.com/zeveck/zskills at commit 14dea81da487b2904ea7d69a27295f1869206cdf. They are invoked by natural language or by naming the skill; examples that look like slash commands are only shorthand for the skill name.
Use Codex behavior first:
- Read the current repository before acting. Prefer existing project scripts, config, and conventions over the upstream examples.
- Never use Claude-only tools or assumptions: no
CronCreate, CronList, CronDelete, Agent/Task tool syntax, allowed-tools, .claude/settings.json, or automatic Claude hooks.
- Use sub-agents only when the user explicitly asks for agents, parallel work, or delegation. For Z Skills landing gates, prefer a fresh independent verification context when it is available without violating the current Codex delegation policy; otherwise run inline, disclose lower assurance, and do not auto-land unless the user accepts it.
- For isolation, create git worktrees explicitly with normal
git worktree commands. Do not rely on an isolation: "worktree" parameter.
- Config lookup order is project
.agents/zskills-config.json first, then project zskills-config.json, then legacy .codex/zskills-config.json, then legacy .claude/zskills-config.json only if already present. Do not create new .claude runtime config for Codex.
- Scheduling is not automatic in Codex. If the user asks for recurring runs, explain the schedule and ask before installing any local cron/system scheduler. For normal turns, perform the requested work now.
- Helper assets live at project
.agents/zskills-support by default. Use project-local scripts/* first; fall back to $CODEX_HOME/zskills-support only for explicit global installs or legacy setups.
- Preserve Codex safety rules: do not revert unrelated work, stage files by name, avoid destructive git commands, and verify from actual diffs/tests.
Detailed upstream text is archived in references/upstream-claude-adapted.md for edge cases and future diffs. Load it only when the concise workflow below is insufficient.
Do
Workflow
- Parse the user request as the task description plus optional mode words:
worktree, push, pr, or now. Ignore every as scheduling unless the user explicitly asks to configure a local scheduler.
- Decide whether the task is small enough for
do. If it needs multiple dependent phases, switch to draft-plan or run-plan and say why.
- Choose execution mode:
- Default: work in the current repository.
worktree or pr: create a git worktree manually under /tmp/<project>-do-<slug> on a named branch.
push: verify before pushing.
- Implement using normal Codex coding discipline: inspect files, make scoped edits, and avoid unrelated changes.
- Verify with the smallest meaningful test set, plus lint/typecheck/manual checks when relevant.
- Commit or push only if requested.
Landing Modes
Use the shared Z Skills config lookup order: .agents/zskills-config.json, zskills-config.json, legacy .codex/zskills-config.json, then legacy .claude/zskills-config.json.
direct: work in the current tree. Refuse direct main commits when execution.main_protected is true unless the user explicitly overrides after warning.
cherry-pick: for worktree mode, create a manual worktree, commit there, verify, then cherry-pick the scoped commit back to main.
pr / locked-main-pr: create a manual worktree branch using execution.branch_prefix, push it, and create a PR with gh if available. Do not push to main.
Scheduling
Codex has no built-in Z Skills cron tools. For every, next, or stop, explain that no Codex schedule exists by default. Configure system cron only after a clear user request.
Agents
Use sub-agents only when the user explicitly asked for agent delegation or when a fresh verifier is allowed by the current Codex delegation policy for a Z Skills landing gate or explicit verification. Otherwise execute inline and disclose the review mode.
Preserved Z Skills Invariants
- Keep this lighter than
run-plan; escalate multi-phase work.
- Parse trailing mode words conservatively.
push requires verification first.
- PR mode uses an isolated branch/worktree unless the user asks otherwise.