# Send Speckit Swarm to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "speckit-swarm",
    "name": "Speckit Swarm",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Heldinhow/speckit-swarm",
    "canonicalUrl": "https://clawhub.ai/Heldinhow/speckit-swarm",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/speckit-swarm",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=speckit-swarm",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "src/complexity.ts",
      "src/concurrency.ts",
      "src/index.ts",
      "src/personas/explore.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/speckit-swarm"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/speckit-swarm",
    "downloadUrl": "https://openagent3.xyz/downloads/speckit-swarm",
    "agentUrl": "https://openagent3.xyz/skills/speckit-swarm/agent",
    "manifestUrl": "https://openagent3.xyz/skills/speckit-swarm/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/speckit-swarm/agent.md"
  }
}
```
## Documentation

### Overview

Native implementation of oh-my-opencode-style orchestration using OpenClaw's tools.

### Core Components

Ultrawork Detector - Detects "ulw"/"ultrawork" keywords and triggers parallel execution
Agent Personas - Specialized system prompts for different tasks
Task Planner - Breaks complex tasks into parallel chunks
Continuation Enforcer - Ensures tasks complete fully

### File Structure

skills/speckit-swarm/
├── SKILL.md                      # This file
├── src/
│   ├── ultrawork.ts              # Ultrawork detection & trigger
│   ├── personas/
│   │   ├── mod.ts               # Persona exports
│   │   ├── sisyphus.ts          # Main orchestrator
│   │   ├── hephaestus.ts        # Deep worker
│   │   ├── oracle.ts            # Design/debug
│   │   ├── librarian.ts         # Research/docs
│   │   └── explore.ts            # Fast scout
│   ├── planner.ts               # Task decomposition
│   └── index.ts                 # Main entry

### Manual Mode

# Use personas directly
sessions_spawn task:"..." model:"minimax-m2.5" thinking:"high"

### Ultrawork Mode

When user includes "ulw" or "ultrawork":

Detect keyword
Decompose task into parallel chunks
Execute with parallel_spawn
Aggregate results

### Sisyphus (Main Orchestrator)

Model: minimax-m2.5
Thinking: high
Behavior: Relentless execution, parallel coordination, todo tracking

### Hephaestus (Deep Worker)

Model: minimax-m2.5
Thinking: high
Behavior: Autonomous execution, no hand-holding, completes full scope

### Oracle (Design/Debug)

Model: minimax-m2.5
Thinking: high
Behavior: Architecture decisions, bug hunting, code review

### Librarian (Research)

Model: minimax-m2.1
Thinking: medium
Behavior: Docs lookup, code exploration, pattern finding

### Explore (Scout)

Model: minimax-m2.5-highspeed
Thinking: low
Behavior: Fast grep, file finding, quick analysis

### 1. Direct Persona Usage

import { PERSONAS, buildTaskPrompt } from './speckit-swarm';

const persona = PERSONAS.hephaestus;
const task = "Fix the login bug in auth.ts";

sessions_spawn({
  task: buildTaskPrompt({ task, persona: 'hephaestus' }),
  model: persona.config.model,
  thinking: persona.config.thinking
});

### 2. Ultrawork Mode (auto-detected)

When user includes "ulw" or "ultrawork":

import { planTask, shouldUseUltrawork } from './speckit-swarm';

const task = "ulw refactor the auth module";
if (shouldUseUltrawork(task)) {
  const plan = planTask(task);
  // Execute plan.chunks with parallel_spawn
}

### 3. Task Decomposition

import { planTask } from './speckit-swarm';

const plan = planTask("Create a new API endpoint");
// plan.chunks = [{ label: 'spec', ... }, { label: 'setup', ... }, ...]

### Ultrawork Handler

O handler detecta "ulw" automaticamente e prepara tarefas para parallel_spawn.

### Funções Exportadas

// Verifica se contém keyword ulw
containsUltrawork(task: string): boolean

// Limpa o prefixo ulw da tarefa
cleanUltraworkTask(task: string): string

// Prepara execução ultrawork
prepareUltrawork(task: string): {
  shouldExecute: boolean;
  chunks: Array<{
    label: string;
    task: string;
    model?: string;
    thinking?: string;
  }>;
  cleanedTask: string;
}

### Exemplo de Uso

// Na minha resposta, quando receber mensagem com "ulw":

const ultrawork = prepareUltrawork("ulw create a new API");

if (ultrawork.shouldExecute) {
  // Executar com parallel_spawn
  parallel_spawn({
    tasks: ultrawork.chunks,
    wait: "all"
  });
}

### Análise de Segurança de Concorrência

Antes de paralelizar, verifico se não há conflitos:

Tipo de TarefaEstratégiaCriar novo projeto/CLI/APIPARALLEL ✓Múltiplos arquivos novosPARALLEL ✓Refatorar móduloCAUTIOUS (verifica dependências)Corrigir bugSEQUENTIAL ✗Editar mesmo arquivoSEQUENTIAL ✗Tarefa simplesSINGLE

### Fluxo de Decisão

Analiso complexidade - É uma tarefa grande?
Verifico conflitos - Vai mexer no mesmo arquivo?
Decido estratégia - parallel / sequential / single

Isso evita problemas de concorrência quando múltiplos agentes tentam modificar o mesmo arquivo.

### Exemplo de Uso

// Detecção automática
const result = prepareParallelExecution("criar um novo CLI");
// result.shouldExecute = true (detectou complexidade)

if (result.shouldExecute) {
  parallel_spawn({
    tasks: result.chunks,
    wait: "all"
  });
}
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Heldinhow
- Version: 1.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/speckit-swarm)
- [Send to Agent page](https://openagent3.xyz/skills/speckit-swarm/agent)
- [JSON manifest](https://openagent3.xyz/skills/speckit-swarm/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/speckit-swarm/agent.md)
- [Download page](https://openagent3.xyz/downloads/speckit-swarm)