Skip to main content
subagent CX Codex

prompt-engineer · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

The prompt-engineer subagent treats prompts as behavior contracts, finds unclear instructions, and compares revisions against normal, edge, and failure scenarios.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/prompt-engineer.toml
Open on GitHub

What prompt-engineer does

prompt-engineer handles prompt revision, instruction design, and evaluation-focused comparisons. It maps the goal, available context, tool or retrieval use, and required response format, then traces unstable behavior to ambiguity, conflicts, or missing constraints.

The subagent recommends the smallest prompt or instruction-structure change that addresses the observed problem. It reports expected behavior shifts, tradeoffs, evaluation scenarios, and remaining risk. Its checks cover instruction hierarchy, machine-readable output, grounding and citation expectations, refusal behavior, and token use. A prompt edit cannot replace orchestration or system changes when those are the source of the problem.

What it helps with

  • trace unstable model behavior to prompt flaws
  • tighten a machine-readable output contract
  • compare prompt revisions on fixed scenarios
  • remove ambiguity from role and task scope
  • test handling of risky or out-of-scope requests

Example prompts for the agent

  • Review this prompt and identify what causes unstable behavior.
  • Compare these two instruction versions on a normal, edge, and failure scenario.
  • Tighten the JSON response contract and flag changes that require orchestration work.

How to install prompt-engineer

Manually: put the files in place

.codex/agents/prompt-engineer.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about prompt-engineer

How do I install prompt-engineer in Codex?

Create .codex/agents/prompt-engineer.toml in the project and add the subagent configuration there.

What does prompt-engineer do?

It treats prompts as interfaces for task boundaries, response contracts, and failure handling. It returns the core issue, a revision strategy, expected behavior changes, evaluation scenarios, and residual risk.

How does prompt-engineer compare prompt revisions?

It uses a stable scenario set with a normal case, an edge case, and a failure case. The review connects each revision to concrete failure patterns rather than stylistic preference.

Source text

prompt-engineer.toml · MIT
# prompt-engineer

Use when a task needs prompt revision, instruction design, eval-oriented prompt comparison, or prompt-output contract tightening.

Own prompt engineering as contract design for reliable model behavior, not stylistic rewriting.

Treat prompts as interfaces that define task boundaries, output contracts, and failure handling expectations.

Working mode:
1. Map objective, input context, tool/retrieval usage, and required output contract.
2. Identify ambiguity, instruction conflict, or missing constraints causing unstable behavior.
3. Propose the smallest prompt-level or instruction-structure change that improves reliability.
4. Validate with targeted scenarios covering one normal case, one edge case, and one failure case.

Focus on:
- instruction hierarchy clarity and conflict removal
- explicit output schema and validation-friendly formatting
- grounding constraints and citation/tool-use expectations
- ambiguity reduction in role, scope, and decision criteria
- refusal/safety behavior for out-of-scope or risky requests
- token-budget efficiency without losing critical guidance
- evaluation design that compares prompts on representative tasks

Quality checks:
- verify prompt revisions map to concrete failure patterns, not preference
- confirm output contract is machine- and human-consumable
- check edge-case behavior for over/under-compliance risk
- ensure prompt changes are evaluated on a stable scenario set
- call out when orchestration/system changes are needed beyond prompt edits

Return:
- core prompt issue and behavioral symptom it causes
- revised prompt strategy (or exact prompt pattern) and rationale
- expected behavior changes and possible tradeoffs
- evaluation method and scenarios used for comparison
- residual risk and next iteration priorities

Do not optimize for a single demo case at the expense of general reliability unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

prompt-engineer by other authors comes first.

prompt-engineer VoltAgent Community The prompt-engineer subagent designs, tests, and improves prompts for LLM production systems. Use it when prompts need evaluation, metrics, or cost tracking. CX Codex 16,078installs prompt-engineer Seth Hobson The prompt-engineer subagent designs and tests prompts for LLM features, agent workflows, and system instructions. Use it when prompt structure, safety, or evaluation needs deliberate work. CX Codex 16,078installs prompt-engineer qdhenry The prompt-engineer subagent for Claude Code designs prompts, agent workflows, and structured outputs. It helps clarify instructions and safety constraints. CX Codex ★ 1,357repo stars prompt-engineer josstei prompt-engineer — a subagent for designing and testing LLM prompts. It steps in when you need an eval set, a JSON schema for structured output, or a RAG pipeline that cites the right chunks. CX Codex ★ 489repo stars mlops-engineer VoltAgent Community The mlops-engineer subagent designs ML infrastructure, model CI/CD, and versioning workflows. Use it when training automation, GPU orchestration, or ML monitoring needs attention. CX Codex 1,009installs ai-engineer VoltAgent Community The ai-engineer subagent helps design AI systems, choose models, build training pipelines, and prepare deployment. Use it when work spans research through production. CX Codex 7,687installs computer-vision-engineer davila7 computer-vision-engineer is a Claude Code subagent for building image and video analysis systems, from object detection to OCR. It handles work that needs classical or trainable computer vision models. CX Codex 1,248installs prompt-engineer-toolkit Alireza Rezvani prompt-engineer-toolkit is a Claude Code skill that tests, compares, and versions marketing prompts against structured cases. It checks prompt quality before rollouts or model changes. CX Codex +1 623installs senior-prompt-engineer Alireza Rezvani senior-prompt-engineer — a skill for systematic prompt optimization via eval sets, RAG quality measurement, and agent validation. Works with any model, uses only stdlib Python. CX Codex +1 970installs anthropic-prompt-engineer jamesrochabrun Builds new prompts from scratch and refines existing templates for Claude models using official Anthropic prompt engineering guidelines. CX Codex +1 233installs

From the same set176

The whole set →
dependency-manager dependency-manager inspects package graphs, updates libraries safely, and audits third-party dependency risks in Codex projects. CX Codex ★ 6,505repo stars cli-developer cli-developer — a Codex subagent that treats CLI development as workflow engineering, not checklist ticking. Maps the friction, finds the root cause, and proposes the smallest safe fix—from argument parsing to error messages. CX Codex ★ 6,505repo stars build-engineer build-engineer — a subagent for diagnosing build failures, dependency-graph issues, and CI pipeline instability. Maps the root cause, then recommends the smallest change that cuts friction without triggering full system migration. CX Codex ★ 6,505repo stars reinforcement-learning-engineer reinforcement-learning-engineer designs RL environments, crafts reward functions, and trains decision-making agents in Codex with safety checks across random seeds. CX Codex ★ 6,505repo stars postgres-pro postgres-pro is a Codex subagent for PostgreSQL schemas, query plans, locking, and operational risks. It joins tasks that need workload-aware advice on database changes and migrations. CX Codex ★ 6,505repo stars nlp-engineer nlp-engineer fixes text pipelines, tokenization, embeddings, and ranking in Codex. Focuses on real-world linguistic failure modes rather than synthetic benchmarks. CX Codex ★ 6,505repo stars mlops-engineer The mlops-engineer subagent handles model delivery, registries, pipelines, monitoring, and environment orchestration when an ML system needs controlled releases and rollback checks. CX Codex ★ 6,505repo stars ml-engineer ml-engineer — a subagent for working with machine learning in production code: from feature preparation to inference boundary validation. Keeps ML logic stable and visible in user-facing behavior. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open