# builderio/skills architecture

> Architecture diagram of the GitHub repository builderio/skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/builderio/skills
- Repository: https://github.com/builderio/skills

## Overview

This repository is a catalog of composable agent skills. The principal workflow is: a user invokes a slash skill, the host agent loads its instructions, the skill guides tool use or decision-making, and the host returns the resulting work. Capabilities span visual planning and editing, app interaction, memory recovery, cross-agent review, autonomous execution, model orchestration, documentation discipline, and usage limits. The sampled source is strongest for skill content and synchronization; relationships between skills are therefore shown only where documented.

Main entry points: [`skills/an/SKILL.md`](https://github.com/builderio/skills/blob/main/skills/an/SKILL.md) (Agent-Native Apps), [`skills/webmcp/SKILL.md`](https://github.com/builderio/skills/blob/main/skills/webmcp/SKILL.md) (WebMCP Browser), [`skills/visual-plan/SKILL.md`](https://github.com/builderio/skills/blob/main/skills/visual-plan/SKILL.md) (Visual Plans), [`skills/visual-recap/SKILL.md`](https://github.com/builderio/skills/blob/main/skills/visual-recap/SKILL.md) (Visual Recaps)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_invocation["Agent Invocation"]
  node_an_command["AN Command<br/>[an.md]"]
  node_skill_an["Agent-Native Apps<br/>[SKILL.md]"]
  node_skill_webmcp["WebMCP Browser<br/>[SKILL.md]"]
end

subgraph group_visual["Visual Workflows"]
  node_skill_visual_plan["Visual Plans<br/>[SKILL.md]"]
  node_skill_visual_recap["Visual Recaps<br/>[SKILL.md]"]
  node_skill_visual_edit["Visual Editing<br/>[SKILL.md]"]
  node_skill_turn_app["App Packaging<br/>[SKILL.md]"]
end

subgraph group_operations["Execution Discipline"]
  node_skill_watchdog["Agent Watchdog<br/>[SKILL.md]"]
  node_skill_arbiter["Plan Arbiter<br/>[SKILL.md]"]
  node_skill_plow["Plow Ahead<br/>[SKILL.md]"]
  node_skill_quick_recap["Quick Recap<br/>[SKILL.md]"]
  node_skill_docs["Read Docs<br/>[SKILL.md]"]
  node_skill_limits["Usage Limits<br/>[SKILL.md]"]
end

subgraph group_orchestration["Orchestration &amp; Memory"]
  node_skill_fable["Efficient Fable<br/>[SKILL.md]"]
  node_skill_frontier["Efficient Frontier<br/>[SKILL.md]"]
  node_skill_rewind["Rewind Memory<br/>[SKILL.md]"]
end

node_user(("Agent User"))
node_host["Host Agent"]
node_result["Task Result"]
node_dispatch_mcp["Dispatch MCP"]
node_browser["Built-in Browser"]
node_plans_app["Plans App"]
node_local_bridge["Local App Bridge"]
node_clips_desktop[("Clips Desktop")]

node_user -->|"submits task"| node_host
node_user -->|"invokes /an"| node_an_command
node_an_command -->|"dispatches skill"| node_skill_an
node_host -->|"loads guidance"| node_skill_an
node_host -->|"loads guidance"| node_skill_webmcp
node_host -->|"loads guidance"| node_skill_visual_plan
node_host -->|"loads guidance"| node_skill_visual_recap
node_host -->|"loads guidance"| node_skill_visual_edit
node_host -->|"loads guidance"| node_skill_turn_app
node_host -->|"loads guidance"| node_skill_watchdog
node_host -->|"loads guidance"| node_skill_arbiter
node_host -->|"loads guidance"| node_skill_plow
node_host -->|"loads guidance"| node_skill_quick_recap
node_host -->|"loads guidance"| node_skill_docs
node_host -->|"loads guidance"| node_skill_limits
node_host -->|"loads guidance"| node_skill_fable
node_host -->|"loads guidance"| node_skill_frontier
node_host -->|"loads guidance"| node_skill_rewind
node_skill_an -.->|"uses MCP"| node_dispatch_mcp
node_skill_webmcp -.->|"opens browser"| node_browser
node_skill_visual_plan -.->|"renders plan"| node_plans_app
node_skill_visual_recap -.->|"renders recap"| node_plans_app
node_skill_visual_edit -.->|"connects app"| node_local_bridge
node_skill_rewind -.->|"recovers context"| node_clips_desktop
node_skill_an -->|"guides work"| node_host
node_skill_webmcp -->|"guides work"| node_host
node_skill_visual_plan -->|"guides work"| node_host
node_skill_visual_recap -->|"guides work"| node_host
node_skill_visual_edit -->|"guides work"| node_host
node_skill_turn_app -->|"guides work"| node_host
node_skill_watchdog -->|"guides work"| node_host
node_skill_arbiter -->|"guides work"| node_host
node_skill_plow -->|"guides work"| node_host
node_skill_quick_recap -->|"guides work"| node_host
node_skill_docs -->|"guides work"| node_host
node_skill_limits -->|"guides work"| node_host
node_skill_fable -->|"guides work"| node_host
node_skill_frontier -->|"guides work"| node_host
node_skill_rewind -->|"guides work"| node_host
node_host -->|"returns result"| node_result

click node_an_command "https://github.com/builderio/skills/blob/main/commands/an.md"
click node_skill_an "https://github.com/builderio/skills/blob/main/skills/an/SKILL.md"
click node_skill_webmcp "https://github.com/builderio/skills/blob/main/skills/webmcp/SKILL.md"
click node_skill_visual_plan "https://github.com/builderio/skills/blob/main/skills/visual-plan/SKILL.md"
click node_skill_visual_recap "https://github.com/builderio/skills/blob/main/skills/visual-recap/SKILL.md"
click node_skill_visual_edit "https://github.com/builderio/skills/blob/main/skills/visual-edit/SKILL.md"
click node_skill_turn_app "https://github.com/builderio/skills/blob/main/skills/turn-into-app/SKILL.md"
click node_skill_watchdog "https://github.com/builderio/skills/blob/main/skills/agent-watchdog/SKILL.md"
click node_skill_arbiter "https://github.com/builderio/skills/blob/main/skills/plan-arbiter/SKILL.md"
click node_skill_plow "https://github.com/builderio/skills/blob/main/skills/plow-ahead/SKILL.md"
click node_skill_quick_recap "https://github.com/builderio/skills/blob/main/skills/quick-recap/SKILL.md"
click node_skill_docs "https://github.com/builderio/skills/blob/main/skills/read-the-damn-docs/SKILL.md"
click node_skill_limits "https://github.com/builderio/skills/blob/main/skills/stay-within-limits/SKILL.md"
click node_skill_fable "https://github.com/builderio/skills/blob/main/skills/efficient-fable/SKILL.md"
click node_skill_frontier "https://github.com/builderio/skills/blob/main/skills/efficient-frontier/SKILL.md"
click node_skill_rewind "https://github.com/builderio/skills/blob/main/skills/rewind/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_an_command,node_skill_an,node_skill_webmcp,node_user,node_browser toneBlue
class node_skill_visual_plan,node_skill_visual_recap,node_skill_visual_edit,node_skill_turn_app,node_clips_desktop toneAmber
class node_skill_watchdog,node_skill_arbiter,node_skill_plow,node_skill_quick_recap,node_skill_docs,node_skill_limits toneMint
class node_skill_fable,node_skill_frontier,node_skill_rewind,node_result toneRose
class node_host,node_dispatch_mcp,node_plans_app,node_local_bridge toneIndigo
```

## Components

### Agent Invocation

- [AN Command](https://github.com/builderio/skills/blob/main/commands/an.md): `commands/an.md`
- [Agent-Native Apps](https://github.com/builderio/skills/blob/main/skills/an/SKILL.md): `skills/an/SKILL.md`
- [WebMCP Browser](https://github.com/builderio/skills/blob/main/skills/webmcp/SKILL.md): `skills/webmcp/SKILL.md`

### Visual Workflows

- [Visual Plans](https://github.com/builderio/skills/blob/main/skills/visual-plan/SKILL.md): `skills/visual-plan/SKILL.md`
- [Visual Recaps](https://github.com/builderio/skills/blob/main/skills/visual-recap/SKILL.md): `skills/visual-recap/SKILL.md`
- [Visual Editing](https://github.com/builderio/skills/blob/main/skills/visual-edit/SKILL.md): `skills/visual-edit/SKILL.md`
- [App Packaging](https://github.com/builderio/skills/blob/main/skills/turn-into-app/SKILL.md): `skills/turn-into-app/SKILL.md`

### Execution Discipline

- [Agent Watchdog](https://github.com/builderio/skills/blob/main/skills/agent-watchdog/SKILL.md): `skills/agent-watchdog/SKILL.md`
- [Plan Arbiter](https://github.com/builderio/skills/blob/main/skills/plan-arbiter/SKILL.md): `skills/plan-arbiter/SKILL.md`
- [Plow Ahead](https://github.com/builderio/skills/blob/main/skills/plow-ahead/SKILL.md): `skills/plow-ahead/SKILL.md`
- [Quick Recap](https://github.com/builderio/skills/blob/main/skills/quick-recap/SKILL.md): `skills/quick-recap/SKILL.md`
- [Read Docs](https://github.com/builderio/skills/blob/main/skills/read-the-damn-docs/SKILL.md): `skills/read-the-damn-docs/SKILL.md`
- [Usage Limits](https://github.com/builderio/skills/blob/main/skills/stay-within-limits/SKILL.md): `skills/stay-within-limits/SKILL.md`

### Orchestration & Memory

- [Efficient Fable](https://github.com/builderio/skills/blob/main/skills/efficient-fable/SKILL.md): `skills/efficient-fable/SKILL.md`
- [Efficient Frontier](https://github.com/builderio/skills/blob/main/skills/efficient-frontier/SKILL.md): `skills/efficient-frontier/SKILL.md`
- [Rewind Memory](https://github.com/builderio/skills/blob/main/skills/rewind/SKILL.md): `skills/rewind/SKILL.md`

### Other components

- **Agent User**
- **Host Agent**
- **Task Result**
- **Dispatch MCP**
- **Built-in Browser**
- **Plans App**
- **Local App Bridge**
- **Clips Desktop**

## Connections

- Agent User → Host Agent: submits task
- Agent User → AN Command: invokes /an
- AN Command → Agent-Native Apps: dispatches skill
- Host Agent → Agent-Native Apps: loads guidance
- Host Agent → WebMCP Browser: loads guidance
- Host Agent → Visual Plans: loads guidance
- Host Agent → Visual Recaps: loads guidance
- Host Agent → Visual Editing: loads guidance
- Host Agent → App Packaging: loads guidance
- Host Agent → Agent Watchdog: loads guidance
- Host Agent → Plan Arbiter: loads guidance
- Host Agent → Plow Ahead: loads guidance
- Host Agent → Quick Recap: loads guidance
- Host Agent → Read Docs: loads guidance
- Host Agent → Usage Limits: loads guidance
- Host Agent → Efficient Fable: loads guidance
- Host Agent → Efficient Frontier: loads guidance
- Host Agent → Rewind Memory: loads guidance
- Agent-Native Apps → Dispatch MCP: uses MCP
- WebMCP Browser → Built-in Browser: opens browser
- Visual Plans → Plans App: renders plan
- Visual Recaps → Plans App: renders recap
- Visual Editing → Local App Bridge: connects app
- Rewind Memory → Clips Desktop: recovers context
- Agent-Native Apps → Host Agent: guides work
- WebMCP Browser → Host Agent: guides work
- Visual Plans → Host Agent: guides work
- Visual Recaps → Host Agent: guides work
- Visual Editing → Host Agent: guides work
- App Packaging → Host Agent: guides work
- Agent Watchdog → Host Agent: guides work
- Plan Arbiter → Host Agent: guides work
- Plow Ahead → Host Agent: guides work
- Quick Recap → Host Agent: guides work
- Read Docs → Host Agent: guides work
- Usage Limits → Host Agent: guides work
- Efficient Fable → Host Agent: guides work
- Efficient Frontier → Host Agent: guides work
- Rewind Memory → Host Agent: guides work
- Host Agent → Task Result: returns result