Skip to content
cccskills
FreePublished on GitHub

swarm

Launch and watch Guaardvark's Swarm Orchestrator: parallel coding agents, each in its own git worktree, working a markdown plan and merging back deterministically. Use when the user wants several agents on one codebase at once, says "swarm this", or asks about a running swarm, worktrees, or merge status.

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

See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Swarm with Guaardvark

Read setup first; needs the swarm plugin (POST /api/plugins/swarm/start). B=${GUAARDVARK_URL:-http://localhost:5000}. Status is also the MCP tool swarm_status.

1. Write the plan file

A markdown file in the target repo. Each ## heading is one task. Structured fields are optional; the parser infers file scope from paths in the prose when they are absent:

# Plan: split the settings page

## Extract the GPU panel
- files: frontend/src/pages/SettingsPage.jsx, frontend/src/components/settings/GpuPanel.jsx
- backend: claude
Move the GPU section into its own component with the same props.

## Add a test for the panel
- files: frontend/src/__tests__/GpuPanel.test.jsx
- depends_on: Extract the GPU panel

backend / assign to picks the agent backend (Claude Code, or a local Cline/OpenClaw agent on Ollama in Flight Mode). Tasks that touch the same files should depend on each other; the parser warns about conflicts.

2. Launch

curl -s -X POST $B/api/swarm/launch -H 'Content-Type: application/json' -d '{
  "plan_path": "/abs/path/repo/docs/plan.md", "repo_path": "/abs/path/repo",
  "max_agents": 4, "auto_merge": false, "flight_mode": false, "dry_run": false,
  "acknowledge_dirty_tree": false
}'
  • A dirty working tree is refused unless acknowledge_dirty_tree: true; tell the user what is uncommitted first.
  • self_code: true targets Guaardvark's own checkout and is only allowed on the configured root.
  • dry_run: true parses the plan and reports tasks and conflicts without starting agents.

3. Watch, merge, clean up

call
GET $B/api/swarm/status and GET $B/api/swarm/status/<swarm_id>tasks, states, worktrees
GET $B/api/swarm/<swarm_id>/logs/<task_id>?lines=100one agent's log
GET $B/api/swarm/<swarm_id>/diff/<task_id>its diff before merge
POST $B/api/swarm/<swarm_id>/bus/broadcastmessage every agent
POST $B/api/swarm/merge {"swarm_id": "...", "repo_path": "..."}merge finished branches in dependency order
POST $B/api/swarm/cancelstop
POST $B/api/swarm/cleanup {"swarm_id": "...", "delete_branches": false}remove worktrees
GET $B/api/swarm/templatessaved plan templates

Rules

  • Review diffs before merge unless the user asked for auto_merge.
  • Keep max_agents at or below the machine's capacity; each Claude agent is a separate session and each local agent competes for the GPU with generation jobs.
  • Report per task: state, files touched, whether it merged. Never say "done" on a swarm that still has running or failed tasks.

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.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

cast

Free

Build consistent characters, environments and props in Guaardvark's Cast Library and train LoRAs for them locally (reference photos → vision bible → sample plan → approved samples → training). Use when the user wants the same face or object across images, videos, a music video, or a Film Crew production, or asks to "train a LoRA".

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

guaardvark/guaardvark273Updated Oct 21, 2026

code

Free

Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function, analysis and generated rewrites, plus the System Mapper and self-improvement status. Use when the user asks where something is implemented, how modules depend on each other, or wants an architecture map of an indexed repo.

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

guaardvark/guaardvark273Updated Oct 21, 2026

Run Guaardvark's five-role Film Crew locally: screenwriter, casting (Cast Library LoRAs), cinematographer storyboards, keyframe renders, editor. Turns a logline or screenplay into a finished short video with human gates at casting and storyboard. Use when the user says "film this", "make a short film", "storyboard this script", or "start the film crew".

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

guaardvark/guaardvark273Updated Oct 21, 2026

image

Free

Generate or edit images on the user's own GPU through Guaardvark: single images, instruction edits, background cut-outs, inpaint and outpaint, consistent characters from the Cast Library, and batch runs of many prompts. Use when the user asks to create, draw, render, visualize, edit, or batch-generate images locally.

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

guaardvark/guaardvark273Updated Oct 21, 2026

Answer from the user's own indexed documents with Guaardvark's local RAG, browse and read indexed files section by section, remember facts across sessions, and process or fetch new material. Use when the user asks what their documents say, wants a source-cited answer from their files, says "remember this", or asks to index a PDF, DOCX, spreadsheet, image or URL.

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

guaardvark/guaardvark273Updated Oct 21, 2026

models

Free

Add any Hugging Face image or video model, checkpoint or LoRA to Guaardvark from a URL, list what is installed, and download registry models on request. Use when the user pastes a huggingface.co link or a .safetensors URL, asks "can it run <model>", or wants a new LoRA or checkpoint available in the Studio.

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

guaardvark/guaardvark273Updated Oct 21, 2026

See all skills by guaardvark

Report a problem with this skill