FreePublished on GitHub

paddock

Interact with Paddock — AI agent orchestration dashboard. Use when registering agents, managing tasks, syncing skills, or querying agent/task status via Paddock APIs.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype

See how to install

Files included (200)

SKILL.md8.2 KB
.agents/skills/generated/adapters/SKILL.md3.8 KB
.agents/skills/generated/chat/SKILL.md3.6 KB
.agents/skills/generated/dashboard/SKILL.md4.3 KB
.agents/skills/generated/github/SKILL.md3.4 KB
.agents/skills/generated/governance/SKILL.md3.9 KB
.agents/skills/generated/health/SKILL.md3.0 KB
.agents/skills/generated/id/SKILL.md4.6 KB
.agents/skills/generated/integrations/SKILL.md2.8 KB
.agents/skills/generated/key/SKILL.md3.9 KB
.agents/skills/generated/layout/SKILL.md4.1 KB
.agents/skills/generated/observability/SKILL.md4.6 KB
.agents/skills/generated/onboarding/SKILL.md3.6 KB
.agents/skills/generated/panels/SKILL.md4.7 KB
.agents/skills/generated/scripts/SKILL.md4.1 KB
.agents/skills/generated/sessions/SKILL.md4.1 KB
.agents/skills/generated/shared/SKILL.md3.8 KB
.agents/skills/generated/store/SKILL.md2.8 KB
.agents/skills/generated/tests/SKILL.md2.9 KB
.agents/skills/generated/users/SKILL.md3.9 KB
.agents/skills/generated/workflow-contracts/SKILL.md4.2 KB
.agents/skills/gitnexus/gitnexus-cli/SKILL.md4.0 KB
.agents/skills/gitnexus/gitnexus-debugging/SKILL.md3.2 KB
.agents/skills/gitnexus/gitnexus-exploring/SKILL.md3.1 KB
.agents/skills/gitnexus/gitnexus-guide/SKILL.md3.5 KB
.agents/skills/gitnexus/gitnexus-impact-analysis/SKILL.md3.0 KB
.agents/skills/gitnexus/gitnexus-refactoring/SKILL.md4.1 KB
.agents/skills/speckit-analyze/SKILL.md10.6 KB
.agents/skills/speckit-archive-run/SKILL.md13.1 KB
.agents/skills/speckit-checklist/SKILL.md21.0 KB
.agents/skills/speckit-clarify/SKILL.md17.6 KB
.agents/skills/speckit-cleanup-run/SKILL.md15.4 KB
.agents/skills/speckit-cleanup/SKILL.md15.4 KB
.agents/skills/speckit-constitution/SKILL.md8.4 KB
.agents/skills/speckit-converge/SKILL.md11.6 KB
.agents/skills/speckit-doctor-check/SKILL.md2.1 KB
.agents/skills/speckit-doctor/SKILL.md2.0 KB
.agents/skills/speckit-git-commit/SKILL.md1.9 KB
.agents/skills/speckit-git-feature/SKILL.md3.4 KB
.agents/skills/speckit-git-initialize/SKILL.md1.7 KB
.agents/skills/speckit-git-remote/SKILL.md1.7 KB
.agents/skills/speckit-git-validate/SKILL.md1.9 KB
.agents/skills/speckit-implement/SKILL.md11.1 KB
.agents/skills/speckit-plan/SKILL.md7.2 KB
.agents/skills/speckit-retrospective-analyze/SKILL.md6.9 KB
.agents/skills/speckit-review-code/SKILL.md3.3 KB
.agents/skills/speckit-review-comments/SKILL.md5.1 KB
.agents/skills/speckit-review-errors/SKILL.md7.8 KB
.agents/skills/speckit-review-run/SKILL.md6.4 KB
.agents/skills/speckit-review-simplify/SKILL.md4.1 KB
.agents/skills/speckit-review-tests/SKILL.md4.9 KB
.agents/skills/speckit-review-types/SKILL.md5.2 KB
.agents/skills/speckit-specify/SKILL.md17.2 KB
.agents/skills/speckit-tasks/SKILL.md9.9 KB
.agents/skills/speckit-taskstoissues/SKILL.md6.4 KB
.agents/skills/speckit-verify-run/SKILL.md9.9 KB
.agents/skills/speckit-verify-tasks-run/SKILL.md14.9 KB
.agents/skills/speckit-verify-tasks/SKILL.md14.9 KB
.claude/commands/speckit-implement.md10.2 KB
.claude/commands/speckit-plan.md6.1 KB
.claude/commands/speckit-specify.md16.0 KB
.claude/commands/speckit-tasks.md9.0 KB
.claude/commands/speckit.archive.run.md13.0 KB
.claude/skills/generated/adapters/SKILL.md3.8 KB
.claude/skills/generated/chat/SKILL.md3.6 KB
.claude/skills/generated/dashboard/SKILL.md4.3 KB
.claude/skills/generated/github/SKILL.md3.4 KB
.claude/skills/generated/governance/SKILL.md3.9 KB
.claude/skills/generated/health/SKILL.md3.0 KB
.claude/skills/generated/id/SKILL.md4.6 KB
.claude/skills/generated/integrations/SKILL.md2.8 KB
.claude/skills/generated/key/SKILL.md3.9 KB
.claude/skills/generated/layout/SKILL.md4.1 KB
.claude/skills/generated/observability/SKILL.md4.6 KB
.claude/skills/generated/onboarding/SKILL.md3.6 KB
.claude/skills/generated/panels/SKILL.md4.7 KB
.claude/skills/generated/scripts/SKILL.md4.1 KB
.claude/skills/generated/sessions/SKILL.md4.1 KB
.claude/skills/generated/shared/SKILL.md3.8 KB
.claude/skills/generated/store/SKILL.md2.8 KB
.claude/skills/generated/tests/SKILL.md2.9 KB
.claude/skills/generated/users/SKILL.md3.9 KB
.claude/skills/generated/workflow-contracts/SKILL.md4.2 KB
.claude/skills/gitnexus/gitnexus-cli/SKILL.md4.0 KB
.claude/skills/gitnexus/gitnexus-debugging/SKILL.md3.2 KB
.claude/skills/gitnexus/gitnexus-exploring/SKILL.md3.1 KB
.claude/skills/gitnexus/gitnexus-guide/SKILL.md3.5 KB
.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md3.0 KB
.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md4.1 KB
.claude/skills/speckit-analyze/SKILL.md10.7 KB
.claude/skills/speckit-archive-run/SKILL.md13.2 KB
.claude/skills/speckit-checklist/SKILL.md20.5 KB
.claude/skills/speckit-clarify/SKILL.md14.5 KB
.claude/skills/speckit-cleanup-run/SKILL.md15.4 KB
.claude/skills/speckit-cleanup/SKILL.md15.5 KB
.claude/skills/speckit-constitution/SKILL.md8.5 KB
.claude/skills/speckit-doctor-check/SKILL.md2.1 KB
.claude/skills/speckit-doctor/SKILL.md2.1 KB
.claude/skills/speckit-git-commit/SKILL.md2.0 KB
.claude/skills/speckit-git-feature/SKILL.md3.4 KB
.claude/skills/speckit-git-initialize/SKILL.md1.8 KB
.claude/skills/speckit-git-remote/SKILL.md1.8 KB
.claude/skills/speckit-git-validate/SKILL.md2.0 KB
.claude/skills/speckit-implement/SKILL.md10.8 KB
.claude/skills/speckit-plan/SKILL.md6.4 KB
.claude/skills/speckit-retrospective-analyze/SKILL.md6.9 KB
.claude/skills/speckit-review-code/SKILL.md3.3 KB
.claude/skills/speckit-review-comments/SKILL.md5.1 KB
.claude/skills/speckit-review-errors/SKILL.md7.9 KB
.claude/skills/speckit-review-run/SKILL.md6.5 KB
.claude/skills/speckit-review-simplify/SKILL.md4.1 KB
.claude/skills/speckit-review-tests/SKILL.md5.0 KB
.claude/skills/speckit-review-types/SKILL.md5.3 KB
.claude/skills/speckit-specify/SKILL.md16.5 KB
.claude/skills/speckit-tasks/SKILL.md9.6 KB
.claude/skills/speckit-taskstoissues/SKILL.md4.5 KB
.claude/skills/speckit-verify-run/SKILL.md9.6 KB
.claude/skills/speckit-verify-tasks-run/SKILL.md14.9 KB
.claude/skills/speckit-verify-tasks/SKILL.md14.9 KB
.dockerignore184 B
.env.example10.0 KB
.env.test191 B
.envrc559 B
.gitattributes39 B
.github/CODEOWNERS76 B
.github/ISSUE_TEMPLATE/bug_report.md430 B
.github/ISSUE_TEMPLATE/feature_request.md426 B
.github/pull_request_template.md1.4 KB
.github/secret_scanning.yml991 B
.github/workflows/paddock-ui-e2e.yml5.1 KB
.github/workflows/quality-gate.yml1.5 KB
.github/workflows/visual-approval.yml3.9 KB
.github/workflows/visual-storybook.yml3.5 KB
.gitignore846 B
.gitnexusignore1.5 KB
.node-version3 B
.npmrc48 B
.nvmrc3 B
.specify/curated-install.json531 B
.specify/extensions.yml5.4 KB
.specify/extensions/.registry5.0 KB
.specify/extensions/archive/CHANGELOG.md2.0 KB
.specify/extensions/archive/commands/archive.md13.0 KB
.specify/extensions/archive/extension.yml717 B
.specify/extensions/archive/LICENSE1.0 KB
.specify/extensions/archive/RACECRAFT-PIN.md2.1 KB
.specify/extensions/archive/README.md4.0 KB
.specify/extensions/cleanup/.gitignore211 B
.specify/extensions/cleanup/catalog-entry.json829 B
.specify/extensions/cleanup/CHANGELOG.md888 B
.specify/extensions/cleanup/commands/cleanup.md15.5 KB
.specify/extensions/cleanup/config-template.yml929 B
.specify/extensions/cleanup/extension.yml1.3 KB
.specify/extensions/cleanup/LICENSE1.0 KB
.specify/extensions/cleanup/README.md3.7 KB
.specify/extensions/doctor/CHANGELOG.md232 B
.specify/extensions/doctor/commands/check.md1.9 KB
.specify/extensions/doctor/extension.yml719 B
.specify/extensions/doctor/README.md1.0 KB
.specify/extensions/doctor/scripts/bash/doctor.sh9.0 KB
.specify/extensions/doctor/scripts/powershell/doctor.ps18.8 KB
.specify/extensions/git/commands/speckit.git.commit.md1.8 KB
.specify/extensions/git/commands/speckit.git.feature.md3.2 KB
.specify/extensions/git/commands/speckit.git.initialize.md1.5 KB
.specify/extensions/git/commands/speckit.git.remote.md1.5 KB
.specify/extensions/git/commands/speckit.git.validate.md1.7 KB
.specify/extensions/git/config-template.yml1.9 KB
.specify/extensions/git/extension.yml4.5 KB
.specify/extensions/git/git-config.yml1.9 KB
.specify/extensions/git/README.md4.2 KB
.specify/extensions/git/scripts/bash/auto-commit.sh4.8 KB
.specify/extensions/git/scripts/bash/create-new-feature.sh16.4 KB
.specify/extensions/git/scripts/bash/git-common.sh1.7 KB
.specify/extensions/git/scripts/bash/initialize-repo.sh1.8 KB
.specify/extensions/git/scripts/powershell/auto-commit.ps14.5 KB
.specify/extensions/git/scripts/powershell/create-new-feature.ps114.3 KB
.specify/extensions/git/scripts/powershell/git-common.ps11.8 KB
.specify/extensions/git/scripts/powershell/initialize-repo.ps12.1 KB
.specify/extensions/retrospective/CHANGELOG.md327 B
.specify/extensions/retrospective/commands/retrospective.md7.2 KB
.specify/extensions/retrospective/extension.yml1.1 KB
.specify/extensions/retrospective/LICENSE1.0 KB
.specify/extensions/retrospective/logo_sk.jpeg234.3 KB
.specify/extensions/retrospective/README.md2.6 KB
.specify/extensions/review/.github/workflows/ci.yml8.4 KB
.specify/extensions/review/.gitignore424 B
.specify/extensions/review/.gitmodules381 B
.specify/extensions/review/CHANGELOG.md1.4 KB
.specify/extensions/review/commands/code.md3.2 KB
.specify/extensions/review/commands/comments.md5.0 KB
.specify/extensions/review/commands/errors.md7.7 KB
.specify/extensions/review/commands/run.md6.3 KB
.specify/extensions/review/commands/simplify.md4.0 KB
.specify/extensions/review/commands/tests.md4.8 KB
.specify/extensions/review/commands/types.md5.2 KB
.specify/extensions/review/config-template.yml687 B
.specify/extensions/review/extension.yml2.6 KB
.specify/extensions/review/LICENSE1.0 KB
.specify/extensions/review/README.md7.0 KB
.specify/extensions/review/scripts/bash/detect-changed-files.sh7.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Paddock Agent Skill

Paddock is an AI agent orchestration dashboard with real-time SSE/WebSocket, a skill registry, framework adapters, and RBAC. This skill teaches agents how to interact with Paddock APIs programmatically.

Quick Start

Base URL: http://localhost:3000 (default Next.js dev) or your deployed host.

Auth header: x-api-key: <your-api-key>

Register + heartbeat in two calls:

# 1. Register
curl -X POST http://localhost:3000/api/adapters \
  -H "Content-Type: application/json" \
  -H "x-api-key: $MC_API_KEY" \
  -d '{
    "framework": "generic",
    "action": "register",
    "payload": { "agentId": "my-agent-01", "name": "My Agent" }
  }'

# 2. Heartbeat (repeat every 5 minutes)
curl -X POST http://localhost:3000/api/adapters \
  -H "Content-Type: application/json" \
  -H "x-api-key: $MC_API_KEY" \
  -d '{
    "framework": "generic",
    "action": "heartbeat",
    "payload": { "agentId": "my-agent-01", "status": "online" }
  }'

Authentication

Paddock supports two auth methods:

Method	Header	Use Case
API Key	`x-api-key: <key>` or `Authorization: Bearer <key>`	Agents, scripts, CI/CD
Session cookie	`Cookie: __Host-mc-session=<token>` (HTTPS) or `mc-session=<token>` (HTTP)	Browser UI

Roles (hierarchical): viewer < operator < admin

viewer — Read-only access (GET endpoints)
operator — Create/update agents, tasks, skills, use adapters
admin — Full access including user management

API key auth grants admin role by default. The key is set via API_KEY env var or the security.api_key DB setting.

Agents can identify themselves with the optional X-Agent-Name header for attribution in audit logs.

Agent Lifecycle

register → heartbeat (5m interval) → fetch assignments → report task status → disconnect

All lifecycle actions go through the adapter protocol (POST /api/adapters).

1. Register

{
  "framework": "generic",
  "action": "register",
  "payload": {
    "agentId": "my-agent-01",
    "name": "My Agent",
    "metadata": { "version": "1.0", "capabilities": ["code", "review"] }
  }
}

2. Heartbeat

Send every ~5 minutes to stay marked as online.

{
  "framework": "generic",
  "action": "heartbeat",
  "payload": {
    "agentId": "my-agent-01",
    "status": "online",
    "metrics": { "tasks_completed": 5, "uptime_seconds": 3600 }
  }
}

3. Fetch Assignments

Returns up to 5 pending tasks sorted by priority (critical → low), then due date.

{
  "framework": "generic",
  "action": "assignments",
  "payload": { "agentId": "my-agent-01" }
}

Response:

{
  "assignments": [
    { "taskId": "42", "description": "Fix login bug\nUsers cannot log in with SSO", "priority": 1 }
  ],
  "framework": "generic"
}

4. Report Task Progress

{
  "framework": "generic",
  "action": "report",
  "payload": {
    "taskId": "42",
    "agentId": "my-agent-01",
    "progress": 75,
    "status": "in_progress",
    "output": "Fixed SSO handler, running tests..."
  }
}

status values: in_progress, done, failed, blocked

5. Disconnect

{
  "framework": "generic",
  "action": "disconnect",
  "payload": { "agentId": "my-agent-01" }
}

Core API Reference

Agents — `/api/agents`

Method	Min Role	Description
GET	viewer	List agents. Query: `?status=online&role=dev&limit=50&offset=0`
POST	operator	Create agent. Body: `{ name, role, status?, config?, template?, session_key?, soul_content? }`
PUT	operator	Update agent. Body: `{ name, status?, role?, config?, session_key?, soul_content?, last_activity? }`

GET response shape:

{
  "agents": [{
    "id": 1, "name": "scout", "role": "researcher", "status": "online",
    "config": {}, "taskStats": { "total": 10, "assigned": 2, "in_progress": 1, "completed": 7 }
  }],
  "total": 1, "page": 1, "limit": 50
}

Tasks — `/api/tasks`

Method	Min Role	Description
GET	viewer	List tasks. Query: `?status=in_progress&assigned_to=scout&priority=high&project_id=1&limit=50&offset=0`
POST	operator	Create task. Body: `{ title, description?, status?, priority?, assigned_to?, project_id?, tags?, metadata?, due_date?, estimated_hours? }`
PUT	operator	Bulk status update. Body: `{ tasks: [{ id, status }] }`

Priority values: critical, high, medium, low

Status values: backlog, inbox, assigned, awaiting_owner, in_progress, review, quality_review, ready_for_owner, done, failed

Note: Moving a task to done via PUT requires an Aegis quality review approval.

POST response:

{
  "task": {
    "id": 42, "title": "Fix login bug", "status": "assigned",
    "priority": "high", "assigned_to": "scout", "ticket_ref": "GEN-001",
    "tags": ["bug"], "metadata": {}
  }
}

Skills — `/api/skills`

Method	Min Role	Description
GET	viewer	List all skills across roots
GET `?mode=content&source=...&name=...`	viewer	Read a skill's SKILL.md content
GET `?mode=check&source=...&name=...`	viewer	Run security check on a skill
POST	operator	Create/upsert skill. Body: `{ source, name, content }`
PUT	operator	Update skill content. Body: `{ source, name, content }`
DELETE `?source=...&name=...`	operator	Delete a skill

Skill sources: user-agents, user-codex, project-agents, project-codex, openclaw

Status — `/api/status`

Action	Min Role	Description
GET `?action=overview`	viewer	System status (uptime, memory, disk, sessions)
GET `?action=dashboard`	viewer	Aggregated dashboard data with DB stats
GET `?action=gateway`	viewer	Gateway process status and port check
GET `?action=models`	viewer	Available AI models (catalog + local Ollama)
GET `?action=health`	viewer	Health checks (gateway, disk, memory)
GET `?action=capabilities`	viewer	Feature flags: gateway reachable, Claude home, subscriptions

Adapters — `/api/adapters`

Method	Min Role	Description
GET	viewer	List available framework adapter names
POST	operator	Execute adapter action (see Agent Lifecycle above)

Framework Adapter Protocol

All agent lifecycle operations use a single endpoint:

POST /api/adapters
Content-Type: application/json
x-api-key: <key>

{
  "framework": "<adapter-name>",
  "action": "<action>",
  "payload": { ... }
}

Available frameworks: generic, openclaw, crewai, langgraph, autogen, claude-sdk

Available actions: register, heartbeat, report, assignments, disconnect

All adapters implement the same FrameworkAdapter interface — choose the one matching your agent framework, or use generic as a universal fallback.

Payload shapes by action:

Action	Required Fields	Optional Fields
`register`	`agentId`, `name`	`metadata`
`heartbeat`	`agentId`	`status`, `metrics`
`report`	`taskId`, `agentId`	`progress`, `status`, `output`
`assignments`	`agentId`	—
`disconnect`	`agentId`	—

Environment Variables

Variable	Default	Description
`API_KEY`	—	API key for agent/script authentication
`OPENCLAW_GATEWAY_HOST`	`127.0.0.1`	Gateway host address
`OPENCLAW_GATEWAY_PORT`	`18789`	Gateway port
`OPENCLAW_STATE_DIR`	`~/.openclaw`	OpenClaw state directory
`OPENCLAW_CONFIG_PATH`	`<state-dir>/openclaw.json`	Gateway config file path
`MC_CLAUDE_HOME`	`~/.claude`	Claude home directory

Real-Time Events

Paddock broadcasts events via SSE (/api/events) and WebSocket. Key event types:

agent.created, agent.updated, agent.status_changed
task.created, task.updated, task.status_changed

Subscribe to SSE for live dashboard updates when building integrations.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

adapters

Free

Skill for the Adapters area of paddock. 108 symbols across 22 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

chat

Free

Skill for the Chat area of paddock. 62 symbols across 10 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

dashboard

Free

Skill for the Dashboard area of paddock. 80 symbols across 16 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

github

Free

Skill for the Github area of paddock. 23 symbols across 5 files.

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

gitnexus-cli

Free

Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: "Index this repo", "Reanalyze the codebase", "Generate a wiki"

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

gitnexus-debugging

Free

Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: "Why is X failing?", "Where does this error come from?", "Trace this bug"

The English summary is being prepared. Showing the original description.

racecraft-lab/paddock-prototype12Updated Jun 26, 2026

See all skills by racecraft-lab

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/racecraft-lab/paddock-prototype --skill paddock

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/racecraft-lab/paddock-prototype

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/paddock/ for Claude Code, or ~/.agents/skills/paddock/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: racecraft-lab/paddock-prototype
Stars: 12
Forks: 1
Category: Productivity
License: MIT
Original language: English
Last updated: Jun 26, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.

Files included (200)

SKILL.md (original)

Paddock Agent Skill

Quick Start

Authentication

Agent Lifecycle

1. Register

2. Heartbeat

3. Fetch Assignments

4. Report Task Progress

5. Disconnect

Core API Reference

Agents — /api/agents

Tasks — /api/tasks

Skills — /api/skills

Status — /api/status

Adapters — /api/adapters

Framework Adapter Protocol

Environment Variables

Real-Time Events

Reviews

Comments

More skills from this repository

adapters

chat

dashboard

github

gitnexus-cli

gitnexus-debugging

Agents — `/api/agents`

Tasks — `/api/tasks`

Skills — `/api/skills`

Status — `/api/status`

Adapters — `/api/adapters`