AgentKit
DocsKitsCLI ReferenceDesktop App
BetaYou are reading docs for the beta channel (2.13.0-beta.20). Features may change before the next stable release.Switch to stable →

Agents

Engineer agents

Find the 16 specialist roles that help Engineer Kit explore, plan, build, verify, and deliver software work.

Engineer Kit includes 16 Agents: 10 shared roles used across AgentKit and 6 roles specific to engineering work. Together, they cover the path from an unclear request to a reviewed result without turning every specialist into a separate command you must manage.

How Agents complement Skills

A Skill is a workflow you choose for an outcome, such as planning a change, debugging a failure, or reviewing code. An Agent is a specialist role that receives a bounded delegated task and returns a focused result. A Skill can coordinate one or more Agents, and your coding assistant can delegate to an Agent when the current task fits that role.

Start with the Skill or outcome you need. You usually do not need to select every Agent yourself, and Agent IDs are not a universal slash-command surface. The available discovery and orchestration controls depend on the target runtime.

Find the right help by outcome

The roster below is the complete resolved Engineer set. “Shared” identifies a role included in the common foundation; “Engineer-specific” identifies one of the six roles added by Engineer Kit.

Understand and decide

AgentOriginPurpose
ExploreSharedMaps the files, symbols, and relationships relevant to a bounded codebase question.
researcherSharedProduces a sourced synthesis of technologies, patterns, or primary documentation.
brainstormerEngineer-specificExplores architectures and solution approaches before implementation begins.
advisorEngineer-specificReviews direction at a senior level and returns risks, trade-offs, and recommendations.
kongmingSharedFrames difficult strategic decisions as options, consequences, and a recommended course.

Plan and coordinate

AgentOriginPurpose
plannerSharedTurns a significant change into an evidence-based implementation plan.
project-managerSharedConsolidates work against the plan and reports progress, gaps, and next actions.

Create and improve

AgentOriginPurpose
fullstack-developerSharedImplements a bounded phase across frontend, backend, or infrastructure under clear ownership.
ui-ux-designerEngineer-specificDesigns or audits interfaces, responsiveness, accessibility, and design systems.
code-simplifierEngineer-specificRefines recently changed code for clarity and consistency while preserving behavior.
docs-managerSharedAudits and maintains technical documentation and development standards.

Verify, deliver, and learn

AgentOriginPurpose
debuggerSharedInvestigates failures, logs, behavior, data, or performance and returns a diagnosis.
testerSharedRuns and evaluates relevant tests, builds, coverage, and error paths.
code-reviewerEngineer-specificReviews correctness, security, performance, edge cases, and maintainability.
git-managerEngineer-specificHandles scoped staging, commits, pushes, and Git handoff when explicitly requested.
journal-writerSharedRecords significant failures, incidents, blocked dependencies, or architectural setbacks.

Discover and orchestrate Agents

Use ak agents list --kit engineer to inspect the resolved roster. After installation, the selected runtime projects and discovers Agents in its own way:

  1. Begin with an outcome. Choose a Skill or describe the task you want to complete instead of treating the roster as a required sequence.
  2. Let the workflow delegate bounded work. A Skill or your coding assistant can select a specialist when its role fits the current step.
  3. Review the consolidated result. Delegation does not approve changes or external actions, and a person remains responsible for the final decision.

Claude Code uses its native subagent surface. Codex receives translated Agent definitions and AgentKit runtime integration. Cursor receives a native Agent projection. These are different orchestration surfaces, so a name appearing in the roster does not establish one direct invocation syntax across all three.

Runtime and model boundaries

Agent names and the purposes above describe the shipped roster, not guaranteed runtime parity. Model tiers can be mapped differently for each target, and the available provider or model can depend on the user's runtime setup. Treat an Agent's purpose as its working role, not as a promise of a particular model, identical output, or identical orchestration behavior.

For Codex in this release, the shared researcher Agent emits model = "gpt-5.4" and model_reasoning_effort = "medium" when its model resolves. If no model resolves, AgentKit omits both settings. This does not change the Agent roster, Claude Code behavior, or Cursor behavior.

For broader delivery differences, read Runtime adapters. If an installed Agent is not discoverable, follow Runtime cannot find a Skill or Agent before changing installation files.

Continue exploring