How antongulin/opencode-skill-creator works
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: skill-creator.ts Plugin tools · run-loop.ts Train-test loop · improve-description.ts Description improvement · run-eval.ts Trigger evaluation
Components 18
Skill authoring
- Lifecycle guide
plugin/skill/SKILL.md - Skill validation
plugin/lib/validate.ts - Skill metadata parsing
plugin/lib/utils.ts
Evaluation
- Trigger evaluation
plugin/lib/run-eval.ts - OpenCode process runner
plugin/lib/process.ts - Failure diagnostics
plugin/lib/failure-taxonomy.ts
Optimization and review
- Train-test loop
plugin/lib/run-loop.ts - Description improvement
plugin/lib/improve-description.ts - Benchmark aggregation
plugin/lib/aggregate.ts - Gold standards
plugin/lib/gold-standards.ts - Optimization report
plugin/lib/report.ts - Eval review server
plugin/lib/review-server.ts
Plugin runtime
- Plugin tools
plugin/skill-creator.ts - Workflow guard
plugin/lib/workflow-guard.ts
Skill deployment
- Bundled skill installer
plugin/lib/skill-install.ts - Installed skill files
Other components
- Skill developer
- OpenCode
Connections 20
- Skill developer → OpenCode: requests skill work
README.md - OpenCode → Lifecycle guide: follows workflow
README.md - OpenCode → Plugin tools: invokes tools
README.md - Plugin tools → Skill validation: validates skill
plugin/skill-creator.ts - Plugin tools → Skill metadata parsing: parses metadata
plugin/skill-creator.ts - Plugin tools → Trigger evaluation: runs evaluation
plugin/skill-creator.ts - Plugin tools → Train-test loop: starts optimization
plugin/skill-creator.ts - Plugin tools → Eval review server: serves review
plugin/skill-creator.ts - Plugin tools → Bundled skill installer: installs bundled skill
plugin/skill-creator.ts - Plugin tools → Workflow guard: uses workflow guard
plugin/skill-creator.ts - Trigger evaluation → OpenCode process runner: spawns process
plugin/lib/run-eval.ts - Train-test loop → Trigger evaluation: evaluates candidates
plugin/lib/run-loop.ts - Train-test loop → Description improvement: requests improvements
plugin/lib/run-loop.ts - Description improvement → Failure diagnostics: classifies failures
plugin/lib/improve-description.ts - Description improvement → OpenCode process runner: calls OpenCode
plugin/lib/improve-description.ts - Train-test loop → Optimization report: generates report
plugin/lib/run-loop.ts - Skill developer → Benchmark aggregation: benchmarks iterations
README.md - Skill developer → Gold standards: compares standards
README.md - Skill developer → Eval review server: reviews results
README.md - Bundled skill installer → Installed skill files: copies skill files
plugin/lib/skill-install.ts