무료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-prototype

설치 방법 보기

포함된 파일(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:

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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

adapters

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

racecraft-lab/paddock-prototype122026년 6월 26일 업데이트

chat

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

racecraft-lab/paddock-prototype122026년 6월 26일 업데이트

dashboard

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

racecraft-lab/paddock-prototype122026년 6월 26일 업데이트

github

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

racecraft-lab/paddock-prototype122026년 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/paddock-prototype122026년 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/paddock-prototype122026년 6월 26일 업데이트

racecraft-lab의 스킬 모두 보기

이 스킬의 문제 신고

설치

명령으로 설치

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

터미널에 붙여 넣고 실행합니다(Node.js 필요). Claude Code, Codex 등 설치할 에이전트를 고를 수 있습니다.

에이전트에게 부탁하기

다음 Agent Skill을 설치해 주세요.
https://github.com/racecraft-lab/paddock-prototype

먼저 SKILL.md와 첨부 파일의 내용을 확인해 수상한 처리(외부 전송, 인증 정보 읽기 등)가 없는지 확인한 뒤 Claude Code는 ~/.claude/skills/paddock/, Codex는 ~/.agents/skills/paddock/ 에 배치해 주세요.

이 문장을 그대로 Claude Code나 Codex에 보내면 내용을 확인한 뒤 설치해 줍니다.

GitHub에서 소스 보기

저장소: racecraft-lab/paddock-prototype
스타: 12
포크: 1
카테고리: 업무 효율화
라이선스: MIT
원문 언어: 영어
최종 업데이트: 2026년 6월 26일

스킬은 에이전트를 위한 지시와 스크립트의 묶음입니다. cccskills는 내용의 안전성을 보증하지 않습니다. 설치하기 전에 내용을 확인하세요.

포함된 파일(200)

SKILL.md(원문)

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

리뷰

댓글

같은 저장소의 스킬

adapters

chat

dashboard

github

gitnexus-cli

gitnexus-debugging

Agents — `/api/agents`

Tasks — `/api/tasks`

Skills — `/api/skills`

Status — `/api/status`

Adapters — `/api/adapters`