# bighadj22/opencode-skill architecture

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

- Interactive diagram: https://gitdiagram.com/bighadj22/opencode-skill
- Repository: https://github.com/bighadj22/opencode-skill

## Overview

This repository is an OpenCode skill for planning and scaffolding AI-agent teams, not a runtime agent framework. Its principal workflow starts when a project owner describes a pipeline; the skill guides planning, then creates coordinator configuration, agent and skill definitions, tools, and project instructions. Templates and OpenCode references support that work, while the example directory demonstrates a configured research-and-digest team. Relationships below follow README descriptions; source implementation details were not sampled.

Main entry points: [`SKILL.md`](https://github.com/bighadj22/opencode-skill/blob/main/SKILL.md) (Setup skill), [`example/.opencode/agents`](https://github.com/bighadj22/opencode-skill/tree/main/example/.opencode/agents) (Digest agent team), [`example/.opencode/workspace`](https://github.com/bighadj22/opencode-skill/tree/main/example/.opencode/workspace) (Digest workspace), [`example/.opencode/tools/fetch_hacker_news.ts`](https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/tools/fetch_hacker_news.ts) (Hacker News fetch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Team setup workflow"]
  node_setup_skill["Setup skill<br/>[SKILL.md]"]
  node_pipeline_plan["Pipeline planning<br/>[SKILL.md]"]
end

subgraph group_templates["Scaffold templates"]
  node_coordinator_config["Coordinator config<br/>[opencode.json]"]
  node_agent_definition["Agent definition<br/>[agent.md]"]
  node_skill_definition["Domain skill<br/>[skill.md]"]
  node_tool_py["Python tool template<br/>[tool.py]"]
  node_tool_ts["TypeScript tool wrapper<br/>[tool.ts]"]
  node_project_instructions["Project instructions<br/>[AGENTS.md]"]
  node_command_template["Command template<br/>[opencode.json]"]
end

subgraph group_guidance["OpenCode guidance"]
  node_open_code_refs["OpenCode references"]
end

subgraph group_demo["Digest example"]
  node_digest_team["Digest agent team<br/>[agents]"]
  node_research_skill["Source research<br/>[SKILL.md]"]
  node_digest_skill["Daily digest<br/>[SKILL.md]"]
  node_hn_fetch["Hacker News fetch"]
  node_article_scrape["Article scraping<br/>[scrape_articles.ts]"]
  node_digest_command["Digest command<br/>[run-digest.md]"]
  node_digest_workspace["Digest workspace<br/>[workspace]"]
end

node_owner(("Project owner"))

node_owner -->|"describes workflow"| node_setup_skill
node_setup_skill -->|"guides planning"| node_pipeline_plan
node_setup_skill -->|"generates config"| node_coordinator_config
node_setup_skill -->|"creates agents"| node_agent_definition
node_setup_skill -->|"creates skills"| node_skill_definition
node_setup_skill -->|"creates tools"| node_tool_py
node_setup_skill -->|"creates wrappers"| node_tool_ts
node_setup_skill -->|"creates instructions"| node_project_instructions
node_setup_skill -.->|"optional commands"| node_command_template
node_setup_skill -->|"uses guidance"| node_open_code_refs
node_hn_fetch -.->|"fetches data"| node_digest_workspace
node_article_scrape -.->|"scrapes articles"| node_digest_workspace
node_digest_command -.->|"runs workflow"| node_digest_team
node_digest_team -.->|"uses research"| node_research_skill
node_digest_team -.->|"uses digest guidance"| node_digest_skill

click node_setup_skill "https://github.com/bighadj22/opencode-skill/blob/main/SKILL.md"
click node_pipeline_plan "https://github.com/bighadj22/opencode-skill/blob/main/SKILL.md"
click node_coordinator_config "https://github.com/bighadj22/opencode-skill/blob/main/templates/opencode.json"
click node_agent_definition "https://github.com/bighadj22/opencode-skill/blob/main/templates/agent.md"
click node_skill_definition "https://github.com/bighadj22/opencode-skill/blob/main/templates/skill.md"
click node_tool_py "https://github.com/bighadj22/opencode-skill/blob/main/templates/tool.py"
click node_tool_ts "https://github.com/bighadj22/opencode-skill/blob/main/templates/tool.ts"
click node_project_instructions "https://github.com/bighadj22/opencode-skill/blob/main/templates/AGENTS.md"
click node_command_template "https://github.com/bighadj22/opencode-skill/blob/main/templates/opencode.json"
click node_open_code_refs "https://github.com/bighadj22/opencode-skill/tree/main/references"
click node_digest_team "https://github.com/bighadj22/opencode-skill/tree/main/example/.opencode/agents"
click node_research_skill "https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/skills/source-research/SKILL.md"
click node_digest_skill "https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/skills/daily-digest/SKILL.md"
click node_hn_fetch "https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/tools/fetch_hacker_news.ts"
click node_article_scrape "https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/tools/scrape_articles.ts"
click node_digest_command "https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/commands/run-digest.md"
click node_digest_workspace "https://github.com/bighadj22/opencode-skill/tree/main/example/.opencode/workspace"

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_setup_skill,node_pipeline_plan toneBlue
class node_coordinator_config,node_agent_definition,node_skill_definition,node_tool_py,node_tool_ts,node_project_instructions,node_command_template toneAmber
class node_open_code_refs toneMint
class node_digest_team,node_research_skill,node_digest_skill,node_hn_fetch,node_article_scrape,node_digest_command,node_digest_workspace toneRose
class node_owner toneIndigo
```

## Components

### Team setup workflow

- [Setup skill](https://github.com/bighadj22/opencode-skill/blob/main/SKILL.md): `SKILL.md`
- [Pipeline planning](https://github.com/bighadj22/opencode-skill/blob/main/SKILL.md): `SKILL.md`

### Scaffold templates

- [Coordinator config](https://github.com/bighadj22/opencode-skill/blob/main/templates/opencode.json): `templates/opencode.json`
- [Agent definition](https://github.com/bighadj22/opencode-skill/blob/main/templates/agent.md): `templates/agent.md`
- [Domain skill](https://github.com/bighadj22/opencode-skill/blob/main/templates/skill.md): `templates/skill.md`
- [Python tool template](https://github.com/bighadj22/opencode-skill/blob/main/templates/tool.py): `templates/tool.py`
- [TypeScript tool wrapper](https://github.com/bighadj22/opencode-skill/blob/main/templates/tool.ts): `templates/tool.ts`
- [Project instructions](https://github.com/bighadj22/opencode-skill/blob/main/templates/AGENTS.md): `templates/AGENTS.md`
- [Command template](https://github.com/bighadj22/opencode-skill/blob/main/templates/opencode.json): `templates/opencode.json`

### OpenCode guidance

- [OpenCode references](https://github.com/bighadj22/opencode-skill/tree/main/references): `references`

### Digest example

- [Digest agent team](https://github.com/bighadj22/opencode-skill/tree/main/example/.opencode/agents): `example/.opencode/agents`
- [Source research](https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/skills/source-research/SKILL.md): `example/.opencode/skills/source-research/SKILL.md`
- [Daily digest](https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/skills/daily-digest/SKILL.md): `example/.opencode/skills/daily-digest/SKILL.md`
- [Hacker News fetch](https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/tools/fetch_hacker_news.ts): `example/.opencode/tools/fetch_hacker_news.ts`
- [Article scraping](https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/tools/scrape_articles.ts): `example/.opencode/tools/scrape_articles.ts`
- [Digest command](https://github.com/bighadj22/opencode-skill/blob/main/example/.opencode/commands/run-digest.md): `example/.opencode/commands/run-digest.md`
- [Digest workspace](https://github.com/bighadj22/opencode-skill/tree/main/example/.opencode/workspace): `example/.opencode/workspace`

### Other components

- **Project owner**

## Connections

- Project owner → Setup skill: describes workflow (evidence: `README.md`)
- Setup skill → Pipeline planning: guides planning (evidence: `README.md`)
- Setup skill → Coordinator config: generates config (evidence: `README.md`)
- Setup skill → Agent definition: creates agents (evidence: `README.md`)
- Setup skill → Domain skill: creates skills (evidence: `README.md`)
- Setup skill → Python tool template: creates tools (evidence: `README.md`)
- Setup skill → TypeScript tool wrapper: creates wrappers (evidence: `README.md`)
- Setup skill → Project instructions: creates instructions (evidence: `README.md`)
- Setup skill → Command template: optional commands (evidence: `README.md`)
- Setup skill → OpenCode references: uses guidance (evidence: `README.md`)
- Hacker News fetch → Digest workspace: fetches data
- Article scraping → Digest workspace: scrapes articles
- Digest command → Digest agent team: runs workflow
- Digest agent team → Source research: uses research
- Digest agent team → Daily digest: uses digest guidance
