← Back to Skills Marketplace
umag

swamp

by Magistr · GitHub ↗ · v0.2.0
cross-platform ⚠ suspicious
637
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install swamp
Description
Model any API with Swamp, test it, and enrich *Claw with new capabilities — full lifecycle from idea to working integration
Usage Guidance
This skill largely does what it says (it documents how to use the 'swamp' CLI to model APIs and export models into new *Claw skills), but there are a few things to check before installing or running it: - Verify the 'swamp' binary: ensure it comes from a trusted source (e.g., the official GitHub repo mentioned) and is the version you expect. The skill requires that binary to exist on PATH. - Review .claude/settings.local.json: the file that ships with the skill only whitelists a few swamp subcommands but the SKILL.md expects broad use of many commands. Confirm what commands your agent will actually be allowed to run and reconcile any permission gaps. - Be cautious with authentication flows: 'swamp auth login' may open a browser or accept username/password flags. Avoid entering credentials into unfamiliar registries; prefer browser/OAuth flows and verify the SWAMP_CLUB_URL before logging in. - Audit generated artifacts: the workflow explicitly instructs exporting models and generating SKILL.md (new skills) and pushing/pulling extensions. Always review any generated SKILL.md, extension manifest, or packaged extension before installing or publishing — these artifacts can add new capabilities to your agent. - Use least privilege and sandboxing: run initial experiments in a sandboxed environment or VM, and avoid granting broad system access or persistent install rights until you have validated the tool and its outputs. If you want a stronger conclusion, provide the actual 'swamp' binary source (checksums or install instructions) and the agent's runtime permission policy so I can re-evaluate the whitelist/permission mismatch and the potential blast radius of auto-published extensions.
Capability Analysis
Type: OpenClaw Skill Name: swamp Version: 0.2.0 The skill is classified as suspicious due to the broad capabilities granted to the AI agent, specifically the ability to interact with a remote extension registry. While the `.claude/settings.local.json` file restricts the agent to only `swamp auth` and `swamp extension` commands, these still pose significant risks. `swamp auth login` allows network communication for authentication, potentially exposing credentials if misused. More critically, `swamp extension pull` enables the agent to download arbitrary content from a remote server, and `swamp extension push` allows the agent to publish content to a public registry, creating a direct supply chain attack vector if the agent is prompted to upload malicious extensions. The `SKILL.md` also describes highly privileged operations like executing arbitrary shell commands via `swamp model method run` and publishing new skills to ClawHub, which are not currently permitted but highlight the inherent power and potential for misuse of the underlying `swamp` tool.
Capability Assessment
Purpose & Capability
Name/description match the instructions: the SKILL.md is a CLI-focused guide for modeling APIs with the 'swamp' binary and converting models into *Claw skills. Requiring the 'swamp' binary is expected. However, the included .claude/settings.local.json only whitelists a small subset of swamp commands (swamp --version, swamp auth:*, swamp extension:*), while the instructions expect broad use of many other swamp commands (model create/edit/validate/method run, workflow run, data commands). That mismatch is an incoherence to be aware of.
Instruction Scope
The SKILL.md contains many commands that create, edit, test, and publish models and extensions—and explicitly describes exporting Swamp models to generate new SKILL.md files and pushing extensions to a registry. Generating and publishing new agent skills/extensions is powerful (it can expand an agent's capabilities and add new code/files). This is coherent with the stated purpose but increases the security surface; it requires careful auditing of any generated SKILL.md or extension before enabling or publishing. Additionally, the whitelist in .claude/settings.local.json does not include many of the model/workflow commands the instructions expect to run, creating an operational inconsistency.
Install Mechanism
This is an instruction-only skill with no install spec or code files. That is low-risk from an installation standpoint — nothing will be downloaded or written by the skill itself during install.
Credentials
The skill declares no required environment variables or credentials. The SKILL.md mentions optional env vars (SWAMP_CLUB_URL) and referencing secrets via Swamp's vault (vault.get), which is consistent with the tool's expected behavior and does not demand unrelated credentials from the user.
Persistence & Privilege
The skill is not always-enabled and uses the platform-default ability to be invoked autonomously. The real privilege risk comes from the documented ability to generate and publish new *Claw skills/extensions: if an agent is permitted to create and auto-install such artifacts, its capabilities can be extended. The skill itself does not declare persistent system-wide changes, but follow-up actions (publishing/pulling extensions, writing SKILL.md files) could alter agent behavior if allowed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install swamp
  3. After installation, invoke the skill by name or use /swamp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
Swamp 0.2.0 introduces extension management and swamp-club authentication: - Added step-by-step documentation for authenticating with swamp-club, including login, custom servers, and headless flows. - Introduced new sections on pulling, pushing, listing, and removing Swamp extensions. - Outlined the extension workflow for sharing custom model types via the registry. - Provided guidance on using both models (skills) and extensions for richer sharing and collaboration. - No changes to agent usage or core modeling/test workflows.
v0.1.0
Initial release of Swamp skill for API modeling and *Claw integration - Introduces Swamp CLI-based workflow for API modeling, testing, and turning models into reusable *Claw capabilities. - Documents step-by-step processes: repo setup, model creation/editing, validation, testing, and workflow orchestration. - Details secure credential storage via Swamp vaults and integration as *Claw skills. - Provides usage examples: modeling REST/weather APIs, chaining workflows, exporting as skills. - Includes important guidance on security, troubleshooting flags, and local operation boundaries.
Metadata
Slug swamp
Version 0.2.0
License
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is swamp?

Model any API with Swamp, test it, and enrich *Claw with new capabilities — full lifecycle from idea to working integration. It is an AI Agent Skill for Claude Code / OpenClaw, with 637 downloads so far.

How do I install swamp?

Run "/install swamp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is swamp free?

Yes, swamp is completely free (open-source). You can download, install and use it at no cost.

Which platforms does swamp support?

swamp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created swamp?

It is built and maintained by Magistr (@umag); the current version is v0.2.0.

💬 Comments