skill/SKILL.md
Complete AI agent operating system setup with Kanban task management. Use when setting up multi-agent coordination, task tracking, or configuring an agent team. Includes theme selection (DBZ, One Piece, Marvel, etc.), workflow enforcement (all tasks through board), browser setup, GitHub integration, and memory enhancement (mem0, Supermemory, QMD).
npx skillsauth add adarshmishra07/claw-control claw-controlInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Complete setup for AI agent coordination with real-time Kanban dashboard.
If you previously installed this skill and want the latest:
npx skills add adarshmishra07/claw-control@latest
This ensures you get the newest features and fixes. Cached skill files won't auto-update otherwise.
After setup, you MUST follow these rules EVERY TIME:
sessions_spawn to delegateUser Request → Create Task → Spawn Agent → Agent Works → Review → Complete
STOP! Ask: "Did I create a task? Did I spawn an agent?" If no → Go back and do it properly.
PAUSE and enforce:
Your role is COORDINATOR. Coordinate, review, verify, ENFORCE. Never execute.
| Repo | Purpose | Direct Push? |
|------|---------|--------------|
| claw-control-trip/ | Internal testing | ✅ Yes |
| claw-control (public) | Production OSS | ❌ PR only after internal test |
Rule: Test ALL changes in claw-control-trip/ FIRST, then PR to public claw-control.
[#TASK_ID] Brief description
Example:
[#129] Add workflow enforcement to SKILL.md
If you committed without a task: CREATE ONE RETROACTIVELY and link it.
If work was done without a task on Mission Control:
completedAll significant updates go to the agent feed via POST /api/messages:
curl -X POST <BACKEND_URL>/api/messages \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{"agent_id": 1, "message": "✅ Task #X completed: Brief summary"}'
When to post:
Agent IDs (for themed teams — 8 default agents):
During heartbeats, scan for work done without tasks:
1. Check recent git commits - do they all have [#TASK_ID]?
2. Check for PRs without linked tasks
3. Check for completed work not reflected on board
4. If orphan found → CREATE TASK RETROACTIVELY
Self-Check Questions:
[#TASK_ID] in the message?"During heartbeats (2-3x daily), check for updates:
Determine deployment type:
1. Check skill version:
npx skills list | grep claw-control
2. Check for Claw Control repo updates:
cd /path/to/claw-control
git fetch origin main
git status | grep "behind"
3. If update available:
If YOU deployed it (same server):
cd /path/to/claw-control
git pull origin main
# Restart services if needed
docker-compose down && docker-compose up -d
# or restart relevant services
If USER deployed it (Railway/other):
npx skills add adarshmishra07/claw-control@latest to update, then let me know when done."Walk the human through each step. Be friendly and conversational - this is a setup wizard, not a tech manual.
Choose your deployment method:
Best for: Production self-hosting, full control, easy updates
# Clone the repo
git clone https://github.com/adarshmishra07/claw-control.git
cd claw-control
# Copy environment template
cp .env.example .env
# Edit .env with your settings (API_KEY, DATABASE_URL, etc.)
# Start everything
docker compose up -d
# View logs
docker compose logs -f
Services started:
To update:
git pull
docker compose down
docker compose up -d --build
# Migrations run automatically on startup!
Best for: Development, customization, learning the codebase
# Clone the repo
git clone https://github.com/adarshmishra07/claw-control.git
cd claw-control
# Install dependencies
npm install
# Setup database (SQLite by default for local dev)
cp .env.example .env
# Start development server
npm run dev
Services:
To update:
git pull
npm install
npm run dev
# Migrations run automatically!
Best for: Quick setup, no server management, demos
👉 railway.app/deploy/claw-control
Click the button, configure environment variables, done!
To update on Railway:
Already deployed? Share your backend URL + API key (if set).
Want me to deploy for you?
Check browser status first: browser action=status
[If browser available:]
Just say "deploy for me" - I'll handle everything!
[If no browser:]
I need either:
- 🌐 Browser access → Setup guide
- 🔑 Or a token (GitHub OR Railway):
- GitHub: github.com/settings/tokens (scopes: repo, workflow)
- Railway: railway.app/account/tokens
If user provides Railway token:
If user provides GitHub token:
Railway GraphQL deployment flow:
# Create project
mutation { projectCreate(input: { name: "claw-control" }) { id } }
# Create service from repo
mutation { serviceCreate(input: { projectId: "$ID", name: "backend", source: { repo: "adarshmishra07/claw-control" } }) { id } }
# Generate domain
mutation { domainCreate(input: { serviceId: "$ID" }) { domain } }
After deployment, collect:
YOU MUST DO THIS BEFORE PROCEEDING:
I need your Claw Control backend URL to connect.
Example: https://claw-control-backend-xxxx.up.railway.app
What's your backend URL?
Did you set an API_KEY when deploying?
If yes, share it. If no or unsure, we'll try without.
## Claw Control
- Backend URL: <their_url>
- API Key: <their_key or "none">
curl -s <BACKEND_URL>/api/agents
Without the backend URL, you CANNOT:
🧠 THIS IS THE FIRST TASK AFTER DEPLOYMENT! Don't skip this.
After Claw Control is deployed and running, your agents need persistent memory. Without this, they forget everything between sessions. mem0 + Qdrant gives them:
Step 1: Start Qdrant (Vector Database)
# Docker (recommended)
docker run -d -p 6333:6333 -p 6334:6334 \
-v qdrant_storage:/qdrant/storage \
--name qdrant \
qdrant/qdrant
Verify it's running: curl http://localhost:6333/health
Step 2: Install mem0
pip install mem0ai
Step 3: Configure mem0 with Your LLM
Create a configuration file or set environment variables. mem0 works with whatever LLM you already have:
For Anthropic (Claude):
from mem0 import Memory
config = {
"llm": {
"provider": "anthropic",
"config": {
"model": "claude-sonnet-4-20250514",
"api_key": "your-anthropic-key"
}
},
"vector_store": {
"provider": "qdrant",
"config": {
"host": "localhost",
"port": 6333
}
}
}
memory = Memory.from_config(config)
For OpenAI:
config = {
"llm": {
"provider": "openai",
"config": {
"model": "gpt-4o",
"api_key": "your-openai-key"
}
},
"vector_store": {
"provider": "qdrant",
"config": {
"host": "localhost",
"port": 6333
}
}
}
For Google (Gemini):
config = {
"llm": {
"provider": "google",
"config": {
"model": "gemini-2.0-flash",
"api_key": "your-google-key"
}
},
"vector_store": {
"provider": "qdrant",
"config": {
"host": "localhost",
"port": 6333
}
}
}
For Local LLM (Ollama):
config = {
"llm": {
"provider": "ollama",
"config": {
"model": "llama3.2",
"ollama_base_url": "http://localhost:11434"
}
},
"vector_store": {
"provider": "qdrant",
"config": {
"host": "localhost",
"port": 6333
}
}
}
Step 4: Test It Works
from mem0 import Memory
memory = Memory.from_config(config)
# Store a memory
memory.add("The user prefers TypeScript over JavaScript", user_id="adarsh")
# Search memories
results = memory.search("What languages does the user prefer?", user_id="adarsh")
print(results)
Once mem0 + Qdrant is running, update your agent spawn prompts to include memory retrieval:
# Before each agent task, retrieve relevant memories
relevant_memories = memory.search(task_description, user_id="team")
# Inject into agent context
agent_context = f"""
## Relevant Memories:
{relevant_memories}
## Current Task:
{task_description}
"""
In AGENTS.md, add:
## Memory System
All agents use mem0 + Qdrant for persistent memory.
**Before starting ANY task:**
1. Query mem0 for relevant context: `memory.search(task_summary)`
2. Include relevant memories in your working context
**After completing ANY task:**
1. Store important learnings: `memory.add(key_insights, user_id="team")`
2. Include decisions, preferences discovered, and lessons learned
Add Qdrant to your claw-control docker-compose.yml:
services:
# ... existing services ...
qdrant:
image: qdrant/qdrant
ports:
- "6333:6333"
- "6334:6334"
volumes:
- qdrant_storage:/qdrant/storage
restart: unless-stopped
volumes:
qdrant_storage:
✅ Once mem0 + Qdrant is working, your agents have real memory!
This is NOT optional — it's the foundation for agents that actually learn and improve over time.
Ask: "Now for the fun part! Let's theme your agent team. Name ANY series, movie, cartoon, anime, or show - I'll pick the perfect characters for each role!"
🎯 UNLIMITED THEMES - The user can pick ANYTHING:
Popular examples (but NOT limited to these):
| Theme | Coordinator | Developer | Architect | Research | PM | Designer | QA | Deploy | |-------|-------------|-----------|-----------|----------|-----|----------|-----|--------| | 🐉 Dragon Ball Z | Goku | Vegeta | Piccolo | Gohan | Bulma | Android 18 | Cell | Trunks | | ☠️ One Piece | Luffy | Zoro | Franky | Robin | Nami | Usopp | Jinbe | Sanji | | 🦸 Marvel | Tony | Steve | Bruce | Natasha | Pepper | Peter | Vision | Thor | | 🧪 Breaking Bad | Walter | Jesse | Mike | Gale | Lydia | Skinny Pete | Hank | Saul | | ⚔️ Game of Thrones | Jon | Arya | Tyrion | Sam | Sansa | Bran | Varys | Daenerys | | 🍥 Naruto | Naruto | Sasuke | Kakashi | Shikamaru | Tsunade | Sakura | Neji | Itachi |
When user names ANY series:
Example - User says "Avatar: The Last Airbender":
Great choice! Here's your Team Avatar:
| Role | Character | Why |
|------|-----------|-----|
| Coordinator | Aang | The Avatar, brings balance |
| Developer | Toph | Earthbender, solid foundation |
| Architect | Iroh | Wise, sees the big picture |
| Research | Sokka | Strategist, plans everything |
| PM | Katara | Waterbender, keeps things flowing |
| Designer | Suki | Kyoshi warrior, visual precision |
| QA | Azula | Perfectionist, finds every flaw |
| Deploy | Zuko | Redeemed, handles the heat |
Sound good?
⚠️ YOU MUST MAKE THESE API CALLS to actually apply the theme:
After the user picks a theme, update each agent:
# Update agent 1 (Coordinator)
curl -X PUT <BACKEND_URL>/api/agents/1 \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{"name": "Goku", "role": "Coordinator"}'
# Update agent 2 (Backend Developer)
curl -X PUT <BACKEND_URL>/api/agents/2 \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{"name": "Vegeta", "role": "Backend Engineer"}'
# Repeat for agents 3-8 with the theme characters
# Agent 3 = Architect, 4 = Research, 5 = PM, 6 = Designer, 7 = QA, 8 = Deploy
Verify changes applied:
curl -s <BACKEND_URL>/api/agents
If the response shows the new names, the theme is applied! If not, debug before proceeding.
Ask: "Who's your main character? This will be ME - the coordinator who runs the team."
Default to the coordinator from their chosen theme.
Note: You already know the human's name from USER.md - use it when creating human tasks (e.g., "🙋 @Adarsh: ...").
CRITICAL - Explain the role clearly:
As [Main Character], you're the COORDINATOR:
✅ What you DO:
- Delegate tasks to your specialists
- Review and verify their work
- Make decisions and communicate with humans
- Move tasks to "completed" after quality checks
❌ What you DON'T do:
- Execute tasks yourself (that's what your team is for!)
- Skip the board (every task gets tracked)
- Mark things complete without reviewing
Think of yourself as the team lead, not the coder.
Without browser access, agents cannot:
Ask: "Let me check if browser is configured..."
Check with: browser action=status
If not configured, STRONGLY encourage setup:
⚠️ Browser access is CRITICAL for your agents to be useful!
Without it, they literally cannot:
- 🔍 Research or look anything up
- 📸 Take screenshots to verify work
- 🌐 Interact with any web app
- ✅ Complete most real-world tasks
🚀 PLUS - Browser + GitHub Login unlocks FULL AUTOMATION:
- 🔑 Auto-create accounts on Railway, Vercel, Supermemory via GitHub OAuth
- 📋 Auto-retrieve API keys by navigating to dashboards
- ⚡ Zero-click setup - I handle EVERYTHING through the browser!
The Browser + OAuth Superpower:
When you have browser attached AND are logged into GitHub:
I can automatically set up ANY service that supports "Sign in with GitHub":
1. I navigate to the service (Railway, Supermemory, Vercel, etc.)
2. I click "Sign in with GitHub"
3. OAuth auto-authorizes (you're already logged in!)
4. I navigate to the API keys / settings page
5. I create and copy the credentials
6. I store them and configure everything
= TRUE hands-free automation!
This is the difference between:
🥇 Option 1: Chrome Extension (Best UX - Recommended)
Use your existing browser with the OpenClaw Browser Relay extension.
Why it's best:
🥈 Option 2: OpenClaw Managed Browser (Built-in)
A headless browser managed by OpenClaw - no installation needed.
Just say: "use managed browser" or use profile="openclaw" in browser commands.
Why it's good:
Limitations:
🥉 Option 3: Install Chromium Manually (Fallback)
If neither option above works, install Chromium directly:
# Ubuntu/Debian
sudo apt install chromium-browser
# macOS
brew install --cask chromium
Then restart OpenClaw and the managed browser should work.
When you need browser access, follow this priority:
Browser Priority:
1. Check if Chrome extension attached → use profile="chrome"
2. Check if managed browser available → use profile="openclaw"
3. Suggest user install Chromium if neither works
How to check:
browser action=status
Using Chrome extension (when attached):
browser action=snapshot profile="chrome"
Using managed browser:
browser action=snapshot profile="openclaw"
If an agent gets stuck because browser is unavailable:
🚫 I can't complete this task - browser access is required.
Quick fixes (try in order):
1. Click the OpenClaw extension icon in your browser toolbar
→ Make sure a tab is attached (badge shows "ON")
→ Tell me to retry with profile="chrome"
2. Say "use managed browser"
→ I'll use the built-in headless browser with profile="openclaw"
3. If managed browser fails, install Chromium:
- Ubuntu/Debian: sudo apt install chromium-browser
- macOS: brew install --cask chromium
Then restart and retry.
ALWAYS check browser status before tasks that need web access.
Ask: "Want me to handle ALL the development? With GitHub access, I can do everything - including deploying Claw Control for you!"
Why this is powerful:
With GitHub access, I become your full development team:
- 🚀 Deploy Claw Control to Railway AUTOMATICALLY
- 📦 Fork repos, create projects, manage code
- 💻 Commit and push changes
- 🔀 Handle issues and pull requests
- 🔑 Generate and configure API keys
You literally just give me GitHub access and I handle the rest.
No clicking buttons. No copying URLs. I do it all.
Setup (2 minutes):
Let's create a GitHub token:
1. Go to: github.com/settings/tokens
2. Click "Generate new token (classic)"
3. Name it: "OpenClaw Agent"
4. Select scopes: repo, workflow
5. Click "Generate token"
6. Share the token with me (starts with ghp_...)
🔐 I'll store it securely and NEVER share it.
Once I have GitHub access, I can:
This is Option C from deployment - the VIP treatment!
If they already did one-click deploy, GitHub is still useful for:
🚀 BROWSER + GITHUB OAuth = FULL AUTOMATION
With browser access + the user logged into GitHub, the bot can automatically setup ANY service that supports "Sign in with GitHub" - no manual account creation or token generation required!
The Magic Flow:
1. User is logged into GitHub in browser (Chrome extension attached)
2. Bot navigates to Railway/Supermemory/Vercel dashboard
3. Bot clicks "Sign in with GitHub"
4. OAuth authorizes automatically (user already authenticated)
5. Bot navigates to API keys / tokens page
6. Bot copies credentials directly from the dashboard
7. Done - fully automated! 🎉
What Browser + GitHub OAuth can auto-setup:
| Service | Auto-Setup? | How Bot Does It | |---------|-------------|-----------------| | Railway | ✅ YES | Navigate → GitHub OAuth → Create project → Get API token from settings | | Supermemory | ✅ YES | Navigate → GitHub OAuth → Dashboard → Copy API key | | Vercel | ✅ YES | Navigate → GitHub OAuth → Settings → Create token | | Netlify | ✅ YES | Navigate → GitHub OAuth → User settings → New token | | Supabase | ✅ YES | Navigate → GitHub OAuth → Project settings → Copy keys | | PlanetScale | ✅ YES | Navigate → GitHub OAuth → Connection strings |
What GitHub PAT alone can auto-setup (no browser needed):
| Integration | Auto-Setup? | What Bot Can Do | |-------------|-------------|-----------------| | Claw Control (fork) | ✅ Yes | Fork repo to user's GitHub automatically | | GitHub Webhooks | ✅ Yes | Configure webhooks for repos | | GitHub Actions | ✅ Yes | Enable/configure CI/CD workflows | | Repository Secrets | ✅ Yes | Manage encrypted secrets via API | | Issues/PRs | ✅ Yes | Create, manage, and track automatically |
The Three Automation Tiers:
| Tier | Requirements | What Bot Can Do | |------|--------------|-----------------| | 🥉 Basic | Nothing | Guide user step-by-step manually | | 🥈 GitHub API | GitHub PAT | Automate all GitHub operations | | 🥇 Full VIP | Browser + GitHub Login | Automate EVERYTHING via OAuth |
To unlock full automation:
When user has browser + GitHub access, the bot should:
Ask: "Let me enable automatic session memory saving..."
openclaw hooks enable session-memory
What this does:
memory/ when you use /new2026-02-06-project-discussion.mdVerify it's enabled:
openclaw hooks list
You should see 💾 session-memory with a checkmark.
Ask: "Want to supercharge my memory? I have two optional upgrades that make me way more helpful:"
⚠️ Requires Supermemory Pro or higher - The OpenClaw plugin needs a paid plan. Free tier won't work. Check pricing at supermemory.ai/pricing
What it does: Supermemory gives me persistent memory that survives across sessions. The official OpenClaw plugin handles everything automatically - zero manual work!
Why you'll love it:
Features unlocked:
/remember [text] - Manually save something to memory/recall [query] - Search your memoriessupermemory_store, supermemory_search, supermemory_forget, supermemory_profileopenclaw supermemory search/profile/wipeSetup (2 minutes):
Step 1: Get your API key
Go to console.supermemory.ai → API Keys → Create New Key
(Free tier: 1M tokens, 10K searches)
Step 2: Install the plugin
openclaw plugins install @supermemory/openclaw-supermemory
Step 3: Enable with your API key
Share your API key and I'll configure it:
openclaw config set plugins.entries.openclaw-supermemory.enabled true
openclaw config set plugins.entries.openclaw-supermemory.config.apiKey "sm_your_key_here"
Or add to ~/.openclaw/openclaw.json:
{
"plugins": {
"slots": {
"memory": "openclaw-supermemory"
},
"entries": {
"openclaw-supermemory": {
"enabled": true,
"config": {
"apiKey": "sm_...",
"autoRecall": true,
"autoCapture": true,
"maxRecallResults": 10
}
}
}
}
}
Important: The plugins.slots.memory setting tells OpenClaw to use Supermemory instead of the default memory-core plugin.
Step 4: Restart OpenClaw
openclaw gateway restart
That's it! Memory now works automatically across every conversation.
🆓 Free Alternative: memory-lancedb (Local)
If you don't want to pay for Supermemory Pro, use the built-in LanceDB plugin instead:
{
"plugins": {
"slots": {
"memory": "memory-lancedb"
},
"entries": {
"memory-lancedb": {
"enabled": true
}
}
}
}
This gives you auto-recall and auto-capture locally (no cloud, no cost).
What this enables:
Note: QMD is useful if you have lots of local markdown notes/docs you want to search. If you don't, skip this!
What it does: QMD indexes your local markdown files so I can search through your notes and documentation.
Only set this up if you:
Prerequisites:
curl -fsSL https://bun.sh/install | bash
Setup:
# Install QMD
bun install -g https://github.com/tobi/qmd
# Add your notes folder
qmd collection add ~/notes --name notes --mask "**/*.md"
# Index everything
qmd embed
# Test it
qmd search "your search query"
</details>
The bottom line:
| Feature | Without | With | |---------|---------|------| | mem0 + Qdrant | Agents forget everything between sessions | Agents have true long-term memory | | Supermemory | Manual memory management | Auto-recall and auto-capture | | QMD | I can only search the web | I can search YOUR personal knowledge base |
mem0 + Qdrant is required (Step 2). Supermemory and QMD are optional enhancements.
Agents can talk to each other through the Mission Control feed using @mentions.
Posting a mention:
curl -X POST <BACKEND_URL>/api/messages \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{
"agent_id": 1,
"message": "Hey @Vegeta, I need you to review this PR: #42"
}'
The backend parses @AgentName in the message and records which agents were mentioned.
Checking your mentions:
# Get messages where agent 2 (Vegeta) was mentioned
curl -s "<BACKEND_URL>/api/messages/mentions/2" \
-H "x-api-key: <API_KEY>"
Returns messages where the specified agent was @mentioned.
Real-time mention notifications (SSE):
# Subscribe to real-time events
curl -N "<BACKEND_URL>/api/stream"
Events emitted:
message-created — New message posted (includes mentioned_agent_ids)agent-mentioned — An agent was @mentioned (includes agent_id and message)task-created / task-updated / task-deleted — Task lifecycleagent-created / agent-updated / agent-deleted — Agent lifecycleDuring heartbeats, agents should check their mentions:
# In your agent's heartbeat routine:
def check_mentions(agent_id):
response = requests.get(
f"{BACKEND_URL}/api/messages/mentions/{agent_id}",
headers={"x-api-key": API_KEY}
)
mentions = response.json()
for mention in mentions:
if not mention.get("acknowledged"):
# Process the mention
handle_mention(mention)
# Acknowledge it (post a response)
respond_to_mention(mention)
Task handoff:
@Goku: Task #42 complete. @Vegeta please review the PR.
Asking for help:
@Piccolo: I'm designing the new auth system. What's the recommended architecture pattern?
Status update:
@Bulma: Infrastructure is ready. @Trunks you can proceed with deployment.
Blocking issue:
@Goku: I'm blocked on #45. Need @Gohan to complete the research first.
When an agent is stuck and needs human action:
Instead of just telling the user in chat, CREATE A TASK for them:
curl -X POST <BACKEND_URL>/api/tasks \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{
"title": "🙋 @{{HUMAN_NAME}}: [What you need]",
"description": "I need your help with...\n\n**Why I am stuck:**\n[Explanation]\n\n**What I need you to do:**\n1. [Step 1]\n2. [Step 2]\n\n**Once done:**\nMove this task to Done and tell me to continue.",
"status": "todo",
"agent_id": null
}'
Then tell the human:
I've hit a blocker that needs your help! 🙋
I created a task for you on the dashboard:
→ {{FRONTEND_URL}}
Check your To-Do column - there's a task tagged with your name.
Complete it and let me know when you're done!
Examples of human tasks:
This makes it a TRUE TEAM:
After collecting all info, make these updates:
scripts/update_dashboard.jsSee templates/update_dashboard.js - customize with their:
Add this section (customize for their theme):
## 🎯 Claw Control Integration
**Dashboard:** {{FRONTEND_URL}}
**API:** {{BACKEND_URL}}
### Core Rules (NON-NEGOTIABLE)
1. **{{COORDINATOR}} = Coordinator ONLY**
- Delegates tasks, never executes
- Reviews and verifies work
- Moves tasks to "completed" only after review
2. **ALL Tasks Through The Board**
- No task is too small
- Create task → Assign agent → Track progress → Review → Complete
- Workflow: backlog → todo → in_progress → review → completed
3. **Quality Gate**
- Only {{COORDINATOR}} can mark tasks complete
- Work not up to standard → back to todo with feedback
### Agent Roster (8 Default Agents)
| Agent | Role | Specialization |
|-------|------|----------------|
| {{COORDINATOR}} | Coordinator | Delegation, verification, user comms |
| {{DEVELOPER}} | Backend Engineer | APIs, databases, code reviews |
| {{ARCHITECT}} | System Architect | System design, ADRs, tech decisions |
| {{RESEARCHER}} | Research Analyst | Analysis, documentation, market research |
| {{PM}} | Product Manager | PRDs, user stories, requirements |
| {{DESIGNER}} | UI/UX Designer | User research, wireframes, visual specs |
| {{QA}} | QA Engineer | Adversarial reviews, testing, quality gates |
| {{DEPLOYMENT}} | Deployment Specialist | Releases, hotfixes, CI/CD pipelines |
### ⚡ High-Agency Protocol (ALL AGENTS)
Every agent follows this protocol BEFORE acting:
You are [ROLE] in a high-agency team. ALWAYS follow these rules BEFORE acting:
IDENTIFY subtasks and DELEGATE to relevant agents (e.g., "Delegate UI design to {{DEVOPS}}", "Delegate research to {{RESEARCH}}")
QUERY peers for input if uncertain (e.g., "Query {{ARCHITECTURE}}: Is this design sound?")
VERIFY outputs: After delegation, review responses and iterate if needed
COORDINATE via the supervisor ({{COORDINATOR}}/OpenClaw): Route all messages through Mission Control
Do NOT proceed alone—violate this and the task fails.
**Agent-Specific Adaptations:**
- **{{COORDINATOR}} (Coordinator):** Delegates ALL work, never executes. **ENFORCES team rules** — if any agent acts solo, pause and remind them to delegate/query/verify. **ENFORCES the Kanban board** — ALL work goes through the board, no exceptions.
- **{{DEVELOPER}} (Backend):** May query {{ARCHITECT}} for design, {{RESEARCHER}} for research
- **{{ARCHITECT}} (Architect):** May query {{RESEARCHER}} for research, all agents for constraints
- **{{RESEARCHER}} (Research):** May query {{ARCHITECT}} for strategic context, {{PM}} for product context
- **{{PM}} (Product Manager):** May query {{RESEARCHER}} for market data, {{DESIGNER}} for UX
- **{{DESIGNER}} (UI/UX):** May query {{ARCHITECT}} for tech constraints, {{PM}} for requirements
- **{{QA}} (QA Engineer):** Runs adversarial reviews on ALL work. MUST find 3+ issues per review.
- **{{DEPLOYMENT}} (Deployment):** May query {{DEVELOPER}} for code readiness, runs CI/CD
### Reporting Protocol
**Start of task:**
```bash
node scripts/update_dashboard.js --agent "{{AGENT}}" --status "working" --message "Starting: [Task]"
End of task:
node scripts/update_dashboard.js --agent "{{AGENT}}" --status "idle" --message "Complete: [Task]"
The Agent Feed is the heartbeat of your team. Don't let it go quiet!
Post updates for:
Example messages:
# Progress updates
node scripts/update_dashboard.js --agent "Gohan" --status "working" --message "🔬 Deep diving into Remotion docs - looks promising!"
# Wins
node scripts/update_dashboard.js --agent "Bulma" --status "idle" --message "✅ CI/CD pipeline fixed! Deploys are green again 🚀"
# Insights
node scripts/update_dashboard.js --agent "Vegeta" --status "working" --message "⚡ Found a performance bottleneck - N+1 query in tasks endpoint"
# Blockers
node scripts/update_dashboard.js --agent "Piccolo" --status "working" --message "🚧 Blocked: Need API key for external service"
Rule of thumb: If it's worth doing, it's worth posting about. The feed keeps the human informed and the team connected!
# Create task
curl -X POST $CLAW_CONTROL_URL/api/tasks \
-H "Content-Type: application/json" \
-H "x-api-key: $CLAW_CONTROL_API_KEY" \
-d '{"title": "Task name", "status": "backlog"}'
# Assign to agent
curl -X PUT $CLAW_CONTROL_URL/api/tasks/ID \
-H "Content-Type: application/json" \
-H "x-api-key: $CLAW_CONTROL_API_KEY" \
-d '{"status": "todo", "agent_id": AGENT_ID}'
### 3. Update SOUL.md (Optional but Recommended)
Add to their SOUL.md:
```markdown
## Operating Philosophy
I coordinate a team through Claw Control. I don't execute tasks directly.
**My role:** Coordinator, reviewer, quality gate
**My team:** {{AGENT_NAMES}}
**My rule:** Every task goes through the board, no exceptions
When given work:
1. Create task on Claw Control
2. Assign to appropriate specialist
3. Monitor progress
4. Review completed work
5. Only then mark complete
Before saying setup is complete, you MUST verify everything works:
curl -s <BACKEND_URL>/api/agents \
-H "x-api-key: <API_KEY>"
✅ Should return list of agents with your theme names (not "Coordinator", "Backend" defaults)
curl -X POST <BACKEND_URL>/api/tasks \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{"title": "👋 Team Introductions", "description": "Introduce the team and explain how the system works.", "status": "completed", "agent_id": 1}'
✅ Should return the created task with an ID
Post a comprehensive introduction message (customize with actual theme names):
curl -X POST <BACKEND_URL>/api/messages \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{
"agent_id": 1,
"message": "# 👋 Meet Your Team!\n\n## The Squad (8 agents)\n- **[Coordinator]** (me!) - Team lead, delegates, reviews\n- **[Developer]** - Backend APIs, databases, code reviews\n- **[Architect]** - System design, technical decisions\n- **[Researcher]** - Analysis, documentation, research\n- **[PM]** - PRDs, requirements, user stories\n- **[Designer]** - UX research, wireframes, visual specs\n- **[QA]** - Adversarial reviews, testing, quality gates\n- **[Deployment]** - Releases, hotfixes, CI/CD\n\n## How We Work\n1. All tasks go through this board\n2. I delegate to the right specialist\n3. They do the work and report back\n4. I review and mark complete\n\nReady to work! 🦞"
}'
✅ Should return the created message with mentioned_agent_ids array
# Check Qdrant is running
curl -s http://localhost:6333/health
✅ Should return {"status":"ok"}
I just completed the Team Introductions task!
Please check your dashboard: <FRONTEND_URL>
You should see:
- ✅ Your themed agent names in the sidebar
- ✅ A "👋 Team Introductions" task marked complete
- ✅ A welcome message in the feed explaining your team
Can you confirm everything looks right?
If ANY of these fail:
Only proceed to completion message after user confirms dashboard shows the test task!
After all setup AND verification:
🦞 Claw Control Setup Complete!
Dashboard: {{FRONTEND_URL}}
Coordinator: {{COORDINATOR}}
Team: {{AGENT_LIST}}
✅ Task management configured
✅ Agent behavior updated
✅ mem0 + Qdrant running - agents have long-term memory!
✅ Session memory hook enabled - conversations auto-save!
{{#if browser}}✅ Browser access ready{{/if}}
{{#if github}}✅ GitHub integration ready{{/if}}
{{#if supermemory}}✅ Supermemory connected - cloud memory active!{{/if}}
{{#if qmd}}✅ QMD search ready - I can search your docs!{{/if}}
From now on, I operate as {{COORDINATOR}}:
- All tasks go through the board
- Specialists do the work
- I coordinate, review, and verify
Let's build something awesome! What's our first task?
After setup, ALWAYS:
During every heartbeat, the coordinator should perform board hygiene AND system health checks:
Check for Misplaced Tasks:
# Fetch all tasks
curl -s <BACKEND_URL>/api/tasks -H "x-api-key: <API_KEY>"
Look for:
Fix Wrongly Placed Tasks:
# Move task to correct column
curl -X PUT <BACKEND_URL>/api/tasks/ID \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{"status": "correct_status", "agent_id": CORRECT_AGENT_ID}'
# Check if any agent mentioned you
curl -s "<BACKEND_URL>/api/messages/mentions/<your_agent_id>" \
-H "x-api-key: <API_KEY>"
If you have unacknowledged mentions, respond to them!
1. Check for Claw Control updates:
cd /path/to/claw-control
git fetch origin main
BEHIND=$(git rev-list HEAD..origin/main --count)
if [ "$BEHIND" -gt 0 ]; then
echo "⚠️ Claw Control is $BEHIND commits behind. Consider updating."
# Optionally auto-update:
# git pull && docker compose up -d --build
fi
2. Check DB migrations: Migrations run automatically on startup. If you notice schema errors, restart the app:
docker compose restart backend
# OR for local: npm run dev (restarts automatically)
3. Check skill version:
# Compare installed skill with latest
npx skills info adarshmishra07/claw-control
# If outdated:
npx skills add adarshmishra07/claw-control@latest
4. Check mem0 + Qdrant health:
curl -s http://localhost:6333/health
# Should return {"status":"ok"}
5. Auto-fix missing components: If something is broken, fix it or create a task:
docker start qdrantnpx skills add adarshmishra07/claw-control@latestCreate this file in your workspace for the coordinator to follow:
# HEARTBEAT.md - Coordinator Checklist
## Every Heartbeat (Every 30 min)
- [ ] Check board for stuck tasks
- [ ] Check my mentions and respond
- [ ] Fix any misplaced tasks
## 2-3x Daily
- [ ] Check if Claw Control needs updating (git fetch, compare commits)
- [ ] Verify Qdrant is healthy (curl health endpoint)
- [ ] Check for skill updates
- [ ] Look for orphan work (commits without task IDs)
## Auto-Fix Protocol
If something is broken:
1. Try to fix it automatically
2. If can't fix → Create a task for the right agent
3. If needs human → Create a 🙋 human task
## What to Post to Feed
- System health issues discovered
- Updates applied
- Orphan work found and retroactively logged
When this skill is re-installed or updated (npx skills add adarshmishra07/claw-control@latest), the skill should:
# Test if backend is reachable
curl -s <BACKEND_URL>/api/agents
If deployed:
If NOT deployed:
Check each component:
| Component | How to Check | If Missing |
|-----------|--------------|------------|
| Backend deployed | curl <BACKEND_URL>/api/agents | Guide deployment |
| Agents seeded | Response has 8 agents | Seed default agents |
| Theme applied | Agents have custom names | Ask for theme choice |
| mem0 + Qdrant | curl localhost:6333/health | Guide mem0 setup |
| Browser configured | browser action=status | Encourage setup |
| GitHub configured | Check TOOLS.md for token | Offer to configure |
Auto-fix (do silently):
Guide user through:
After skill update, post to feed:
curl -X POST <BACKEND_URL>/api/messages \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-d '{
"agent_id": 1,
"message": "🔄 Skill updated to latest version!\n\n**Status:**\n- ✅ Backend connected\n- ✅ 8 agents configured\n- ✅ mem0 + Qdrant running\n- ⚠️ [List any missing components]\n\n**Action needed:** [If any]"
}'
All endpoints require x-api-key header for write operations (POST/PUT/DELETE) when API_KEY is set.
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/tasks | List all tasks (filters: status, agent_id, limit, offset) |
| GET | /api/stats | Dashboard stats (activeAgents, tasksInQueue) |
| POST | /api/tasks | Create task (title required, description, status, tags[], agent_id) |
| PUT | /api/tasks/:id | Update task fields |
| DELETE | /api/tasks/:id | Delete task |
| POST | /api/tasks/:id/progress | Advance task to next status (backlog→todo→in_progress→review→completed) |
| POST | /api/tasks/:id/complete | Mark task completed directly |
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/agents | List all agents |
| GET | /api/agents/:id | Get single agent by ID |
| POST | /api/agents | Create agent (name required, role, description, status) |
| PUT | /api/agents/:id | Update agent (includes BMAD profile fields: bio, principles, dos, donts, critical_actions, communication_style, bmad_source) |
| PATCH | /api/agents/:id/status | Quick status update (idle, working, error, offline) |
| DELETE | /api/agents/:id | Delete agent |
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/messages | List messages (filters: agent_id, limit, offset) |
| POST | /api/messages | Create message (message required, agent_id). Parses @mentions automatically. |
| GET | /api/messages/mentions/:agentId | Get messages mentioning a specific agent (filters: since, limit) |
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/board | Get tasks in Kanban board format (grouped by status columns) |
| GET | /api/stream | SSE endpoint for real-time updates (?demo=true for auto-progression) |
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/webhooks | Get webhook configuration status and supported events |
| POST | /api/webhooks/reload | Reload webhook configuration from disk |
Supported webhook events: task-created, task-updated, task-deleted, message-created, agent-status-changed
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/auth/status | Check if authentication is enabled |
| GET | /api/config/status | Get configuration file status |
| POST | /api/config/reload | Reload agents from YAML config (force=true clears existing) |
| GET | /health | Health check (database status, auth status) |
When running locally, visit http://localhost:3001/docs for interactive Swagger documentation.
OpenClaw supports inline buttons for Telegram/Discord. Use them in the skill for user choices:
Theme selection example:
{
"action": "send",
"message": "Choose your team theme:",
"buttons": [
[
{"text": "🐉 Dragon Ball Z", "callback_data": "theme_dbz"},
{"text": "☠️ One Piece", "callback_data": "theme_onepiece"}
],
[
{"text": "🦸 Marvel", "callback_data": "theme_marvel"},
{"text": "🧪 Breaking Bad", "callback_data": "theme_breakingbad"}
]
]
}
Deployment choice:
{
"action": "send",
"message": "How do you want to deploy Claw Control?",
"buttons": [
[{"text": "🚂 Railway (One-Click)", "callback_data": "deploy_railway"}],
[{"text": "🐳 Docker Compose", "callback_data": "deploy_docker"}],
[{"text": "💻 Local Dev", "callback_data": "deploy_local"}]
]
}
Yes/No confirmation:
{
"action": "send",
"message": "Ready to apply the theme?",
"buttons": [[
{"text": "✅ Yes", "callback_data": "confirm_yes"},
{"text": "❌ No", "callback_data": "confirm_no"}
]]
}
SKILL.md - This filetemplates/update_dashboard.js - Status update scriptreferences/themes.md - Full theme character listsdata-ai
Mission Control (Claw Control) task and feed management for AI agents. Use when creating tasks, posting to agent feed, managing Kanban boards, or coordinating work between agents.
data-ai
Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some waiting on outside answers, and others rolling into a later summary.
data-ai
Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some waiting on outside answers, and others rolling into a later summary.
data-ai
OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.