# farmage/opencode-skills architecture

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

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

## Overview

OpenCode Skills is a repository of on-demand agent skills and project workflow commands adapted for OpenCode. The main user path is a prompt matched to skill descriptions, followed by loading a skill and—when useful—its references; separate commands guide project work from discovery through planning, execution, and retrospectives. The repository also includes a documentation site. The README documents the skill-loading and workflow behavior; source excerpts are limited, so links between individual command stages and site components are not inferred.

Main entry points: [`site/src/content`](https://github.com/farmage/opencode-skills/tree/main/site/src/content) (Site Content), [`.opencode/commands/discovery`](https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/discovery) (Discovery Commands), [`.opencode/commands/planning`](https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/planning) (Planning Commands), [`.opencode/commands/execution`](https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/execution) (Execution Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Skill Library"]
  node_skill_catalog["Specialist Skills"]
  node_skill_guides["Skill References"]
end

subgraph group_workflows["Project Workflows"]
  node_common_ground["Common Ground<br/>[common-ground.md]"]
  node_discovery["Discovery Commands<br/>[discovery]"]
  node_planning["Planning Commands<br/>[planning]"]
  node_execution["Execution Commands<br/>[execution]"]
  node_retrospectives["Retrospective Commands<br/>[retrospectives]"]
end

subgraph group_integrations["External Integrations"]
  node_atlassian{{"Atlassian MCP"}}
end

subgraph group_site["Documentation Site"]
  node_site_content["Site Content"]
  node_content_sync["Content Sync<br/>[sync-content.mjs]"]
  node_site_config["Starlight Site<br/>[astro.config.mjs]"]
  node_content_collection["Docs Collection<br/>[content.config.ts]"]
end

node_user(("OpenCode User"))
node_opencode["OpenCode"]

node_user -->|"sends prompt"| node_opencode
node_opencode -->|"matches and loads"| node_skill_catalog
node_opencode -->|"loads on demand"| node_skill_guides
node_user -->|"invokes command"| node_common_ground
node_user -->|"invokes commands"| node_discovery
node_user -->|"invokes commands"| node_planning
node_user -->|"invokes commands"| node_execution
node_user -->|"invokes commands"| node_retrospectives
node_discovery -->|"integrates via MCP"| node_atlassian
node_planning -.->|"integrates via MCP"| node_atlassian
node_execution -->|"updates Jira"| node_atlassian
node_content_sync -->|"transforms content"| node_site_content
node_content_collection -->|"loads docs"| node_site_content
node_site_config -.->|"configures docs"| node_site_content

click node_skill_catalog "https://github.com/farmage/opencode-skills/tree/main/skills"
click node_skill_guides "https://github.com/farmage/opencode-skills/tree/main/skills"
click node_common_ground "https://github.com/farmage/opencode-skills/blob/main/.opencode/commands/common-ground.md"
click node_discovery "https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/discovery"
click node_planning "https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/planning"
click node_execution "https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/execution"
click node_retrospectives "https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/retrospectives"
click node_site_content "https://github.com/farmage/opencode-skills/tree/main/site/src/content"
click node_content_sync "https://github.com/farmage/opencode-skills/blob/main/site/scripts/sync-content.mjs"
click node_site_config "https://github.com/farmage/opencode-skills/blob/main/site/astro.config.mjs"
click node_content_collection "https://github.com/farmage/opencode-skills/blob/main/site/src/content.config.ts"

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_skill_catalog,node_skill_guides,node_user toneBlue
class node_common_ground,node_discovery,node_planning,node_execution,node_retrospectives toneAmber
class node_atlassian toneMint
class node_site_content,node_content_sync,node_site_config,node_content_collection toneRose
class node_opencode toneIndigo
```

## Components

### Skill Library

- [Specialist Skills](https://github.com/farmage/opencode-skills/tree/main/skills): `skills`
- [Skill References](https://github.com/farmage/opencode-skills/tree/main/skills): `skills`

### Project Workflows

- [Common Ground](https://github.com/farmage/opencode-skills/blob/main/.opencode/commands/common-ground.md): `.opencode/commands/common-ground.md`
- [Discovery Commands](https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/discovery): `.opencode/commands/discovery`
- [Planning Commands](https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/planning): `.opencode/commands/planning`
- [Execution Commands](https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/execution): `.opencode/commands/execution`
- [Retrospective Commands](https://github.com/farmage/opencode-skills/tree/main/.opencode/commands/retrospectives): `.opencode/commands/retrospectives`

### External Integrations

- **Atlassian MCP**

### Documentation Site

- [Site Content](https://github.com/farmage/opencode-skills/tree/main/site/src/content): `site/src/content`
- [Content Sync](https://github.com/farmage/opencode-skills/blob/main/site/scripts/sync-content.mjs): `site/scripts/sync-content.mjs`
- [Starlight Site](https://github.com/farmage/opencode-skills/blob/main/site/astro.config.mjs): `site/astro.config.mjs`
- [Docs Collection](https://github.com/farmage/opencode-skills/blob/main/site/src/content.config.ts): `site/src/content.config.ts`

### Other components

- **OpenCode User**
- **OpenCode**

## Connections

- OpenCode User → OpenCode: sends prompt (evidence: `README.md`)
- OpenCode → Specialist Skills: matches and loads (evidence: `README.md`)
- OpenCode → Skill References: loads on demand (evidence: `README.md`)
- OpenCode User → Common Ground: invokes command (evidence: `README.md`)
- OpenCode User → Discovery Commands: invokes commands (evidence: `README.md`)
- OpenCode User → Planning Commands: invokes commands (evidence: `README.md`)
- OpenCode User → Execution Commands: invokes commands (evidence: `README.md`)
- OpenCode User → Retrospective Commands: invokes commands (evidence: `README.md`)
- Discovery Commands → Atlassian MCP: integrates via MCP (evidence: `README.md`)
- Planning Commands → Atlassian MCP: integrates via MCP (evidence: `README.md`)
- Execution Commands → Atlassian MCP: updates Jira (evidence: `README.md`)
- Content Sync → Site Content: transforms content (evidence: `site/scripts/sync-content.mjs`)
- Docs Collection → Site Content: loads docs (evidence: `site/src/content.config.ts`)
- Starlight Site → Site Content: configures docs