本文へ移動
cccskills
無料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.

racecraft-lab/Paddock
インストール方法を見る

含まれるファイル（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（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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:

MethodHeaderUse Case
API Keyx-api-key: <key> or Authorization: Bearer <key>Agents, scripts, CI/CD
Session cookieCookie: __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

MethodMin RoleDescription
GETviewerList agents. Query: ?status=online&role=dev&limit=50&offset=0
POSToperatorCreate agent. Body: { name, role, status?, config?, template?, session_key?, soul_content? }
PUToperatorUpdate 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

MethodMin RoleDescription
GETviewerList tasks. Query: ?status=in_progress&assigned_to=scout&priority=high&project_id=1&limit=50&offset=0
POSToperatorCreate task. Body: { title, description?, status?, priority?, assigned_to?, project_id?, tags?, metadata?, due_date?, estimated_hours? }
PUToperatorBulk 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

MethodMin RoleDescription
GETviewerList all skills across roots
GET ?mode=content&source=...&name=...viewerRead a skill's SKILL.md content
GET ?mode=check&source=...&name=...viewerRun security check on a skill
POSToperatorCreate/upsert skill. Body: { source, name, content }
PUToperatorUpdate skill content. Body: { source, name, content }
DELETE ?source=...&name=...operatorDelete a skill

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

Status — /api/status

ActionMin RoleDescription
GET ?action=overviewviewerSystem status (uptime, memory, disk, sessions)
GET ?action=dashboardviewerAggregated dashboard data with DB stats
GET ?action=gatewayviewerGateway process status and port check
GET ?action=modelsviewerAvailable AI models (catalog + local Ollama)
GET ?action=healthviewerHealth checks (gateway, disk, memory)
GET ?action=capabilitiesviewerFeature flags: gateway reachable, Claude home, subscriptions

Adapters — /api/adapters

MethodMin RoleDescription
GETviewerList available framework adapter names
POSToperatorExecute 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:

ActionRequired FieldsOptional Fields
registeragentId, namemetadata
heartbeatagentIdstatus, metrics
reporttaskId, agentIdprogress, status, output
assignmentsagentId—
disconnectagentId—

Environment Variables

VariableDefaultDescription
API_KEY—API key for agent/script authentication
OPENCLAW_GATEWAY_HOST127.0.0.1Gateway host address
OPENCLAW_GATEWAY_PORT18789Gateway port
OPENCLAW_STATE_DIR~/.openclawOpenClaw state directory
OPENCLAW_CONFIG_PATH<state-dir>/openclaw.jsonGateway config file path
MC_CLAUDE_HOME~/.claudeClaude 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.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

adapters

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

racecraft-lab/Paddock122026年6月26日 更新

chat

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

racecraft-lab/Paddock122026年6月26日 更新

dashboard

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

racecraft-lab/Paddock122026年6月26日 更新

github

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

racecraft-lab/Paddock122026年6月26日 更新

gitnexus-cli

無料

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"

日本語の概要は準備中です。原文の説明を表示しています。

racecraft-lab/Paddock122026年6月26日 更新

gitnexus-debugging

無料

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"

日本語の概要は準備中です。原文の説明を表示しています。

racecraft-lab/Paddock122026年6月26日 更新

racecraft-lab のスキルをすべて見る

このスキルの問題を報告する