Building Custom Agents
Build custom OpenSIN agents from the current canonical stack, not from legacy or duplicate repos.
Before You Start
Read these first:
Prerequisites
- Node.js 20+
- Bun
- GitHub account
- OpenCode CLI available
Fastest Path
If you need a new standalone agent repo, start from the canonical template:
bash
gh repo create OpenSIN-AI/my-new-agent \
--template OpenSIN-AI/Template-SIN-Agent \
--public
cd my-new-agent
bun installIMPORTANT
Many new agent ideas should not become standalone repos. First verify whether the work belongs inside an existing Team-SIN-* monorepo.
Required Files
Every production-grade agent should expose a clean public contract:
agent.json.well-known/agent-card.jsonAGENTS.md- governance files required by the template
Validation Checklist
Before publishing an agent:
bun run buildsucceeds- the agent card is valid and reachable
- the repo ownership is canonical
- docs link to the correct surface
- no internal-only endpoints are exposed in public docs