# Agent skills

AI Architect comes with a set of Agent Skills — each one built to handle a specific engineering task like feasibility analysis, epic planning, or production triage. You can trigger them in Jira before coding starts, or inside your coding agent while you're building.

Agent skills are structured instruction files that enhance your AI coding assistant with specialized capabilities. In coding agents, skills are installed automatically by the [install scripts](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-coding-agents) and are discovered dynamically from a `skills/manifest.json` file. Whereas, in Jira, skills are available from Bito Cloud.

Every skill has full context of your codebase and your team's Jira history, so the output reflects how your system actually works.

## All available skills

| Skill                      | Triggers                                                                                                     | Description                                                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| **bito-codebase-explorer** | "explain this service", "how does X work", "what does Y depend on", "show me the architecture", "onboard me" | Explore and explain the codebase at any depth for any audience — executive summary to line-level traces       |
| **bito-epic-to-plan**      | "how would we build this", "turn this epic into tasks", "implementation plan for", "make this sprint-ready"  | Convert an approved epic/PRD into a sprint-ready plan with 3 architectural approaches, then granular tickets  |
| **bito-scope-to-plan**     | "plan this story", "create tickets for this", "technical plan for this PRD"                                  | Auto-scaling planning — full multi-workstream plans for epics, focused single-workstream plans for stories    |
| **bito-feasibility**       | "is this feasible", "go/no-go on", "what's the blast radius", "trade-off analysis"                           | Go/no-go feasibility and impact analysis — viability, blast radius, effort, dependencies, risks, alternatives |
| **bito-spike**             | "spike on", "investigate whether", "explore options for", "proof of concept for"                             | Time-boxed technical investigation — delivers findings and recommendations, not a plan                        |
| **bito-feature-plan**      | "plan a feature", "design implementation for"                                                                | Detailed org-specific implementation plan for a complex feature using cross-repo context                      |
| **bito-prd**               | "write a PRD", "product requirements for"                                                                    | Comprehensive Product Requirements Document grounded in real system context                                   |
| **bito-trd**               | "write a TRD", "technical requirements for"                                                                  | Technical Requirements Document analyzing existing architecture, dependencies, and patterns                   |
| **bito-production-triage** | "production issue", "incident triage", "debug outage"                                                        | Diagnose production incidents — cross-repo context, blast radius mapping, structured remediation plan         |

## How to invoke skills

#### In Jira

Agent skills can be triggered on demand on Epic or Story by commenting:

```
@bito turn this epic into tasks
@bito technical plan for this PRD
```

[**Guide for Jira**](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-jira)

#### In your coding agent

Once AI Architect is connected via MCP, skills are available in compatible coding agents. Describe what you need in natural language and the agent activates the right skill automatically — or invoke one directly by name. You can type `/` in the chatbox to see the list of available skills and select one interactively.

[**Quick MCP integration with AI coding agents**](https://docs.bito.ai/ai-architect/integrating-ai-architect-with-your-tools/integrating-with-coding-agents)

<figure><img src="https://2860197046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgNBTrPKG0DuVdAyDvSa%2Fuploads%2Fw8zixqidL20UuLvO2wxE%2FScreenshot%202026-03-02%20at%2010.59.58%E2%80%AFPM.png?alt=media&#x26;token=1513dc31-4164-4d23-a307-1f21385638fd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2860197046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgNBTrPKG0DuVdAyDvSa%2Fuploads%2Fr8FO4lgzkQV5HzEKVHFE%2FScreenshot%202026-03-02%20at%2011.00.16%E2%80%AFPM.png?alt=media&#x26;token=8a4a20ef-cd76-46ae-a316-006dcd266628" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2860197046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgNBTrPKG0DuVdAyDvSa%2Fuploads%2FaamsZyo5rb9tfujjjiT8%2FScreenshot%202026-03-02%20at%2011.32.07%E2%80%AFPM.png?alt=media&#x26;token=a7aa3ff3-1e74-4fba-9fd0-8cb2114c1c3b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2860197046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYgNBTrPKG0DuVdAyDvSa%2Fuploads%2FxCxV63wwOutfRz6HKkD9%2FScreenshot%202026-03-02%20at%2011.33.58%E2%80%AFPM.png?alt=media&#x26;token=7a2fa5e4-a5ab-44d5-b102-cbd35e64574a" alt=""><figcaption></figcaption></figure>

## Skills installation locations:

<table><thead><tr><th width="188.20001220703125">IDE</th><th>Location</th><th>Format</th></tr></thead><tbody><tr><td>Claude Code</td><td><code>~/.claude/skills/bito-{name}/SKILL.md</code></td><td>Markdown with YAML frontmatter</td></tr><tr><td>Cursor</td><td><code>~/.cursor/rules/bito-{name}.mdc</code></td><td><code>.mdc</code> with <code>alwaysApply: false</code></td></tr><tr><td>Windsurf</td><td><code>~/.codeium/windsurf/memories/bito-{name}.md</code></td><td>Plain markdown</td></tr><tr><td>VS Code (Copilot)</td><td><code>{User}/prompts/bito-{name}.prompt.md</code></td><td><code>.prompt.md</code> with <code>applyTo</code></td></tr><tr><td>Junie</td><td><code>~/.junie/skills/bito-{name}/SKILL.md</code></td><td></td></tr></tbody></table>