Skip to main content
← Back to list
01Issue
BugShippedSwamp CLI
Assigneesstack72

#409 swamp-report skill references nonexistent `swamp model report` command

Opened by bixu · 5/22/2026· Shipped 5/22/2026

The swamp-report skill (.claude/skills/swamp-report/SKILL.md) documents a swamp model report <model> command that doesn't exist on the current CLI.

Reproduction

swamp version: 20260521.221703.0-sha.3f2b75f8 (latest per swamp update --check).

$ swamp model report hivemq-repo-policy
error: "report" is not a subcommand of "model".

  Did you mean one of these?

    swamp model get report
    swamp model method run report <method>
    swamp model validate report

The actual report-viewing command is swamp report get <report-name> --model <model> [--markdown|--json] (per swamp report --help).

Stale references in SKILL.md

5 places under .claude/skills/swamp-report/SKILL.md:

  • L34: Run reports for a model | swamp model report <model>
  • L35: Filter by label | swamp model report <model> --label cost
  • L36: Simulate method context | swamp model report <model> --method create
  • L60: "execute swamp model report <model> to confirm the report produces valid markdown and JSON output"
  • L178: "The standalone swamp model report command runs reports without executing a method."

Suggested fix

Either restore the swamp model report subcommand, or update the skill to point at swamp report get (and remove the "standalone swamp model report builds a MethodReportContext with empty dataHandles" claim under "model report (standalone)" since that's not how swamp report get works — it returns stored content, it does not re-run the report).

Impact

Agents following the skill produce a CLI error and have to guess the right command from swamp --help. Easy fix in the skill; would unblock the documented "run reports for a model" path.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORECONTRIBUTOR_NOTIFIED

Shipped

5/22/2026, 3:28:39 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack725/22/2026, 2:13:34 PM
Editable. Press Enter to edit.

stack72 commented 5/22/2026, 3:28:55 PM

Thanks @bixu for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.