Ask me what skills you need
What are you building?
Tell me what you're working on and I'll find the best agent skills for you.
Use this skill to scaffold a new agent role — generates role.json, ROLE.md, and registers the role in registry.json.
This skill walks you through creating a new agent role for the Ostwin war-room system. A role defines who the agent is, what it can do, and the prompt that shapes its behaviour.
New roles are created under contributes/roles/ at the project root. This directory is for community and dynamically-created roles. Built-in roles live under .agents/roles/ and should not be modified directly.
At install time, install.sh copies contributed roles into ~/.ostwin/.agents/roles/ and publishes the agent definition (.md file) to ~/.config/opencode/agents/<role-name>.md so the OpenCode CLI can discover and invoke the role.
Important: Always create new roles in
contributes/roles/<role-name>/. Register them in.agents/roles/registry.json. After install, the agent definition will be published to~/.config/opencode/agents/.
Every role folder contains:
| File | Required | Purpose |
|---|---|---|
role.json | ✅ | Machine-readable definition (capabilities, skills, model, timeout) |
ROLE.md | ✅ | System prompt — the agent reads this to understand its mission |
npx skills add igot-ai/os-twin --skill create-roleHow clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
Very clear and well structured, with almost no room for misunderstanding.
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
Highly actionable with clear, concrete steps that an agent can follow directly.