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

Relationships

#1100 Missing reference files from bundled swamp skill

Opened by jrh · 7/11/2026· Shipped 7/11/2026

The skill installed by swamp repo upgrade references several files that aren't included in the bundle. For example, SKILL.md links to references/architecture/guide.md, but that file is missing from ~/.agents/skills/swamp.

I found four missing files:

  • references/architecture/guide.md
  • references/serve/guide.md
  • references/model/references/disposable-instances.md
  • references/repo/references/namespaces.md

It looks like these exist in .claude/skills/swamp but are missing from BUNDLED_SKILLS in skill_assets.ts.

My clanker suggested a test that confirms all files are bundled:

Deno.test("SkillAssets.listSkills includes every swamp markdown file", async () => {
  const assets = new SkillAssets();
  const skillsDir = assets.getSkillsDir();
  const swampDir = join(skillsDir, "swamp");
  const sourcePaths: string[] = [];

  for await (
    const entry of walk(swampDir, {
      includeDirs: false,
      exts: [".md"],
    })
  ) {
    const relativePath = relative(skillsDir, entry.path).split(SEPARATOR).join(
      "/",
    );
    sourcePaths.push(relativePath);
  }

  const bundledPaths = assets.listSkills()
    .filter((skill) => skill.name === "swamp")
    .map((skill) => skill.relativePath);

  assertEquals(bundledPaths.toSorted(), sourcePaths.toSorted());
});
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 2 MORETRIAGE+ 3 MORECLASSIFICATION+ 4 MOREPR_MERGED+ 1 MORECONTRIBUTOR_NOTIFIED

Shipped

7/11/2026, 11:24:51 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack727/11/2026, 10:55:56 PM
Editable. Press Enter to edit.

stack72 commented 7/11/2026, 11:25:01 PM

Thanks @jrh 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.