Agent skill

Swamp

by swamp-club in swamp-club/swamp

Swamp CLI — create and run models, build and validate workflows, query and manage data, store and retrieve vault secrets, develop and publish extensions, initialize repos, run reports, file issues…

Custom licenceAuto-check passedDevelopment

Install Swamp

skills CLI
$ npx skills add swamp-club/swamp --skill swamp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install swamp-club/swamp swamp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/swamp-club/swamp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/swamp .claude/skills/swamp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
swamp
GitHub stars
646
Token cost
~1.9k tokens
SKILL.md length
471 words
Files
130 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

Swamp CLI — create and run models, build and validate workflows, query and manage data, store and retrieve vault secrets, develop and publish extensions, initialize repos, run reports, file issues…

  • Works in 6 steps: Route — match intent to a guide in the… → Load — read the guide; load its… → Validate — before running any workflow:… → …
  • Swamp commands (swamp model
  • SKILL.md covers Core Concepts, Routing Table, Common Commands and Workflow, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Swamp is an agent skill from swamp-club/swamp. Swamp CLI — create and run models, build and validate workflows, query and manage data, store and retrieve vault secrets, develop and publish extensions, initialize repos, run reports, file issues, and troubleshoot errors. Triggers on swamp commands (swamp model, swamp workflow, swamp vault, swamp data), extension development, repo setup, or diagnostic questions. Do NOT use for getting started / onboarding (use swamp-getting-started), pull requests, git operations, worktree management, cron/agent scheduling, or…

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 135 other files, including reference files (for example `evals/guide_sufficiency_evals.json`, `evals/routing_evals.json` and `evals/trigger_evals.json`).

It sits in Development, covering Browser extensions, Secrets management and Scheduled and recurring tasks. It works with Git. The repository describes itself as: Stinemates, Watson, Adam, Mahir, Paul.

When your agent uses it

  • Swamp commands (swamp model
  • Extension development
  • Diagnostic questions
  • Getting started / onboarding (use swamp-getting-started)

Example prompts

  • “/swamp”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Route — match intent to a guide in the routing table.
  2. Load — read the guide; load its reference.md if needed, deeper
  3. Validate — before running any workflow: swamp workflow validate .
  4. Verify args — run swamp help (e.g.
  5. Execute — run the command.
  6. On failure — load

What it can do on your machine

Read from SKILL.md and the folder at commit 1b5a295. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Swamp loads about 1.9k tokens when it runs, and up to ~238k if it reads all its reference files. Until then it costs about 141 tokens; SKILL.md has 471 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~141
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~238k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 471 words (~1,902 tokens).

name
swamp

Read the full SKILL.md on GitHub

Files

SKILL.md and 129 other files (references) in .claude/skills/swamp of swamp-club/swamp.

  • SKILL.md
  • evals/guide_sufficiency_evals.json
  • evals/routing_evals.json
  • evals/trigger_evals.json
  • references/architecture/guide.md
  • references/data/guide.md
  • references/data/reference.md
  • references/data/references/concepts.md
  • references/data/references/data-ownership.md
  • references/data/references/examples.md
  • references/data/references/expressions.md
  • references/data/references/fields.md
  • references/data/references/output-shapes.md
  • references/data/references/troubleshooting.md
  • references/extension-publish/guide.md
  • … and 115 more

Open the folder on GitHubat commit 1b5a295

Compare with similar skills

Swamp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Swamp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swamp this skillswamp-club/swamp646—~1.9kAutomated safety check: PassCustom licence
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Pre-Release PR Triagejamiepine/voicebox57k—~3.1kAutomated safety check: PassMIT
Cap Feature Building WorkflowCapSoftware/Cap23k—~2.5kAutomated safety check: WarnCustom licence
Clean Complete Branchesjtenniswood/espcontrol1.1k—~820Automated safety check: PassCustom licence
BackportDependencyTrack/frontend172—~1.9kAutomated safety check: NotesApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Builds a Cap feature in an isolated Git worktree with disposable dev resources, verification, a recorded demo and a neutral pull request, started with /building.

    23k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check: warnings
  • Clean Complete Branches

    jtenniswood/espcontrol

    Clean up completed Git branches and worktrees for this repository both locally and on GitHub.

    1.1k GitHub stars~820 tokensUpdated today
    DevelopmentAuto-check passed
  • Backport

    DependencyTrack/frontend

    Backports a merged pull request from main onto a patch-release branch, e.g.

    172 GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Official

    Dev-first branching model for the Squad project: feature work branches from dev, issue branches follow a naming rule and parallel issues use git worktrees.

    1.4k GitHub starsUsed in 4 repos~1.5k tokens
    DevelopmentAuto-check passed

More from swamp-club/swamp

  • Ddd

    swamp-club/swamp

    Domain Driven Design guidance for TypeScript/Deno codebases.

    646 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • GitHub PR

    swamp-club/swamp

    Create and manage GitHub pull requests. An agent skill from swamp-club/swamp.

    646 GitHub stars~671 tokensUpdated today
    Auto-check passed
  • Swamp Getting Started

    swamp-club/swamp

    Interactive getting-started walkthrough for new swamp users.

    646 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Terminal Output

    swamp-club/swamp

    Terminal output design system for swamp CLI commands. An agent skill from swamp-club/swamp.

    646 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Issue Lifecycle

    swamp-club/swamp

    Drive the @swamp/issue-lifecycle model for interactive issue triage and plan iteration against swamp-club lab issues.

    646 GitHub stars~4.6k tokensUpdated today
    Auto-check: warnings
  • Jujutsu

    swamp-club/swamp

    Track changes, rebase modifications, resolve conflicts, and manage bookmarks with Jujutsu (jj).

    646 GitHub stars~906 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Swamp

What does Swamp do?

Swamp CLI — create and run models, build and validate workflows, query and manage data, store and retrieve vault secrets, develop and publish extensions, initialize repos, run reports, file issues…. Swamp is an agent skill from swamp-club/swamp. Swamp CLI — create and run models, build and validate workflows, query and manage data, store and retrieve vault secrets, develop and publish extensions, initialize repos, run reports, file issues, and troubleshoot errors.

When should I use Swamp?

Swamp fits situations like: swamp commands (swamp model; extension development; diagnostic questions; getting started / onboarding (use swamp-getting-started).

How do I install Swamp in Claude Code?

Run `npx skills add swamp-club/swamp --skill swamp -a claude-code`. Or copy the skill folder (.claude/skills/swamp in swamp-club/swamp) into .claude/skills/swamp in your project. Claude Code loads it when a task matches its description.

How do I install Swamp in Codex?

Run `npx skills add swamp-club/swamp --skill swamp -a codex`. Or copy the skill folder (.claude/skills/swamp in swamp-club/swamp) into .agents/skills/swamp in your project. Codex loads it when a task matches its description.

Can I use Swamp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add swamp-club/swamp --skill swamp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swamp, .gemini/skills/swamp, .github/skills/swamp and .opencode/skills/swamp in your project.

What does Swamp need to run?

SKILL.md names no scripts, command-line tools or credentials: Swamp is instructions for the agent only.

Does Swamp access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Swamp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Swamp use?

Swamp has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Swamp use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 236k tokens, read only when the agent opens those files.

What are the alternatives to Swamp?

Skills that share tags, products or a category with Swamp: Finishing a Development Branch (obra/superpowers, 297k stars), Pre-Release PR Triage (jamiepine/voicebox, 57k stars), Cap Feature Building Workflow (CapSoftware/Cap, 23k stars) and Clean Complete Branches (jtenniswood/espcontrol, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swamp?

swamp-club (a GitHub organization) maintains it in swamp-club/swamp, which has 646 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 11, 2026.

Source: swamp-club/swamp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.