Agent skill

Compartment Runtime Hygiene

by compartmentdev in compartmentdev/compartment

Handle export, entrypoint, scaffolding, or deletion changes that can create dead runtime surface or Knip runtime drift in the compartment repo.

Apache-2.0Auto-check passedDevelopment

Install Compartment Runtime Hygiene

skills CLI
$ npx skills add compartmentdev/compartment --skill compartment-runtime-hygiene -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install compartmentdev/compartment compartment-runtime-hygiene --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/compartmentdev/compartment.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/compartment-runtime-hygiene .claude/skills/compartment-runtime-hygiene && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
compartment-runtime-hygiene
GitHub stars
205
Token cost
~385 tokens
SKILL.md length
187 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Handle export, entrypoint, scaffolding, or deletion changes that can create dead runtime surface or Knip runtime drift in the compartment repo.

  • Works in 6 steps: Treat code reachable only from tests as… → Remove, internalize, or move helpers… → Keep runtime entrypoints explicit.… → …
  • Tasks that involve Project scaffolding
  • SKILL.md covers Source of truth, Workflow and Common repo-specific smells
  • Calls git

What it does

Compartment Runtime Hygiene is an agent skill from compartmentdev/compartment. Handle export, entrypoint, scaffolding, or deletion changes that can create dead runtime surface or Knip runtime drift in the compartment repo.

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Project scaffolding. The repository describes itself as: Compartment is a self-hosted deployment system for small software on infrastructure your team controls. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Project scaffolding

Example prompts

  • “/compartment-runtime-hygiene”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Treat code reachable only from tests as dead runtime surface.
  2. Remove, internalize, or move helpers that were exported only to satisfy tests.
  3. Keep runtime entrypoints explicit. Update knip.runtime.jsonc only for real runtime entrypoints, not convenience exports.
  4. When git commit runs, the repo-wide hook checks start automatically, so add narrow package checks for the touched surface and add special…
  5. When deletions or refactors expose implementation-mirror tests, delete or rewrite those tests instead of preserving dead runtime seams for…
  6. Do not keep exports, wrappers, dependency seams, or compatibility glue alive solely because mock-heavy plumbing tests depend on them.

What it can do on your machine

Read from SKILL.md and the folder at commit 15373e7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Compartment Runtime Hygiene loads about 385 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 187 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~385

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from compartmentdev/compartment at commit 15373e7, republished under its Apache-2.0 licence (© compartmentdev). 187 words, ~385 tokens.

Download SKILL.mdSave it as .claude/skills/compartment-runtime-hygiene/SKILL.md (or your agent's skills folder).
name
compartment-runtime-hygiene
description
Handle export, entrypoint, scaffolding, or deletion changes that can create dead runtime surface or Knip runtime drift in the compartment repo.

Compartment Runtime Hygiene

Use this skill only for runtime-surface changes.

Source of truth

  • AGENTS.md
  • docs/layers/README.md

Workflow

  1. Treat code reachable only from tests as dead runtime surface.
  2. Remove, internalize, or move helpers that were exported only to satisfy tests.
  3. Keep runtime entrypoints explicit. Update knip.runtime.jsonc only for real runtime entrypoints, not convenience exports.
  4. When git commit runs, the repo-wide hook checks start automatically, so add narrow package checks for the touched surface and add special checks only when the diff needs more than that hook covers.
  5. When deletions or refactors expose implementation-mirror tests, delete or rewrite those tests instead of preserving dead runtime seams for them.
  6. Do not keep exports, wrappers, dependency seams, or compatibility glue alive solely because mock-heavy plumbing tests depend on them.

Common repo-specific smells

  • package entry exports that nobody in runtime imports;
  • helpers only referenced from tests;
  • public type re-exports that widen a package entry surface with no runtime need;
  • script helpers exported even though the file itself is the only caller.
  • tests that only assert exact collaborator forwarding, ORM/query-builder choreography, or CLI/route plumbing rather than runtime behavior.

© compartmentdev, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/compartment-runtime-hygiene of compartmentdev/compartment.

Open the folder on GitHubat commit 15373e7

Compare with similar skills

Compartment Runtime Hygiene next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Compartment Runtime Hygiene compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Compartment Runtime Hygiene this skillcompartmentdev/compartment205—~385Automated safety check: PassApache-2.0
Template Devlbedner/aegis-stack143—~2.9kAutomated safety check: PassMIT
Portaljs Connect Ckandatopian/portaljs2.4k1 repos~1.5kAutomated safety check: PassMIT
Cabloy Backend Scaffoldcabloy/cabloy982—~3.1kAutomated safety check: PassMIT
Fe Tools Template RecommenderMichealWayne/fe-tools207—~1kAutomated safety check: PassNone
Create Datadriven Aspnetcoredotnet/skills5.6k1 repos~3.2kAutomated safety check: PassMIT

Similar skills

  • Template Dev

    lbedner/aegis-stack

    A skill your agent uses when developing or modifying Copier templates in aegis/templates, or backporting a change from a generated project (e.g.

    143 GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Portaljs Connect Ckan

    datopian/portaljs

    Wire a scaffolded PortalJS portal to a CKAN backend over its API.

    2.4k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • This skill should be used when the user needs the Vona backend scaffold/extend path in this Cabloy repo, especially to choose the right npm run vona generator or CRUD command and the required…

    982 GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Fe Tools Template Recommender

    MichealWayne/fe-tools

    Recommend the most suitable project template or initialization path from fe-tools project-templates based on product, framework, runtime, and delivery constraints.

    207 GitHub stars~1k tokensUpdated 29 days ago
    DevelopmentAuto-check passed
  • Official

    Generate or scaffold ASP.NET Core code — Razor Pages, Blazor components, MVC controllers, views, and Minimal API endpoints — without using ASP.NET Core CLI scaffolding/code-generation tools.

    5.6k GitHub starsUsed in 1 repo~3.2k tokens
    DevelopmentAuto-check passed
  • Horse Minimal API

    HashLoad/horse

    Guide for building lightweight, low-boilerplate, and rapid HTTP services (Minimal APIs) in Horse.

    1.4k GitHub stars~640 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from compartmentdev/compartment

All 12 skills in this repo
  • Audit Type Ownership

    compartmentdev/compartment

    Audit type ownership and boundary placement in the compartment repo: misplaced or duplicated types, query/service leaks, root export surface, and phased move plans.

    205 GitHub stars~745 tokensUpdated 1 mo ago
    Auto-check passed
  • Open PR And Monitor

    compartmentdev/compartment

    Open or reuse a repo PR and monitor it with a five-minute Codex heartbeat until it is ready, terminal, or blocked.

    205 GitHub stars~470 tokensUpdated 1 mo ago
    Auto-check passed
  • Review A Change

    compartmentdev/compartment

    A skill your agent uses when the user invokes $review-a-change or asks for a compartment repo code review; always use the delegated subagent review path by splitting review into separate parallel…

    205 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Review Reuse And Dedup

    compartmentdev/compartment

    A skill your agent uses when reviewing compartment repo changes for existing helper reuse, extractable pure utilities, duplicated logic, repeated constants, hardcoded values, or repeated variable…

    205 GitHub stars~753 tokensUpdated 1 mo ago
    Auto-check passed
  • Compartment Smoke Test

    compartmentdev/compartment

    Run or delegate a browser-first smoke test of the local compartment through browser-use as a real user: boot or reuse the local stack, install or log in, deploy the repo smoke fixtures, verify CLI…

    205 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Develop A Feature

    compartmentdev/compartment

    Implement repo changes by starting with preflight feature review, then editing the smallest owning surface on one canonical path and running only diff-triggered checks.

    205 GitHub stars~554 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Compartment Runtime Hygiene

What does Compartment Runtime Hygiene do?

Handle export, entrypoint, scaffolding, or deletion changes that can create dead runtime surface or Knip runtime drift in the compartment repo. Compartment Runtime Hygiene is an agent skill from compartmentdev/compartment. Handle export, entrypoint, scaffolding, or deletion changes that can create dead runtime surface or Knip runtime drift in the compartment repo.

When should I use Compartment Runtime Hygiene?

Compartment Runtime Hygiene fits situations like: tasks that involve Project scaffolding.

How do I install Compartment Runtime Hygiene in Claude Code?

Run `npx skills add compartmentdev/compartment --skill compartment-runtime-hygiene -a claude-code`. Or copy the skill folder (.codex/skills/compartment-runtime-hygiene in compartmentdev/compartment) into .claude/skills/compartment-runtime-hygiene in your project. Claude Code loads it when a task matches its description.

How do I install Compartment Runtime Hygiene in Codex?

Run `npx skills add compartmentdev/compartment --skill compartment-runtime-hygiene -a codex`. Or copy the skill folder (.codex/skills/compartment-runtime-hygiene in compartmentdev/compartment) into .agents/skills/compartment-runtime-hygiene in your project. Codex loads it when a task matches its description.

Can I use Compartment Runtime Hygiene in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add compartmentdev/compartment --skill compartment-runtime-hygiene -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compartment-runtime-hygiene, .gemini/skills/compartment-runtime-hygiene, .github/skills/compartment-runtime-hygiene and .opencode/skills/compartment-runtime-hygiene in your project.

What does Compartment Runtime Hygiene need to run?

Going by SKILL.md and its folder, Compartment Runtime Hygiene needs the command-line tools its instructions call (git).

Does Compartment Runtime Hygiene access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Compartment Runtime Hygiene safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Compartment Runtime Hygiene use?

Compartment Runtime Hygiene is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Compartment Runtime Hygiene use?

About 385 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Compartment Runtime Hygiene?

Skills that share tags, products or a category with Compartment Runtime Hygiene: Template Dev (lbedner/aegis-stack, 143 stars), Portaljs Connect Ckan (datopian/portaljs, 2.4k stars), Cabloy Backend Scaffold (cabloy/cabloy, 982 stars) and Fe Tools Template Recommender (MichealWayne/fe-tools, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Compartment Runtime Hygiene?

compartmentdev (a GitHub organization) maintains it in compartmentdev/compartment, which has 205 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on August 20, 2026.

Source: compartmentdev/compartment on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.