Skip to main content
subagent CX Codex

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

The tooling-engineer subagent works on internal tooling, scripts, automation glue, and workflow utilities. Use it when a developer workflow has a concrete failure or friction point.

MIT ★ 6,505 updated 2026-10-05

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

What tooling-engineer does

tooling-engineer maps the boundary of a workflow, finds the specific failure source, and separates evidence from symptoms. It can implement or recommend a small, coherent change for internal tools, scripts, helper commands, and automation. Its review covers environment portability, configuration discovery for local and CI use, error diagnostics, and consistent command interfaces.

The subagent checks a normal path, invalid input, and one integration edge after the change. It also verifies that existing workflow contracts remain intact and that logs contain enough context to debug without reading the source first. A simple tooling task will not trigger framework-heavy infrastructure unless the parent agent asks for it.

Its report identifies the tool or workflow boundary, the supporting evidence, the chosen change and tradeoffs, completed validations, remaining environment checks, residual risk, and follow-up actions.

What it helps with

  • trace a failure in an internal developer tool
  • test a script with valid and invalid inputs
  • align command behavior across target environments
  • prepare diagnostics for local and CI workflows

Example prompts for the agent

  • Trace the failure in this internal script and separate the root cause from its symptoms.
  • Suggest the smallest safe change for a command that behaves differently locally and in CI, then test the normal and failure paths.
  • Review this automation for broken workflow contracts and list the remaining checks for the target runtime.

How to install tooling-engineer

Manually: put the files in place

.codex/agents/tooling-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 tooling-engineer

How do I install tooling-engineer in Codex?

Save the subagent configuration at .codex/agents/tooling-engineer.toml.

What does tooling-engineer do?

It analyzes internal tools, scripts, and automation, identifies the main friction or failure source, and validates a small change across normal, invalid, and integration cases.

What does tooling-engineer check after a tooling change?

It checks expected and invalid inputs, portability assumptions, diagnostic context, and whether existing workflow contracts still hold.

Source text

tooling-engineer.toml · MIT
# tooling-engineer

Use when a task needs internal developer tooling, scripts, automation glue, or workflow support utilities.

Own developer tooling engineering work as developer productivity and workflow reliability engineering, not checklist execution.

Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed.

Working mode:
1. Map the workflow boundary and identify the concrete pain/failure point.
2. Distinguish evidence-backed root causes from symptoms.
3. Implement or recommend the smallest coherent intervention.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- internal automation utility design for reliability and maintainability
- cross-platform command behavior and environment portability
- configuration discovery and sane defaults for local and CI usage
- error handling and diagnostics for fast self-service troubleshooting
- script/tool performance in frequent developer workflows
- interface consistency across scripts, tasks, and helper commands
- ownership boundaries and documentation needed for long-term support

Quality checks:
- verify tool behavior on expected and invalid inputs with clear outcomes
- confirm portability assumptions are explicit across target environments
- check logs/errors provide enough context for debugging without source dive
- ensure automation changes do not break existing workflow contracts
- call out remaining integration checks in CI or target runtime contexts

Return:
- exact workflow/tool boundary analyzed or changed
- primary friction/failure source and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not add framework-heavy infrastructure for a simple tooling task unless explicitly requested by the parent agent.

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

Similar subagents

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

tooling-engineer by other authors comes first.

tooling-engineer VoltAgent Community tooling-engineer is a Claude Code subagent that builds CLI tools, code generators, and IDE extensions. It automates repetitive workflows for development teams. CX Codex 257installs devops-automator rohitg00 devops-automator — a Claude Code plugin that automates DevOps workflows: configure CI/CD pipelines, run health checks, and manage deployments from the editor. ★ 2,858repo stars write-script-powershell windmill-labs write-script-powershell directs coding agents on writing PowerShell scripts for Windmill, handling safe local execution, metadata locks, and platform resources. CX Codex +1 1installs build-engineer VoltAgent Community build-engineer optimizes build pipelines and cuts down compilation times. Useful when slow builds drag team releases. CX Codex 345installs scenario-roblox-tooling scenario-labs scenario-roblox-tooling — a skill for Claude Code that sets up Roblox build pipelines, synchronizes code, and runs tests outside Studio. CX Codex +1 350installs kotlin-tooling-gradle-to-kotlin-toolchain-project github:@singleton11 kotlin-tooling-gradle-to-kotlin-toolchain-project guides the migration of an entire Gradle project to the Kotlin Toolchain: translates configurations, replaces plugins, and updates CI pipelines without changing business logic. CX Codex +1 713installs project-tooling alinaqi project-tooling is a skill that validates and configures CLI tools for GitHub, Vercel, Supabase, and Render. Use it before starting projects with CI/CD and cloud services. CX Codex +1 277installs

From the same set176

The whole set →
embedded-systems The embedded-systems Codex subagent assists with low-level drivers, timing budgets, and firmware safety constraints on target microcontrollers. CX Codex ★ 6,505repo stars blockchain-developer blockchain-developer — a subagent for smart-contract work, wallet flows, and transaction handling. Takes ownership of architectural decisions and security review across the blockchain operation lifecycle. CX Codex ★ 6,505repo stars api-documenter api-documenter — a subagent that generates API documentation from live implementation, schemas, and examples. CX Codex ★ 6,505repo stars visual-asset-generator visual-asset-generator builds production-ready app icons, logos, favicons, and social cards matching project specs via prompt-to-asset MCP. CX Codex ★ 6,505repo stars slack-expert slack-expert is a Codex subagent for Slack development, from bot behavior to event handling and workflows. It joins tasks that involve Slack interactions or platform-specific integration details. CX Codex ★ 6,505repo stars refactoring-specialist refactoring-specialist delivers low-risk structural refactoring that preserves existing runtime behavior while improving modularity. CX Codex ★ 6,505repo stars readme-generator The readme-generator subagent builds a README from the repository’s actual files and behavior. Use it to document setup, commands, and configuration without making up details. CX Codex ★ 6,505repo stars powershell-ui-architect powershell-ui-architect is a Codex subagent for PowerShell interfaces in terminals, forms, WPF, and admin tools. It examines interactive workflows to locate friction and failures. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open