Agents reference
This page lists the 14 subagents of the Navin library, with the tools each one may use. An agent is activated on its own or with its plugin.
| Name | Description | Tools | Model | Colour | Plugins | Source |
|---|---|---|---|---|---|---|
agent-creator | Use this agent when the user wants a new Navin subagent written from a plain-language description: it designs the role, writes the triggering examples and saves the agent file. Typical requests are "create an agent that reviews migrations", "make me a subagent for release notes" or "add an agent to my plugin". | read_file, write_file, list_dir, find_files, grep, exec, skill | inherit | magenta | plugin-dev | catalog/navin/builtin_agents/agent-creator.md |
agent-sdk-verifier-py | Reviews a Python application built on the Navin Python SDK (from navin import Navin) for correct installation, configuration, SDK usage, secret handling, error handling and documentation, and returns a PASS / PASS WITH WARNINGS / FAIL report. Use when a Python Navin SDK app was just scaffolded or changed and must be checked before it is used or shipped. | read_file, grep, find_files, list_dir, code_index, lsp, web_fetch, web_search | - | green | agent-sdk-dev | catalog/navin/builtin_agents/agent-sdk-verifier-py.md |
agent-sdk-verifier-ts | Reviews a TypeScript application that talks to a Navin agent through the OpenAI-compatible API served by navin serve (/v1/chat/completions) for correct installation, client configuration, request usage, secret handling, error handling and documentation, and returns a PASS / PASS WITH WARNINGS / FAIL report. Use when a TypeScript Navin client app was just scaffolded or changed and must be checked before it is used or shipped. | read_file, grep, find_files, list_dir, code_index, lsp, web_fetch, web_search | - | blue | agent-sdk-dev | catalog/navin/builtin_agents/agent-sdk-verifier-ts.md |
code-architect | Designs the architecture of a feature from the patterns and conventions already in the codebase, and delivers a complete implementation blueprint - files to create or change, component design, data flow and build order. Use when a feature needs a decided design before coding. | read_file, grep, find_files, list_dir, code_index, metagraph, lsp, web_fetch, web_search | - | green | feature-dev | catalog/navin/builtin_agents/code-architect.md |
code-explorer | Traces how an existing feature works - entry points, execution paths, architecture layers, patterns and dependencies - to prepare new development. Use when a feature must be understood end to end before it is changed or extended. | read_file, grep, find_files, list_dir, code_index, metagraph, lsp, web_fetch, web_search | - | yellow | feature-dev | catalog/navin/builtin_agents/code-explorer.md |
code-reviewer | Reviews code for bugs, logic errors, security flaws, quality problems and project-convention breaches, scoring each finding for confidence and reporting only the high-priority ones. Use when code was written or changed and needs a review before it is merged. | read_file, grep, find_files, list_dir, code_index, lsp, code_review, web_fetch, web_search | - | red | code-review, feature-dev, pr-review-toolkit, security-guidance | catalog/navin/builtin_agents/code-reviewer.md |
code-simplifier | Simplifies recently written or modified code for clarity, consistency and maintainability while preserving its exact behaviour, following the project's own conventions. Use when a coding task or a logical chunk of code is finished, after a review has passed, or when code works but feels more complex than it needs to be. | read_file, grep, find_files, list_dir, code_index, lsp, code_review, apply_patch, edit_file, verify, test_run | - | blue | pr-review-toolkit | catalog/navin/builtin_agents/code-simplifier.md |
comment-analyzer | Checks code comments and docstrings for accuracy against the code, completeness and long-term value, and flags comment rot. Use when documentation comments were written or changed, before finalizing a pull request that touches comments, or when auditing existing comments for technical debt. | read_file, grep, find_files, list_dir, code_index, lsp, code_review | - | green | pr-review-toolkit | catalog/navin/builtin_agents/comment-analyzer.md |
conversation-analyzer | Reads conversation excerpts and finds the agent behaviours the user wants to prevent (corrections, frustration, repeated mistakes), then turns each one into a ready-to-use hookify rule with event, regex pattern and severity. Use when /hookify runs without arguments, or when the user asks to review the conversation and create rules for the mistakes that were made. | read_file, grep, find_files | inherit | yellow | hookify | catalog/navin/builtin_agents/conversation-analyzer.md |
plugin-validator | Use this agent when a Navin plugin must be checked for structure and quality - after creating or modifying one, before publishing it, or when a plugin component does not load. It validates plugin.json, skills, agents, commands, hooks and MCP servers and returns a report. | read_file, list_dir, find_files, grep, exec, skill | inherit | yellow | plugin-dev | catalog/navin/builtin_agents/plugin-validator.md |
pr-test-analyzer | Reviews the test coverage of a change for behavioural completeness, critical gaps and test quality, rating each missing test by how much it matters. Use when a pull request is opened or updated, when new behaviour was added, or before marking a change ready for review. | read_file, grep, find_files, list_dir, code_index, lsp, code_review | - | cyan | pr-review-toolkit | catalog/navin/builtin_agents/pr-test-analyzer.md |
silent-failure-hunter | Hunts silent failures, swallowed errors, overly broad catch blocks and unjustified fallbacks in changed code, and reports each with its severity, hidden errors and a corrected example. Use when a change adds or modifies error handling, try/except or catch blocks, fallback logic, retries, or anything that could suppress an error. | read_file, grep, find_files, list_dir, code_index, lsp, code_review | - | yellow | pr-review-toolkit | catalog/navin/builtin_agents/silent-failure-hunter.md |
skill-reviewer | Use this agent when a Navin skill needs a quality review - after writing or changing a SKILL.md, before shipping it in a plugin, or when a skill does not trigger when it should. It reviews the description, the body, progressive disclosure and bundled files, and returns a rated report with fixes. | read_file, list_dir, find_files, grep, exec, skill | inherit | cyan | plugin-dev | catalog/navin/builtin_agents/skill-reviewer.md |
type-design-analyzer | Analyses the design of new or changed types for invariants, encapsulation and enforcement, and rates encapsulation, invariant expression, usefulness and enforcement from 1 to 10. Use when a type, class, model or schema is introduced, when a pull request adds data types, or when an existing type is refactored. | read_file, grep, find_files, list_dir, code_index, lsp, code_review | - | magenta | pr-review-toolkit | catalog/navin/builtin_agents/type-design-analyzer.md |