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

swamp-data

Manage swamp model data artifacts, versions, queries, and garbage collection via CLI.

Updated May 27, 2026
Search Tags:#cli#version history#garbage collection#data lifecycle#swamp#cel query#data artifacts
One-click install
npx skills add https://github.com/alvagante/swamp-construction-kit --skill swamp-data-alvagante
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swamp-data
Source: https://github.com/alvagante/swamp-construction-kit/tree/main/.agents/skills/swamp-data
Command: npx skills add https://github.com/alvagante/swamp-construction-kit --skill swamp-data-alvagante

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Model data accumulates across runs and versions, making it hard to find specific artifacts, clean up expired data, or inspect what a method produced. This Skill provides CLI commands to query, list, retrieve, rename, delete, and garbage-collect swamp model data using CEL predicates. ## Core Features & Use Cases - CEL-Based Data Querying: Filter data artifacts by model, type, tags, content attributes, or provenance fields, with projections via --select. - Lifecycle Management: View version history, rename data instances with forward references, delete artifacts or single versions, and run garbage collection with dry-run previews. - Workflow-Scoped Access: List or retrieve data produced by specific workflow runs without knowing the owning model. - Use Case: After running a scanner model, query all failed results with swamp data query 'attributes.status == "failed"', then preview cleanup with swamp data gc --dry-run --json before reclaiming storage. ## Quick Start Ask the AI to list all data artifacts for a model by running swamp data list with the model name and JSON output.

Frequently Asked Questions about swamp-data

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

FAQPage Schema
How do I query swamp model data with CEL predicates?▼

Use swamp data query with a CEL predicate over artifact metadata and content, such as swamp data query 'modelName == "my-model" && tags.env == "prod"'. Add --select to project specific fields from the results.

How to safely run garbage collection on swamp data?▼

Always run swamp data gc --dry-run --json first to preview which expired items will be deleted. Review the output, then run swamp data gc --json to execute, adding -f to skip the confirmation prompt in scripts.

Can I delete a single version of a data artifact?▼

Yes, swamp data delete <model> <name> --version 3 removes only that version while keeping others. Without --version, the command deletes all versions of the artifact after a confirmation prompt.

Why does my CEL expression fail with No such key: resource?▼

This error means the model has not produced data yet, or the spec and instance names in the path do not match what writeResource used. Verify data exists with swamp data list <model-name> --json before referencing it.

What happens when I rename a swamp data instance?▼

The latest version is copied to the new name and a tombstone with a forward reference is left on the old name, so old lookups resolve transparently. Historical versions remain accessible via data.version with the old name.

Related Skills

Explore More Software Engineering Skills→
systeminitsysteminit
595

swamp

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

Official
Advanced
alvagantealvagante

swamp-data

Manage swamp model data artifacts, versions, queries, and garbage collection via CLI.

Community
Advanced
alvagantealvagante

swamp-troubleshooting

Diagnose swamp CLI failures through tiered health checks, error inspection, tracing, and source reading.

Community
Advanced
systeminitsysteminit
530

swamp-troubleshooting

Inspect, fetch, and read Swamp CLI source code to diagnose bugs.

Official
Intermediate