skills.rest
alvagante
alvaganteCOMMUNITY
Explore all skills by this author →
Website𝕏@alvaganteGitHub

swamp-repo

Manage swamp repositories, datastores, extension sources, and CI installation via CLI.

Updated May 27, 2026
Search Tags:#ci/cd#cli#repository#datastore#swamp#extension sources#lock management
One-click install
npx skills add https://github.com/alvagante/swamp-construction-kit --skill swamp-repo-alvagante
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swamp-repo
Source: https://github.com/alvagante/swamp-construction-kit/tree/main/.agents/skills/swamp-repo
Command: npx skills add https://github.com/alvagante/swamp-construction-kit --skill swamp-repo-alvagante

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up and maintaining a swamp repository involves many moving parts: initializing the directory structure, enrolling AI agent tools, configuring datastores, resolving stuck locks, and wiring up CI. This Skill consolidates all repository lifecycle operations into guided CLI workflows with predictable JSON output. ## Core Features & Use Cases - Repository Initialization & Upgrade: Create new repos with swamp repo init, enroll multiple AI tools (Claude Code, Kiro, Cursor, and more) with repeatable --tool flags, and upgrade existing repos with replace-semantics tool management. - Datastore Management: Check status, migrate between filesystem and extension datastores (e.g., S3), sync remote data, and force-release stuck distributed locks. - Extension Sources: Load extensions from external filesystem paths via .swamp-sources.yaml with glob support and type filters, overriding pulled registry extensions during local development. - Use Case: A team wants shared runtime data in S3. Run swamp datastore setup extension @swamp/s3-datastore with bucket config, verify health with swamp datastore status, and set SWAMP_DATASTORE in CI so every runner syncs automatically. ## Quick Start Ask the agent to initialize a new swamp repository in the current directory and enroll both Claude Code and Kiro as tools.

Frequently Asked Questions about swamp-repo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize a swamp repository with multiple AI tools?▼

Run `swamp repo init --tool claude --tool kiro --json` to enroll multiple tools at once. The `--tool` flag is repeatable, each tool's scaffolding is written independently, and the first tool in the list becomes the primary tool stored in `marker.tools`.

How do I set up an S3 datastore for a swamp repository?▼

Run `swamp datastore setup extension @swamp/s3-datastore --config '{"bucket":"my-bucket","prefix":"my-project","region":"us-east-1"}' --json`. This verifies the backend, migrates local data to the remote, hydrates the local cache, and updates `.swamp.yaml`.

How do I fix a stuck datastore lock in swamp?▼

Check the lock holder with `swamp datastore lock status --json`, then run `swamp datastore lock release --force --json` to delete the lock directly. Locks also self-expire after 30 seconds, so waiting is a non-interactive option.

Can I load swamp extensions from a local development directory?▼

Yes, use `swamp extension source add <path>` to register external paths in `.swamp-sources.yaml`. Sources support globs, `~`, environment variables, and an `only` filter, and they override pulled registry extensions of the same type.

How do I install swamp in GitHub Actions CI?▼

Run `curl -fsSL https://swamp.club/install.sh | sh`, then add `$HOME/bin` to `$GITHUB_PATH`. Pin a version with `-V <version>` and override the datastore per-run using the `SWAMP_DATASTORE` environment variable.

When should I use swamp-troubleshooting instead of swamp-repo?▼

Use swamp-troubleshooting for diagnosing health check failures and `swamp doctor` output. swamp-repo covers repository lifecycle operations like init, upgrade, datastore setup, locks, and extension sources, but not diagnostic flows.

Related Skills

Explore More Software Engineering Skills→
systeminitsysteminit
530

swamp-repo

Initialize, upgrade, and configure Swamp repositories with filesystem or S3 datastores.

Official
Intermediate
systeminitsysteminit
595

swamp

Operates the swamp CLI to manage models, workflows, data, vaults, and extensions.

Official
Advanced
chujianyunchujianyun
733

hermes-ops

Diagnose and repair Hermes Agent gateway, configuration, and scheduling issues through CLI commands.

Community
Intermediate
alvagantealvagante

swamp-repo

Manage swamp repositories, datastores, extension sources, and CI installation via CLI.

Community
Advanced