How bighadj22/opencode-skill works
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 Setup skill · agents Digest agent team · workspace Digest workspace · fetch_hacker_news.ts Hacker News fetch
Components 18
Team setup workflow
- Setup skill
SKILL.md - Pipeline planning
SKILL.md
Scaffold templates
- Coordinator config
templates/opencode.json - Agent definition
templates/agent.md - Domain skill
templates/skill.md - Python tool template
templates/tool.py - TypeScript tool wrapper
templates/tool.ts - Project instructions
templates/AGENTS.md - Command template
templates/opencode.json
OpenCode guidance
- OpenCode references
references
Digest example
- Digest agent team
example/.opencode/agents - Source research
example/.opencode/skills/source-research/SKILL.md - Daily digest
example/.opencode/skills/daily-digest/SKILL.md - Hacker News fetch
example/.opencode/tools/fetch_hacker_news.ts - Article scraping
example/.opencode/tools/scrape_articles.ts - Digest command
example/.opencode/commands/run-digest.md - Digest workspace
example/.opencode/workspace
Other components
- Project owner
Connections 15
- Project owner → Setup skill: describes workflow
README.md - Setup skill → Pipeline planning: guides planning
README.md - Setup skill → Coordinator config: generates config
README.md - Setup skill → Agent definition: creates agents
README.md - Setup skill → Domain skill: creates skills
README.md - Setup skill → Python tool template: creates tools
README.md - Setup skill → TypeScript tool wrapper: creates wrappers
README.md - Setup skill → Project instructions: creates instructions
README.md - Setup skill → Command template: optional commands
README.md - Setup skill → OpenCode references: uses guidance
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