# antongulin/opencode-skill-creator architecture

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

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

## Overview

opencode-skill-creator is an OpenCode skill and plugin for developing skills through evaluation, optimization, benchmarking, review, and installation. The user-facing workflow is guided by the bundled skill and plugin tools: validate a skill, evaluate trigger behavior, improve its description iteratively, inspect results, then install it. The graph includes distinct runtime stages and supporting layers. Some capabilities are documented in the README but their implementations were not sampled; those relationships are marked with README evidence, and unsampled implementation details are not inferred.

Main entry points: [`plugin/skill-creator.ts`](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/skill-creator.ts) (Plugin tools), [`plugin/lib/run-loop.ts`](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/run-loop.ts) (Train-test loop), [`plugin/lib/improve-description.ts`](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/improve-description.ts) (Description improvement), [`plugin/lib/run-eval.ts`](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/run-eval.ts) (Trigger evaluation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Skill authoring"]
  node_skill_guide["Lifecycle guide<br/>[SKILL.md]"]
  node_skill_validation["Skill validation<br/>[validate.ts]"]
  node_skill_metadata["Skill metadata parsing<br/>[utils.ts]"]
end

subgraph group_evaluation["Evaluation"]
  node_eval_execution["Trigger evaluation<br/>[run-eval.ts]"]
  node_process_runner["OpenCode process runner<br/>[process.ts]"]
  node_failure_taxonomy["Failure diagnostics"]
end

subgraph group_improvement["Optimization and review"]
  node_optimization_loop["Train-test loop<br/>[run-loop.ts]"]
  node_description_improver["Description improvement"]
  node_benchmark_aggregation["Benchmark aggregation<br/>[aggregate.ts]"]
  node_gold_standards["Gold standards<br/>[gold-standards.ts]"]
  node_optimization_report["Optimization report<br/>[report.ts]"]
  node_eval_review["Eval review server<br/>[review-server.ts]"]
end

subgraph group_runtime["Plugin runtime"]
  node_plugin_entry["Plugin tools<br/>[skill-creator.ts]"]
  node_workflow_guard["Workflow guard<br/>[workflow-guard.ts]"]
end

subgraph group_deployment["Skill deployment"]
  node_skill_installer["Bundled skill installer<br/>[skill-install.ts]"]
  node_skill_files["Installed skill files"]
end

node_user(("Skill developer"))
node_opencode(("OpenCode"))

node_user -->|"requests skill work"| node_opencode
node_opencode -->|"follows workflow"| node_skill_guide
node_opencode -->|"invokes tools"| node_plugin_entry
node_plugin_entry -->|"validates skill"| node_skill_validation
node_plugin_entry -->|"parses metadata"| node_skill_metadata
node_plugin_entry -->|"runs evaluation"| node_eval_execution
node_plugin_entry -->|"starts optimization"| node_optimization_loop
node_plugin_entry -->|"serves review"| node_eval_review
node_plugin_entry -->|"installs bundled skill"| node_skill_installer
node_plugin_entry -->|"uses workflow guard"| node_workflow_guard
node_eval_execution -->|"spawns process"| node_process_runner
node_optimization_loop -->|"evaluates candidates"| node_eval_execution
node_optimization_loop -->|"requests improvements"| node_description_improver
node_description_improver -->|"classifies failures"| node_failure_taxonomy
node_description_improver -->|"calls OpenCode"| node_process_runner
node_optimization_loop -->|"generates report"| node_optimization_report
node_user -.->|"benchmarks iterations"| node_benchmark_aggregation
node_user -.->|"compares standards"| node_gold_standards
node_user -->|"reviews results"| node_eval_review
node_skill_installer -->|"copies skill files"| node_skill_files

click node_skill_guide "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/skill/SKILL.md"
click node_plugin_entry "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/skill-creator.ts"
click node_skill_validation "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/validate.ts"
click node_skill_metadata "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/utils.ts"
click node_eval_execution "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/run-eval.ts"
click node_process_runner "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/process.ts"
click node_failure_taxonomy "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/failure-taxonomy.ts"
click node_optimization_loop "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/run-loop.ts"
click node_description_improver "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/improve-description.ts"
click node_benchmark_aggregation "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/aggregate.ts"
click node_gold_standards "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/gold-standards.ts"
click node_optimization_report "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/report.ts"
click node_eval_review "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/review-server.ts"
click node_workflow_guard "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/workflow-guard.ts"
click node_skill_installer "https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/skill-install.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_guide,node_skill_validation,node_skill_metadata toneBlue
class node_eval_execution,node_process_runner,node_failure_taxonomy toneAmber
class node_optimization_loop,node_description_improver,node_benchmark_aggregation,node_gold_standards,node_optimization_report,node_eval_review toneMint
class node_plugin_entry,node_workflow_guard toneRose
class node_skill_installer,node_skill_files,node_user,node_opencode toneIndigo
```

## Components

### Skill authoring

- [Lifecycle guide](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/skill/SKILL.md): `plugin/skill/SKILL.md`
- [Skill validation](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/validate.ts): `plugin/lib/validate.ts`
- [Skill metadata parsing](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/utils.ts): `plugin/lib/utils.ts`

### Evaluation

- [Trigger evaluation](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/run-eval.ts): `plugin/lib/run-eval.ts`
- [OpenCode process runner](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/process.ts): `plugin/lib/process.ts`
- [Failure diagnostics](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/failure-taxonomy.ts): `plugin/lib/failure-taxonomy.ts`

### Optimization and review

- [Train-test loop](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/run-loop.ts): `plugin/lib/run-loop.ts`
- [Description improvement](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/improve-description.ts): `plugin/lib/improve-description.ts`
- [Benchmark aggregation](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/aggregate.ts): `plugin/lib/aggregate.ts`
- [Gold standards](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/gold-standards.ts): `plugin/lib/gold-standards.ts`
- [Optimization report](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/report.ts): `plugin/lib/report.ts`
- [Eval review server](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/review-server.ts): `plugin/lib/review-server.ts`

### Plugin runtime

- [Plugin tools](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/skill-creator.ts): `plugin/skill-creator.ts`
- [Workflow guard](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/workflow-guard.ts): `plugin/lib/workflow-guard.ts`

### Skill deployment

- [Bundled skill installer](https://github.com/antongulin/opencode-skill-creator/blob/main/plugin/lib/skill-install.ts): `plugin/lib/skill-install.ts`
- **Installed skill files**

### Other components

- **Skill developer**
- **OpenCode**

## Connections

- Skill developer → OpenCode: requests skill work (evidence: `README.md`)
- OpenCode → Lifecycle guide: follows workflow (evidence: `README.md`)
- OpenCode → Plugin tools: invokes tools (evidence: `README.md`)
- Plugin tools → Skill validation: validates skill (evidence: `plugin/skill-creator.ts`)
- Plugin tools → Skill metadata parsing: parses metadata (evidence: `plugin/skill-creator.ts`)
- Plugin tools → Trigger evaluation: runs evaluation (evidence: `plugin/skill-creator.ts`)
- Plugin tools → Train-test loop: starts optimization (evidence: `plugin/skill-creator.ts`)
- Plugin tools → Eval review server: serves review (evidence: `plugin/skill-creator.ts`)
- Plugin tools → Bundled skill installer: installs bundled skill (evidence: `plugin/skill-creator.ts`)
- Plugin tools → Workflow guard: uses workflow guard (evidence: `plugin/skill-creator.ts`)
- Trigger evaluation → OpenCode process runner: spawns process (evidence: `plugin/lib/run-eval.ts`)
- Train-test loop → Trigger evaluation: evaluates candidates (evidence: `plugin/lib/run-loop.ts`)
- Train-test loop → Description improvement: requests improvements (evidence: `plugin/lib/run-loop.ts`)
- Description improvement → Failure diagnostics: classifies failures (evidence: `plugin/lib/improve-description.ts`)
- Description improvement → OpenCode process runner: calls OpenCode (evidence: `plugin/lib/improve-description.ts`)
- Train-test loop → Optimization report: generates report (evidence: `plugin/lib/run-loop.ts`)
- Skill developer → Benchmark aggregation: benchmarks iterations (evidence: `README.md`)
- Skill developer → Gold standards: compares standards (evidence: `README.md`)
- Skill developer → Eval review server: reviews results (evidence: `README.md`)
- Bundled skill installer → Installed skill files: copies skill files (evidence: `plugin/lib/skill-install.ts`)
