| name | test-writer |
| description | Write or review behavior-first tests by reusing the source workflow under `claude/test-writer`. Use when the user wants tests added or existing tests reviewed in Codex. |
| metadata | {"short-description":"Write behavior-first tests"} |
Test Writer
Use this skill when the user wants new tests added or existing tests reviewed for quality and maintainability.
This is a thin Codex wrapper around claude/test-writer/skills/test-writer/SKILL.md. Reuse the source workflow, references, scripts, and eval material from the Claude skill directory instead of maintaining duplicated Codex copies.
Use This Skill
- Use this skill when the user wants new tests added or existing tests reviewed for quality and maintainability.
Do Not Use This Skill
- Do not use this skill for production code changes that do not actually require test design or review.
Source Material
- Source skill:
claude/test-writer/skills/test-writer/SKILL.md
- Source directory:
claude/test-writer/skills/test-writer/
- Codex metadata:
agents/openai.yaml
Load only the source files needed for the current task. Do not recreate or copy the Claude-side bundled resources into this Codex skill.
Workflow
- Treat
claude/test-writer/skills/test-writer/SKILL.md as the source workflow.
- Read the needed source references from
claude/test-writer/skills/test-writer/references/ before writing or reviewing tests.
- Focus on behaviour, edge cases, and minimal mocking rather than implementation-coupled tests.
- Run the narrowest relevant verification available after adding or changing tests.
Codex Notes
- Ignore Claude-only frontmatter and runtime wiring such as
allowed-tools, user-invocable, $ARGUMENTS, and CLAUDE_SKILL_DIR.
- Infer inputs from the user request and local context before asking follow-up questions.
- If a source script or networked command fails because of sandbox restrictions, rerun it with escalation and a short justification.
- For destructive or irreversible actions, confirm intent unless the user was already explicit.
- This skill runs in a single Codex agent loop - no subagent fan-out. If the source workflow spawns helper or persona subagents, do that work inline in the main loop.
Verification
After any fix or state-changing action, rerun the narrowest relevant validator, script, listing command, or source check and compare the before/after result.
- Re-check the key output, diff, command result, or rendered text after you act.
- If the task changed files or external state, rerun the narrowest relevant validator, script, listing command, or source query.
- Report what was verified, what remains unverified, and any residual risk.
Examples
User: "Use Test Writer for this task."
Assistant: Opens `claude/test-writer/skills/test-writer/SKILL.md`, loads only the needed source references or scripts, adapts the workflow to Codex conventions, and completes the task.
User: "Apply the Test Writer workflow here."
Assistant: Reuses the source material from `claude/test-writer/skills/test-writer/` instead of relying on duplicated Codex-side resources.
