/persona-list
This skill should be used when the user asks to "list personas", "show personas", "what personas are configured", "show woterclip agents", or runs the /persona-list command. Lists all configured WoterClip personas with their runtime settings.
$ npx -y skills add wotai-dev/woterclip --skill persona-list --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/persona-list
Context preview
The summary Claude sees to decide when to auto-load this skill.
This skill should be used when the user asks to "list personas", "show personas", "what personas are configured", "show woterclip agents", or runs the /persona-list command. Lists all configured WoterClip personas with their runtime settings.
SKILL.md
persona-list.SKILL.mdname: persona-list
description: This skill should be used when the user asks to "list personas", "show personas", "what personas are configured", "show woterclip agents", or runs the /persona-list command. Lists all configured WoterClip personas with their runtime settings.
version: 0.1.0
List Personas
Display all configured WoterClip personas for this repository.
Procedure
Step 1: Load Config
Read `.woterclip/config.yaml`. If missing, report that WoterClip is not initialized and suggest `/woterclip-init`.
Step 2: Read Persona Details
For each persona in the `personas` config map:
1. Read `config.yaml` from the persona's path (`.woterclip/<persona.path>/config.yaml`) 2. Check if `SOUL.md` and `TOOLS.md` exist 3. Collect: name, role, label, model, thinking effort, max turns, escalates_to, required tools
Step 3: Format Output
WoterClip Personas
──────────────────
Name Label Model Turns Escalates Tools
Orchestrator (default) haiku 50 ceo gh
CEO ceo sonnet 100 board gh
Backend Engineer backend opus 300 ceo gh
Frontend Engineer frontend sonnet 200 ceo gh
Files:
Orchestrator: .woterclip/personas/orchestrator/ ✓ SOUL ✓ TOOLS ✓ config
CEO: .woterclip/personas/ceo/ ✓ SOUL ✓ TOOLS ✓ config
Backend: .woterclip/personas/backend/ ✓ SOUL ✓ TOOLS ✓ config
Frontend: .woterclip/personas/frontend/ ✓ SOUL ✓ TOOLS ✓ config
Flag missing files with `✗` so the user knows what needs attention.
Step 4: Suggest Actions
- If any persona has missing files, suggest fixing them
- Mention `/persona-create` for adding new personas
Read more
name: persona-list description: This skill should be used when the user asks to "list personas", "show personas", "what personas are configured", "show woterclip agents", or runs the /persona-list command. Lists all configured WoterClip personas with their runtime settings. version: 0.1.0
List Personas
Display all configured WoterClip personas for this repository.
Procedure
Step 1: Load Config
Read `.woterclip/config.yaml`. If missing, report that WoterClip is not initialized and suggest `/woterclip-init`.
Step 2: Read Persona Details
For each persona in the `personas` config map:
1. Read `config.yaml` from the persona's path (`.woterclip/<persona.path>/config.yaml`) 2. Check if `SOUL.md` and `TOOLS.md` exist 3. Collect: name, role, label, model, thinking effort, max turns, escalates_to, required tools
Step 3: Format Output
WoterClip Personas ────────────────── Name Label Model Turns Escalates Tools Orchestrator (default) haiku 50 ceo gh CEO ceo sonnet 100 board gh Backend Engineer backend opus 300 ceo gh Frontend Engineer frontend sonnet 200 ceo gh Files: Orchestrator: .woterclip/personas/orchestrator/ ✓ SOUL ✓ TOOLS ✓ config CEO: .woterclip/personas/ceo/ ✓ SOUL ✓ TOOLS ✓ config Backend: .woterclip/personas/backend/ ✓ SOUL ✓ TOOLS ✓ config Frontend: .woterclip/personas/frontend/ ✓ SOUL ✓ TOOLS ✓ config
Flag missing files with `✗` so the user knows what needs attention.
Step 4: Suggest Actions
- If any persona has missing files, suggest fixing them
- Mention `/persona-create` for adding new personas
GitHub Issues-backed agent orchestration for Claude Code. A single Claude instance wears different "hats" (personas) based on GitHub issue labels – an Orchestrator routes work, a CEO makes strategic calls, and worker personas execute.
Other skills on woterclip.
- /heartbeat-log
This skill should be used when the user asks to "show heartbeat log", "heartbeat history", "what has woterclip done", "show agent activity", "summarize heartbeats", or wants to analyze past heartbeat activity. Parses heartbeat-log.jsonl for summaries and analytics.
Open skill - /heartbeat
This skill should be used when the user asks to "run a heartbeat", "run the agent loop", "process GitHub issues", "check for work", or runs the /heartbeat command. Executes the WoterClip heartbeat — picks up GitHub issues, resolves personas, does work, and reports back.
Open skill - /init
This skill should be used when the user asks to "initialize woterclip", "set up woterclip", "woterclip init", "configure woterclip for this repo", or runs the /woterclip-init command. Scaffolds a repo with WoterClip config, persona directories, and GitHub labels.
Open skill - /persona-create
This skill should be used when the user asks to "create a persona", "add a new persona", "set up a new agent role", "add a woterclip persona", or runs the /persona-create command. Interactively creates a new WoterClip persona with SOUL.md, TOOLS.md, and config.yaml.
Open skill - /persona-import
This skill should be used when the user asks to "import a paperclip agent", "convert paperclip to woterclip", "migrate from paperclip", "import persona from paperclip", or wants to convert existing Paperclip agent directories into WoterClip persona format.
Open skill - /status
This skill should be used when the user asks to "check woterclip status", "show agent status", "what is woterclip doing", "show heartbeat status", "what's in the queue", or runs the /woterclip-status command. Shows current WoterClip state, issue queue, and blocked items.
Open skill