Kiro — Agents
- File format
- Markdown
- Discovery path
-
.kiro/agents - Global install path
-
~/.kiro/agents - Syllago install method
- Symlink, Direct copy
- Symlink support
- Yes
- Native frontmatter fields
-
name,description,model,tools,allowedTools,toolAliases,toolsSettings,mcpServers,resources,includeMcpJson,includePowers,keyboardShortcut,welcomeMessage,hooks
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Fields
Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.
| Provider field | Conversion | Canonical key | Summary |
|---|---|---|---|
allowedTools | Conversion type: No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → | — | Per-agent list of tools that execute without requiring user approval. Supports exact matches and glob-pattern wildcards like '@server/read_*' or '@git-*/status'. |
mcpServers | Conversion type: No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → | — | Per-agent 'mcpServers' map scoping MCP server configs to a single agent without touching workspace config. |
prompt | Conversion type: No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → | — | Load the system prompt from an external Markdown file via a 'file://path' URI instead of embedding inline text. Allows complex prompts to be maintained separately for better organization and reuse across agents. |
resources | Conversion type: No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → | — | Attach files, skills, or knowledge-base entries into the agent's context via a configured resources list. File resources load immediately; skills load metadata first then full content on-demand; knowledge bases enable searching indexed documentation. |
toolAliases | Conversion type: No canonical equivalent — appended as prose in a conversion notes block so nothing is silently lost. Learn more → | — | Per-agent 'toolAliases' map renaming tools to resolve naming collisions across MCP servers, or to create more intuitive naming. Useful when multiple MCP servers provide similarly-named tools. |
hooks | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | — | Per-agent hooks defined in the agent's JSON config, triggered at lifecycle points including agent startup, user prompt submission, before/after tool use, and response completion. |
includeMcpJson | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | — | Boolean flag controlling whether workspace .kiro/settings/mcp.json merges into the agent's available MCP servers. |
keyboardShortcut | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | — | Bind an IDE keyboard shortcut string (e.g. 'ctrl+a') for quick agent invocation from the editor. |
toolsSettings | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | — | Provide per-tool configuration objects for fine-grained behavioral settings via a map keyed by tool name. Used for restricting file write operations to particular directories or limiting shell command execution. |
welcomeMessage | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | — | Optional 'welcomeMessage' string displayed to the user when the agent session starts. |
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
agent_scopes | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | project (.kiro/agents/) + global (~/.kiro/agents/); global overrides local on name collision — reverse of most Kiro content types |
definition_format | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | JSON config files in .kiro/agents/ (project) or ~/.kiro/agents/ (global); prompt field accepts inline string or file:// URI to external .md file |
invocation_patterns | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | keyboard shortcut binding for IDE invocation; welcomeMessage shown on agent start; manual selection via agent picker |
model_selection | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | model field in agent JSON config overrides workspace default for that agent; falls back to default if specified model is unavailable |
per_agent_mcp | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | inline mcpServers map per agent config; includeMcpJson boolean controls whether workspace .kiro/settings/mcp.json is merged into agent's server set |
tool_restrictions | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | tools array with exact names, wildcards (computer_*), or MCP-namespaced refs (@server_name); allowedTools list for tools requiring no user approval; toolsSettings map for per-tool behavioral config |
Sources
| Source |
|---|
| https://kiro.dev/docs/cli/custom-agents/configuration-reference/ |