essentials-claude-code

🥈Silver

Loops and swarms on Claude Code's Task System. Both enforce exit criteria. swarm is faster with parallel queue execution. Plans define what "done" means. Optional: Beads for persistent memory, Ralph TUI for dashboard.

8860Updated 1mo ago

Intermediate30min to implementautomation

Saves ~240 min per use

Quick InstallView Source

git clone https://github.com/GantisStorm/essentials-claude-code.git

Works with:

Claude

Overview

About This Skill

How to Use

1. **Define Your Plan:** Create a `plan.json` file specifying tasks, exit criteria, and parallelism. Example: ```json { "plan_name": "data_pipeline_cleanup", "tasks": ["clean_temp_files", "archive_old_logs", "validate_checksums"], "exit_criteria": "all_tasks_completed AND no_errors", "mode": "swarm", "workers": 3 } ``` 2. **Set Up Beads (Optional):** For persistent memory, initialize beads with `beads init --name backup_history`. Store task results with `beads log --key last_cleanup --value 2024-05-15`. 3. **Launch the Task System:** Run `claude code --task-system --plan plan.json --beads backup_history`. For a dashboard, use `ralph tui --dashboard backup_validation`. 4. **Monitor Progress:** Watch Ralph TUI or check logs in `./task_system/logs/`. For swarms, use `claude code --task-system --status` to see worker progress. 5. **Review Results:** After completion, analyze the output in `./task_system/results/` or query beads for historical data. Adjust plans as needed for future runs.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/GantisStorm/essentials-claude-code

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use Claude Code's Task System to automate [TASK_NAME] with a [PLAN_NAME] loop that enforces exit criteria: [EXIT_CRITERIA]. Execute tasks in [PARALLEL/SERIAL] mode using [swarm/loop]. Include [BEADS_NAME] for persistent memory if needed. Monitor progress with [Ralph TUI DASHBOARD] if available. Start with: 'Run [PLAN_NAME]'.

Example Output

### Task Automation Report: Database Backup Validation

**Plan Executed:** `db_backup_validation`
**Mode:** Parallel swarm (4 workers)
**Exit Criteria:** All backups verified with checksums matching source files
**Start Time:** 2024-05-15 08:47:23 UTC
**End Time:** 2024-05-15 08:52:11 UTC (4m48s total)

#### Task Breakdown:
1. **Backup Validation (swarm worker 1)**
   - Source: `/mnt/production/db_backups/2024-05-15_08-00.sql`
   - Checksum: `a1b2c3d4e5f6` (verified)
   - Storage: `/backup/validation/2024-05-15_08-00.sql`
   - Status: ✅ PASS

2. **Backup Validation (swarm worker 2)**
   - Source: `/mnt/production/db_backups/2024-05-15_08-15.sql`
   - Checksum: `f6e5d4c3b2a1` (verified)
   - Storage: `/backup/validation/2024-05-15_08-15.sql`
   - Status: ✅ PASS

3. **Backup Validation (swarm worker 3)**
   - Source: `/mnt/production/db_backups/2024-05-15_08-30.sql`
   - Checksum: `789abc123def` (verified)
   - Storage: `/backup/validation/2024-05-15_08-30.sql`
   - Status: ✅ PASS

4. **Backup Validation (swarm worker 4)**
   - Source: `/mnt/production/db_backups/2024-05-15_08-45.sql`
   - Checksum: `def123abc789` (verified)
   - Storage: `/backup/validation/2024-05-15_08-45.sql`
   - Status: ✅ PASS

#### Persistent Memory (Beads):
- **Last Validated Backup:** `2024-05-15_08-45.sql`
- **Failed Backups:** None
- **Total Validations:** 4

#### Ralph TUI Dashboard Summary:
```
[DB Backup Validation] | 4/4 ✅ | Duration: 4m48s | Last Run: 08:52 UTC
```

**Conclusion:** All backups validated successfully. Exit criteria met. No action required.