Skip to content
TakoAPI
Back to skills

swamp

by umag

Coding Agents & IDEs
391Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Model any API with Swamp, test it, and enrich *Claw with new capabilities — full lifecycle from idea to working.

Description

What This Skill Does

Swamp is a CLI that models external APIs and services as typed, executable definitions with methods, inputs, and vault-managed credentials. You create models, test them locally, chain them into workflows, and optionally publish them as reusable extensions or *Claw skills.

Typed model definitions with built-in validation and a credential vault prevent the drift and credential leakage common in ad-hoc shell scripts.

When to Use It

  • Wrapping a REST API into a testable agent capability
  • Chaining GitHub and Slack API calls into an automated digest workflow
  • Storing API keys in a local vault and referencing them across models
  • Publishing a custom model type to a shared team registry
  • Converting a validated model into a standalone installable skill

Example Workflow

INPUT

User asks: Fetch open GitHub issues and post a summary to Slack

AGENT
  1. 1

    Run swamp repo init --tool claude to set up the local repository

  2. 2

    Create two models: swamp model create command/shell github-issues and swamp model create command/shell slack-webhook

  3. 3

    Edit each model definition to configure methods, curl commands, and vault-referenced credentials

  4. 4

    Create a workflow with swamp workflow create issue-digest and define job dependency ordering

  5. 5

    Run swamp workflow run issue-digest and inspect results with swamp workflow history get issue-digest

OUTPUT

Workflow executes fetch and post steps in order, logs each step's output, and delivers a Slack message summarizing the open issues

Requirements

  • swamp CLI binary installed
  • Swamp-Club account (required to push extensions to the registry)

Installation

clawhub install umag/swamp

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links