flisk: Skill for Claude Code

.claude/skills/flisk-doctor/SKILL.md

flisk-doctor is a skill for Claude Code from flisk-sh/flisk. It costs 94 tokens per session (752 once invoked), scanned A, original, MIT.

A guide to using Flisk Doctor, a command-line check for a Flisk project's local tools and configuration. It covers checks for Docker, Tilt, Bun, ports, networks, generated files, and service definitions.

In plain words
What is it for?
Use it when setting up a Flisk project, before running `flisk up`, or when services, ports, networks, or generated configuration appear broken.
Why use it?
It helps find setup problems before starting services, and tells you whether the issue is on your computer or in the project. Re-running the check confirms that a fix worked.

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-doctor/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-doctor

README.md
[![agentmods](https://agentmods.dev/badge/skills/flisk-sh/flisk/flisk-doctor/github.svg)](https://agentmods.dev/skills/flisk-sh/flisk/flisk-doctor)
Your own site
<a href="https://agentmods.dev/skills/flisk-sh/flisk/flisk-doctor"><img src="https://agentmods.dev/badge/skills/flisk-sh/flisk/flisk-doctor/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-doctor

Your own site · 80×15
<a href="https://agentmods.dev/skills/flisk-sh/flisk/flisk-doctor"><img src="https://agentmods.dev/badge/skills/flisk-sh/flisk/flisk-doctor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 94 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 752 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.00094 $0.00752
Opus 5.5 $0.00038 $0.00301
Sonnet 5.5 $0.00019 $0.00150
Haiku 4.5 $0.00009 $0.00075

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

Security

Grade A, and why

flisk-doctor 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-doctor/SKILL.md · 47 lines

How it starts

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

Flisk doctor

Use the CLI's environment and project checks as the starting point for Flisk setup and diagnosis.

Workflow

  1. Run flisk doctor from the Flisk project root.
  2. Read the full output and distinguish host prerequisites from project configuration findings.
  3. Fix the source configuration or environment item named by the diagnostic. Do not hand-edit generated .autogenerated/ output.
  4. Run flisk doctor again to confirm the finding is resolved.
  5. Before starting services, use flisk networks to inspect the routed URLs; start only the needed stack with flisk up <stack> when appropriate.

When the standard check is not enough

flisk doctor has no --verbose flag of its own. Use these instead:

  • flisk doctor --all runs every check and prints the Machine and Project sections with a summary.
  • flisk doctor --json prints the versioned readiness report: each check's name, result, message and fix. Read it instead of parsing the human output.
  • flisk doctor --no-ping skips pinging the /health of running services; --ping-timeout <ms> gives slow services longer.
  • flisk doctor --strict fails on warnings too, such as a WSL project under /mnt/c.
  • flisk config verify --json checks that the generated files match .flisk/project.json and every service.json. Doctor checks the machine and the services; config verify checks generated-file consistency.
  • FLISK_VERBOSE=1 prints error details that some commands (for example flisk networks and flisk upgrade) otherwise hide.
  • FLISK_DEBUG=1 flisk up --verbose adds the engine's Starlark debug logs to the Tilt output.

Repairs

  • flisk doctor --fix --dry-run lists the repairs without changing anything. flisk doctor --fix applies them after asking (--yes skips the question). It removes this project's unused Docker networks and leftover doctor probes.
  • When Docker refuses new networks (all predefined address pools have been fully subnetted), run flisk doctor --fix --scope=machine. It also removes the unused networks of other Flisk projects, and skips any network a container is attached to.

Read the full file on GitHub · 47 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 · 47 lines · 94 tokens per session scan A d444e8711226

Subscribe to this mod's changes

flisk-doctor is a skill published in the GitHub repository flisk-sh/flisk (54 stars, last pushed yesterday), licensed MIT. It adds 94 tokens to every session and 752 once invoked, about $0.0004 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-doctor compared with skills from other repositories

flisk-doctor next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
flisk-doctorflisk-sh/fliskSkill54yesterdayMITA94Claude Code
docker-debugkurtosis-tech/kurtosisSkill559todayApache-2.0A45Claude Code, Codex
k8s-debug-podskurtosis-tech/kurtosisSkill559todayApache-2.0A62Claude Code, Codex
docker-docspledgeandgrow/pledge-skillsSkill114mo agoMITA93Claude Code, Codex
docker-managementfurkangonel/cowranglerSkill12mo agoMITC16Claude Code, Codex
gke-kueue-troubleshootinggoogle/skillsSkill24ktodayApache-2.0A253Claude Code, Codex
smoke-testgarrytan/gbrainSkill33ktodayMITA79Claude Code