opencoven-role-creation-process

Solid

Create, validate, and activate ROLE.md specs for familiars with low-lift agentic guidance.

AI & Automation 36 stars 22 forks Updated today MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
52
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# OpenCoven Role Creation Process Use this skill when a CovenCave user wants to create, review, revise, or standardize Roles for familiars. A Role is not a plugin list. A Role is the familiar's domain-specific way of being while doing a class of work. It bundles identity context, skills, tools, workflows, plugins, and permission declarations. ## Low-Lift Agentic Flow 1. **Read the familiar.** - Load the familiar's `SOUL.md`, `IDENTITY.md`, local skill doctrine, existing Roles, and any user-provided purpose. - If the familiar has no workspace yet, create or select one before writing Roles. 2. **Decide whether a Role is actually needed.** - Use a Role for a domain-specific frame plus workflows and permissions. - Use a Skill for one reusable procedure. - Use a Workflow for one multi-step path inside an existing Role. - Use a Plugin/tool grant for capability without identity context. - Leave core identity in `SOUL.md`. 3. **Draft the Role.** - Use `templates/ROLE.md` as the starting point. - Keep the body specific enough to change behavior. - Do not duplicate the familiar's `SOUL.md`. 4. **Draft workflows.** - Every item listed in the Role's `workflows:` frontmatter should have a matching file under `workflows/<workflow-id>.md`. - Use `templates/workflow.md`. 5. **Choose canonical placement.** - Familiar-specific source of truth: `~/.coven/roles/familiars/<familiar>/<role-id>/`. - Shared global source of truth: `~/.coven/roles/glo...

Details

Author
OpenCoven
Repository
OpenCoven/coven
Created
3 months ago
Last Updated
today
Language
Rust
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category