flisk: Skill for Claude Code

.claude/skills/flisk-bug-hunter/SKILL.md

flisk-bug-hunter is a skill for Claude Code from flisk-sh/flisk. It costs 132 tokens per session (3,134 once invoked), scanned A, original, MIT.

A method for finding bugs in the Flisk command-line tool, its generated files, and its MCP server by testing many unusual inputs. An MCP server is a service that lets an AI agent use tools through a standard interface.

In plain words
What is it for?
Use it for chaos testing across configuration graphs, validation gates, Docker, command-line inputs, state, and MCP behavior.
Why use it?
It finds cases where an early check accepts a project that a later Docker, Tilt, or Flisk step cannot run, and turns confirmed findings into lasting fixes.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is flisk-sh/flisk's own configuration. It tells Claude Code how to work on flisk itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything flisk configures →

Reuse

Borrowing it

Nothing to install: this file belongs to flisk-sh/flisk. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/flisk-sh/flisk/main/.claude/skills/flisk-bug-hunter/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/flisk-sh/flisk

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for flisk-bug-hunter

README.md
[![agentmods](https://agentmods.dev/badge/skills/flisk-sh/flisk/flisk-bug-hunter/github.svg)](https://agentmods.dev/skills/flisk-sh/flisk/flisk-bug-hunter)
Your own site
<a href="https://agentmods.dev/skills/flisk-sh/flisk/flisk-bug-hunter"><img src="https://agentmods.dev/badge/skills/flisk-sh/flisk/flisk-bug-hunter/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for flisk-bug-hunter

Your own site · 80×15
<a href="https://agentmods.dev/skills/flisk-sh/flisk/flisk-bug-hunter"><img src="https://agentmods.dev/badge/skills/flisk-sh/flisk/flisk-bug-hunter.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 132 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,134 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00132 $0.03134
Opus 5.5 $0.00053 $0.01254
Sonnet 5.5 $0.00026 $0.00627
Haiku 4.5 $0.00013 $0.00313

Measured 5d ago against content hash 89bac353c78c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

flisk-bug-hunter scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/flisk-bug-hunter/SKILL.md · 123 lines

How it starts

The opening of the file, as written. The whole thing — 123 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Hunting flisk bugs with chaos tests

The tiers live in tests/chaos/ (see its README for the commands). This skill is the method: how to pick a tier, how to judge the output, and how to turn a finding into a fix that stays fixed. Most of what it records was learned the hard way, by writing a rule that was too strict and then finding out which real project it broke.

1. The one idea

A command is wrong when a check accepted something that a later step then refused or broke. flisk up says yes, then Tilt, Compose or Docker says no, minutes later. Hunt that gap. Every tier below is a different way of finding an input the early check lets through, or a place where two commands that describe the same project disagree.

Three kinds of bug turned up again and again:

  • gate gap: flisk up --dry-run accepts a value that breaks the generated Tiltfile, Compose file or Dockerfile (an unsafe name, a malformed secrets, a user dockerfile);
  • disagreement: two commands answer differently about one project (resources against the files on disk, config regenerate against config verify, the CLI graph against the Tilt graph);
  • raw crash: an unhandled error ends as a runtime stack trace, or kills a long-running server such as flisk mcp.

2. Pick the tier by what you suspect

Suspect Tier Cost
a dependsOn edit does not change the graph graph (tests/chaos/graph): random edits checked against the Tilt graph, flisk up --dry-run and flisk config verify seconds per case
a service.json value passes the check gates (gates/bulk.ts): millions of seeded good and corrupted sets, in memory about 50,000 sets a second
a value passes the check but breaks Compose, Tilt or the Dockerfile Docker (docker/run.ts, variants in docker/variants.ts): one field changed at a time, then Tilt eval, docker compose config, docker buildx build --check about 3 cases a second
a command crashes or lies for odd arguments or a damaged project CLI fuzz (cli/fuzz.ts) about 15 runs a second
commands disagree after a sequence of edits state (cli/state.ts) a project per sequence
an image is bigger than its contents size (docker/size.ts) plus docker history of a real image (section 4) seconds, no build
an agent tool crashes the server or returns garbage MCP (cli/mcp.ts) one server per project state

Read the full file on GitHub · 123 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 123 lines · 132 tokens per session scan A 89bac353c78c

Subscribe to this mod's changes

flisk-bug-hunter is a skill published in the GitHub repository flisk-sh/flisk (54 stars, last pushed yesterday), licensed MIT. It adds 132 tokens to every session and 3,134 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-15.

Related

flisk-bug-hunter compared with skills from other repositories

flisk-bug-hunter next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
flisk-bug-hunterflisk-sh/fliskSkill54yesterdayMITA132Claude Code
files-inspectkurtosis-tech/kurtosisSkill559todayApache-2.0A51Claude Code, Codex
starlark-devkurtosis-tech/kurtosisSkill559todayApache-2.0A50Claude Code, Codex
docker-debugkurtosis-tech/kurtosisSkill559todayApache-2.0A45Claude Code, Codex
cli-local-buildkurtosis-tech/kurtosisSkill559todayApache-2.0A46Claude Code, Codex
enclave-inspectkurtosis-tech/kurtosisSkill559todayApache-2.0A52Claude Code, Codex
k8s-debug-podskurtosis-tech/kurtosisSkill559todayApache-2.0A62Claude Code, Codex