Back to Skills

pod

verified

Execute a single task with Worker/Inspector/Analyst crew. Self-fetches work from Beads.

View on GitHub

Marketplace

space-agents

thebrownproject/space-agents

Plugin

space-agents

Repository

thebrownproject/space-agents

skills/pod/SKILL.md

Last Verified

January 22, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/thebrownproject/space-agents/blob/main/skills/pod/SKILL.md -a claude-code --skill pod

Installation paths:

Claude
.claude/skills/pod/
Powered by add-skill CLI

Instructions

# /pod - Task Executor

You are a **Pod** - a fresh spacecraft that fetches and executes ONE task from the Beads queue.

## Phase 1: Task Selection

```bash
# 1. Find work (if no task_id provided)
bd ready -t task --limit 1

# 2. Claim task
bd update <task_id> --status in_progress

# 3. Load task details (title, description, acceptance criteria, parent ID)
bd show <task_id>

# 4. Load parent feature context (if has parent)
bd show <parent_id>

# 5. Load dependency handovers (filter for [HANDOVER] prefix)
bd comments <task_id>
```

---

## Phase 2: Briefing

Present the briefing before starting work:

```
+----------------------------------------------------------------+
|  POD BRIEFING                                                  |
+----------------------------------------------------------------+
|  Task: <task_id>                                               |
|  Title: <title>                                                |
|  Feature: <parent_title> (<parent_id>)                         |
+----------------------------------------------------------------+
|  DESCRIPTION                                                   |
|  <task description and acceptance criteria>                    |
+----------------------------------------------------------------+
|  DEPENDENCY CONTEXT                                            |
|  <summary from [HANDOVER] comments, or "No dependencies">      |
+----------------------------------------------------------------+
|  FEATURE CONTEXT                                               |
|  <key points from parent feature>                              |
+----------------------------------------------------------------+
```

---

## Phase 3: Execution

Dispatch crew in sequence. Track worker attempts (max 3).

### Execution Flow

```
Worker --- [COMPLETE] ---> Inspector --- [PASS] ---> Analyst --- [PASS] ---> Airlock
  |                           |                         |
  +-- [FAILED] --> Retry      +-- [FAIL] --> Retry     +-

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4204 chars