mission-control-agent-integration
Umbrella skill for integrating an agent with Mission Control, the orchestration and observability control plane. Use this skill when an agent needs to interact with Mission Control and you must route
SKILL.mdSKILL.md
GitHubMission Control — Agent Integration
This skill teaches agents how to interact with Mission Control, the orchestration and observability control plane. All interactions use Convex mutations and queries — there is no REST API.
Architecture
- Database: Convex (serverless, real-time)
- Functions: Convex queries (read-only), mutations (writes), actions (external APIs)
- Real-time: All data changes are automatically pushed to connected clients
Skill Routing Table
Pick the focused skill for the job. Full API contracts live in each skill's skills/<name>/SKILL.md.
| When you need to... | Skill | Key API |
|---|---|---|
| Announce yourself before any other work | mission-control-register-agent | api.agents.register |
| Stay alive and discover pending work | mission-control-heartbeat | api.agents.heartbeat |
| Claim, create, or transition tasks | mission-control-task-lifecycle | api.tasks.assign / api.tasks.transition / api.tasks.create |
| Get sign-off for YELLOW/RED-risk actions | mission-control-request-approval | api.approvals.request |
| Submit finished work or post to task threads | mission-control-submit-deliverable | api.contentDrops.submit / api.messages.create |
| Persist knowledge across sessions | mission-control-record-memory | api.agentDocuments.upsert |
| Record spend and respect budget limits | mission-control-budget-control | api.agents.recordSpend |
| Log each execution turn | mission-control-run-logging | api.runs.create |
Key Rules
- Always send heartbeats — Missing for 2 minutes = quarantine
- Use idempotency keys — Prevent duplicate creates on retries
- Respect your budget — Check budgetRemaining in heartbeat response
- Follow the state machine — Don't skip states (INBOX → ASSIGNED → IN_PROGRESS → ...)
- Submit deliverables as content drops — Don't just complete tasks; submit the actual work
- Deposit memories — Persist important context for future sessions
- Log activities — Keep the audit trail honest
Quick Start Checklist
- Call
api.agents.registerwith your name, emoji, role, and allowed task types - Start a heartbeat loop (every 30-60 seconds)
- Check
pendingTasksandclaimableTasksin heartbeat response - Claim an INBOX task → transition to ASSIGNED → IN_PROGRESS
- Do the work, post progress messages
- Submit a content drop with the deliverable
- Transition task to REVIEW → DONE
- Deposit session memory before shutting down