kiro-cli-docs :- updated kiro-cli docs and added missing commands.

Author: Nitish [C] Dhok

docs/kiro-cli-docs/autodocs/docs/slash-commands/agent-create.md

@@ -0,0 +1,85 @@
+---
+doc_meta:
+  validated: 2025-12-19
+  commit: 57090ffe
+  status: validated
+  testable_headless: false
+  category: slash_command
+  title: /agent create
+  description: Create a new agent with the specified name
+  keywords: [agent, create, new, configuration]
+  related: [agent-switch, agent-list, agent-generate, cmd-agent, agent-config]
+---
+
+# /agent create
+
+Create a new agent with the specified name.
+
+## Overview
+
+The `/agent create` command creates a new agent configuration with the specified name, optionally using an existing agent as a template.
+
+## Usage
+
+```
+/agent create --name <NAME> [OPTIONS]
+```
+
+## Options
+
+- `-n, --name <NAME>` - Name of the agent to be created (required)
+- `-d, --directory <DIRECTORY>` - Directory where the agent will be saved (optional)
+- `-f, --from <FROM>` - Name of existing agent to use as template (optional)
+- `-h, --help` - Print help
+
+## Examples
+
+### Example 1: Basic Agent Creation
+
+```
+/agent create --name my-agent
+```
+
+Creates a new agent in the global agent directory.
+
+### Example 2: Create in Specific Directory
+
+```
+/agent create --name my-agent --directory ./custom-agents
+```
+
+Creates agent in specified directory.
+
+### Example 3: Create from Template
+
+```
+/agent create --name my-agent --from python-dev
+```
+
+Creates new agent using `python-dev` as template.
+
+### Example 4: Full Options
+
+```
+/agent create --name my-agent --directory ./.kiro/agents --from rust-expert
+```
+
+Creates agent in local directory using template.
+
+## Default Behavior
+
+- **Directory**: If not specified, saves to global agent directory (`~/.kiro/agents/`)
+- **Template**: If not specified, creates basic agent configuration
+
+## Related Commands
+
+- [/agent list](agent-list.md) - List available agents
+- [/agent](agent-switch.md) - Switch to different agent
+- [/agent generate](agent-generate.md) - Generate agent with AI
+- [kiro-cli agent](../commands/agent.md) - CLI agent management
+
+## Technical Details
+
+**Storage**: Creates agent configuration file in specified or default directory.
+
+**Template**: When using `--from`, copies configuration from existing agent as starting point.

docs/kiro-cli-docs/autodocs/docs/slash-commands/agent-edit.md

@@ -0,0 +1,84 @@
+---
+doc_meta:
+  validated: 2025-12-19
+  commit: 57090ffe
+  status: validated
+  testable_headless: false
+  category: slash_command
+  title: /agent edit
+  description: Edit an existing agent configuration
+  keywords: [agent, edit, modify, configuration]
+  related: [agent-switch, agent-list, agent-create, cmd-agent, agent-config]
+---
+
+# /agent edit
+
+Edit an existing agent configuration.
+
+## Overview
+
+The `/agent edit` command opens an existing agent configuration for editing, either by agent name or direct file path.
+
+## Usage
+
+```
+/agent edit [OPTIONS]
+```
+
+## Options
+
+- `-n, --name <NAME>` - Name of the agent to edit
+- `--path <PATH>` - Path to the agent config file to edit
+- `-h, --help` - Print help
+
+## Examples
+
+### Example 1: Edit by Name
+
+```
+/agent edit --name python-dev
+```
+
+Opens the `python-dev` agent configuration for editing.
+
+### Example 2: Edit by Path
+
+```
+/agent edit --path ~/.kiro/agents/my-agent.toml
+```
+
+Opens the agent configuration file at the specified path.
+
+### Example 3: Interactive Selection
+
+```
+/agent edit
+```
+
+Shows picker to select agent to edit (if no options provided).
+
+## Agent Resolution
+
+When using `--name`:
+1. **Local**: `.kiro/agents/` in current directory
+2. **Global**: `~/.kiro/agents/` in home directory
+3. **Built-in**: Default agents (read-only)
+
+## Editor Behavior
+
+- Opens configuration file in default system editor
+- Changes are saved automatically when editor closes
+- Built-in agents cannot be modified
+
+## Related Commands
+
+- [/agent list](agent-list.md) - List available agents
+- [/agent create](agent-create.md) - Create new agent
+- [/agent](agent-switch.md) - Switch to different agent
+- [kiro-cli agent](../commands/agent.md) - CLI agent management
+
+## Technical Details
+
+**File Format**: Agent configurations are typically TOML files.
+
+**Editor**: Uses system default editor or `$EDITOR` environment variable.

docs/kiro-cli-docs/autodocs/docs/slash-commands/agent-list.md

@@ -0,0 +1,75 @@
+---
+doc_meta:
+  validated: 2025-12-19
+  commit: 57090ffe
+  status: validated
+  testable_headless: false
+  category: slash_command
+  title: /agent list
+  description: List all available agents
+  keywords: [agent, list, available, show]
+  related: [agent-switch, agent-generate, cmd-agent, agent-config]
+---
+
+# /agent list
+
+List all available agents.
+
+## Overview
+
+The `/agent list` command displays all available agent configurations with their paths and marks the currently active agent.
+
+## Usage
+
+```
+/agent list
+```
+
+## Options
+
+- `-h, --help` - Print help
+
+## Examples
+
+### Example 1: Basic List
+
+```
+/agent list
+```
+
+**Output**:
+```
+* rust-expert    ~/.kiro/agents
+  python-dev     ~/.kiro/agents
+  default        (Built-in)
+```
+
+The `*` indicates the currently active agent.
+
+## Output Format
+
+- **Active Agent**: Marked with `*` prefix
+- **Agent Name**: Configuration name
+- **Path**: Location of agent configuration
+  - `~/.kiro/agents/` - Global agents
+  - `.kiro/agents/` - Local agents  
+  - `(Built-in)` - Default system agents
+
+## Agent Resolution Order
+
+Agents are discovered from:
+1. **Local**: `.kiro/agents/` in current directory
+2. **Global**: `~/.kiro/agents/` in home directory
+3. **Built-in**: Default system agents
+
+## Related Commands
+
+- [/agent](agent-switch.md) - Switch to different agent
+- [/agent generate](agent-generate.md) - Generate new agent
+- [kiro-cli agent](../commands/agent.md) - CLI agent management
+
+## Technical Details
+
+**Discovery**: Scans agent directories in resolution order and includes built-in agents.
+
+**Active Detection**: Compares current session agent with discovered agents to mark active status.

docs/kiro-cli-docs/autodocs/docs/slash-commands/agent-schema.md

@@ -0,0 +1,85 @@
+---
+doc_meta:
+  validated: 2025-12-19
+  commit: 57090ffe
+  status: validated
+  testable_headless: false
+  category: slash_command
+  title: /agent schema
+  description: Show agent config schema
+  keywords: [agent, schema, configuration, format]
+  related: [agent-switch, agent-list, agent-create, agent-edit, agent-config]
+---
+
+# /agent schema
+
+Show agent config schema.
+
+## Overview
+
+The `/agent schema` command displays the configuration schema for agent files, showing the structure and available fields.
+
+## Usage
+
+```
+/agent schema
+```
+
+## Options
+
+- `-h, --help` - Print help
+
+## Examples
+
+### Example 1: Display Schema
+
+```
+/agent schema
+```
+
+**Output**:
+```toml
+[agent]
+name = "string"
+description = "string"
+version = "string"
+
+[agent.system]
+prompt = "string"
+temperature = 0.7
+max_tokens = 4096
+
+[agent.tools]
+enabled = ["tool1", "tool2"]
+disabled = ["tool3"]
+
+[agent.mcp]
+servers = ["server1", "server2"]
+```
+
+## Schema Sections
+
+- **agent** - Basic agent metadata
+- **agent.system** - System prompt and model parameters
+- **agent.tools** - Tool configuration and permissions
+- **agent.mcp** - MCP server configuration
+
+## Use Cases
+
+- Reference when creating new agents
+- Validate existing agent configurations
+- Understand available configuration options
+- Template for manual agent creation
+
+## Related Commands
+
+- [/agent create](agent-create.md) - Create new agent
+- [/agent edit](agent-edit.md) - Edit existing agent
+- [/agent list](agent-list.md) - List available agents
+- [kiro-cli agent](../commands/agent.md) - CLI agent management
+
+## Technical Details
+
+**Format**: Displays TOML schema with field types and example values.
+
+**Validation**: Use schema to ensure agent configurations are properly formatted.