Answer: Create a .kiro/agents/ directory in your workspace (or ~/.kiro/agents/ for global agents), add a Markdown or JSON file where the filename becomes the agent name, then switch to it using the agent picker in the chat pane header. Status: Confirmed Entry: tool/kiro/agents-and-automation/create-custom-agent-quick-start Revision: 2 Digest: sha256:708ec6997a20982f (changes whenever the content changes) Timeline: Created: 2026-11-13T03:39:49Z Last changed: 2026-11-20T13:24:54Z (How to switch: — → agent picker in the chat pane header) Last verified: 2026-11-20T13:24:54Z Next check: 2026-11-21T13:24:54Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Directory | .kiro/agents/ | [1] | 2026-11-20 Global directory | ~/.kiro/agents/ | [1] | 2026-11-20 File formats | Markdown or JSON | [1] | 2026-11-20 Example file | .kiro/agents/backend-dev.md | [1] | 2026-11-20 How to switch | agent picker in the chat pane header | [1] | 2026-11-20 Sources: [1] Amazon Web Services. "Creating custom agents - Custom agents - Features - Docs - Kiro". https://kiro.dev/docs/custom-agents/creating/ Role: primary. Accessed: 2026-11-20T13:24:54Z Quote: "Create a .kiro/agents/ directory in your workspace" (Supports: Directory) Quote: "or ~/.kiro/agents/ for global agents" (Supports: Global directory) Quote: "Add a Markdown or JSON file - the filename becomes the agent name" (Supports: File formats) Quote: "For example, create .kiro/agents/backend-dev.md" (Supports: Example file) Quote: "Then switch to it using the agent picker in the chat pane header." (Supports: How to switch) Published: 2026-11-20T07:39:25Z Snapshot SHA-256: 9c9ddda6952ff16176d96c8058f4c814bbbf1c2aa2f9226312a927a0fa3b5d09 (captured 2026-11-20T13:24:54Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T13:24:54Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:24:54Z Last attempt: 2026-11-20T13:24:54Z Notes and limitations: Extracted automatically from a single official source (section "Quick start"). Related: https://latestn.com/tool/kiro/agents-and-automation/create-custom-bot-schedule How do I create a custom schedule for a Kiro Crew bot? https://latestn.com/tool/kiro/agents-and-automation/create-custom-skill How do I create a custom skill in Kiro? https://latestn.com/tool/kiro/agents-and-automation/create-hook How do I create a new hook in Kiro? https://latestn.com/tool/kiro/agents-and-automation/create-asset-indexer-hook How do I create an asset indexer hook in Kiro? https://latestn.com/tool/kiro/agents-and-automation/create-asset-removal-hook How do I create an asset removal hook in Kiro? https://latestn.com/tool/kiro/agents-and-automation/create-custom-agent How do I create a custom agent in Kiro Crew? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-20T13:24:54Z | changed | How to switch: — → agent picker in the chat pane header | [1] 2026-11-20T13:24:54Z | changed | Example file: — → .kiro/agents/backend-dev.md | [1] 2026-11-20T13:24:54Z | changed | File formats: — → Markdown or JSON | [1] 2026-11-20T13:24:54Z | changed | Global directory: — → ~/.kiro/agents/ | [1] 2026-11-20T13:24:54Z | changed | Directory: — → .kiro/agents/ | [1] 2026-11-20T13:24:54Z | changed | switch method: agent picker in the chat pane header → — | [1] 2026-11-20T13:24:54Z | changed | example file: .kiro/agents/backend-dev.md → — | [1] 2026-11-20T13:24:54Z | changed | file formats: Markdown or JSON → — | [1] 2026-11-20T13:24:54Z | changed | global directory: ~/.kiro/agents/ → — | [1] 2026-11-20T13:24:54Z | changed | directory: .kiro/agents/ → — | [1] 2026-11-13T03:39:49Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/kiro/agents-and-automation/create-custom-agent-quick-start/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/kiro/agents-and-automation/create-custom-agent-quick-start POST: https://latestn.com/dispute/tool/kiro/agents-and-automation/create-custom-agent-quick-start with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/kiro/agents-and-automation/create-custom-agent-quick-start?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I create a custom agent in Kiro and start using it? Revision 2, last verified 2026-11-20T13:24:54Z. https://latestn.com/tool/kiro/agents-and-automation/create-custom-agent-quick-start (accessed 2026-11-21T10:03:40Z). @misc{LatestN_tool_kiro_agents_and_automation_create_custom_agent_quick_start_r2, title = {How do I create a custom agent in Kiro and start using it?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/kiro/agents-and-automation/create-custom-agent-quick-start}}, note = {Revision 2; digest sha256:708ec6997a20982f; last verified 2026-11-20T13:24:54Z; accessed 2026-11-21T10:03:40Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/kiro/agents-and-automation/create-custom-agent-quick-start