skilld
All skills
oaustegard avatar

/container-layer

@04bfd5b
by Oskar Austegardoaustegard/claude-skills150 stars
6

Authors and caches a personalized container environment from a Dockerfile- like spec, as a single layer or as a composition of independently cached layers. Use when the user mentions "container layer", "Containerfile", "custom container", "cache my installs", "composable layers", "uv shim", or wants package installations, skills and environment config to survive an ephemeral session. Also for snapshotting, restoring or rebuilding that environment, and for capturing ad-hoc installs into a reproducible spec.

Ask your Agent

Use this Skill: https://skilld.dev/gh/oaustegard/claude-skills/container-layer

This session only. Nothing lands on disk.

CHANGELOG.md

≈1.1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

container-layer - Changelog

All notable changes to the container-layer skill are documented in this file. The format is based on Keep a Changelog.

[0.4.0] - 2026-08-25

Other

  • top skills: separate by omission, and correct the guidance that said otherwise (#777)

[0.2.3] - 2026-08-25

Other

  • creating-skill: use Anthropic's quick_validate.py instead of a hand-rolled check (#775)
  • Deprecate mapping-codebases; adopt ruff 0.16.0 baseline (#747)
  • container-layer: fix ARG_MAX crash building large snapshot tarballs (#723)

[0.2.2] - 2026-05-17

Other

  • container-layer v0.2.2: baseline /usr/{bin,lib,share} for apt-install layers (#653)

[0.2.2] - 2026-05-17

Fixed

  • PYTHON_INSTALL_PATHS now includes /usr/bin, /usr/lib, /usr/share so apt-install layers get the diff-vs-baseline treatment instead of whole-tree capture. _exec_run already auto-adds these three paths to snapshot_paths when it sees apt-get install, but before this fix they weren't baselined, so any layer with apt-get install <one tiny package> ballooned by ~600MB compressed (the full /usr/{bin,lib,share} trees). Verified empirically against the libfuse2 install in oaustegard/claude-workspace-fuse: layer jumped from 940MB → 1625MB compressed. Closes oaustegard/claude-skills#652.

Notes

  • Despite the name, PYTHON_INSTALL_PATHS is no longer python-only. Kept the name for backwards compatibility with any external importer; consider renaming to BASELINED_PATHS in a future major bump.
  • snapshot_baseline() walks these dirs at build-time. /usr/lib is the largest (~2GB raw) — adds a few seconds to baseline capture. Acceptable for build-time; negligible vs. the layer-restore time it saves.

[0.2.1] - 2026-05-17

Other

  • container-layer v0.2.1: cover python3.10-3.13 dist-packages in baseline (#651)

[0.2.1] - 2026-05-17

Fixed

  • PYTHON_INSTALL_PATHS now lists python3.10 through python3.13 dist-packages instead of only python3.12. The previous single entry missed containers using 3.11 (which is most of them), causing the diff-vs-baseline logic in _dedup_paths to silently fall through to whole-tree snapshot — every layer captured all of dist-packages instead of just newly-installed files. Empirically verified against oaustegard/claude-workspace-fuse: cached "slim" layer was 678MB compressed with 712M torch + 944M modular still embedded.

Added

  • Regression tests in scripts/test_baseline_paths.py lock in the new coverage and assert the diff path is taken when a SNAPSHOT directive references a baselined dir.

[0.2.0] - 2026-05-17

Added

  • add ISO date prefix to layer release names for sortability (#535)

Other

  • container-layer v0.2.0: named layers + compose (#650)
  • container-layer: stop leaking GH_TOKEN via subprocess TimeoutExpired (#596)
  • Remove _MAP.md files, direct agents to tree-sitting for code navigation (#545)
  • marketplace: restructure as category-based plugins for Claude Code discovery (#530)
  • container-layer: add README
  • container-layer: update boot-ccotw.sh (fix function ordering, abs paths)
  • container-layer: update scripts/cli.py
  • container-layer: update scripts/containerfile.py
  • container-layer: add boot.sh
  • container-layer: add Containerfile

[0.2.0] - 2026-05-17

Added

  • Named layers: ContainerLayer(..., layer_name="X") produces cache release tag layer-X-<hash> instead of layer-<hash>. Enables per-name cache retention policies and multi-layer composition without collisions.
  • default_layer_name(path): derives layer name from filename (Containerfile → base, Containerfile.mojo → mojo, etc.).
  • compose(containerfile_paths, ...): orchestrates sequential restore (or build+push on miss) of multiple named layers. Mirrors Docker's additive-overlay semantics — later layers can overwrite earlier ones' files.
  • CLI compose subcommand for the same.
  • --name flag on build / restore / hash / inspect subcommands for single-layer naming.

Backwards compatibility

  • Unnamed layers (no layer_name, no --name) keep the old layer-<hash> tag. Existing single-Containerfile callers see no cache invalidation.
  • Existing build_and_push() / restore_or_build() / build_only() methods unchanged.

[0.1.0] - 2026-04-04

Other

  • Add container-layer skill

Source: SKILL.md on GitHub

Third-party checks

2 alerts5mo3 checks · Risk HIGH
  • Gen Agent Trust Hub5mo

    The skill allows users to define and cache container environments using a Docker-like syntax. It executes arbitrary shell commands and fetches remote content, which poses risks if a malicious configuration file is processed.

  • Socket5mo

    3 alerts: gptSecurity

  • Snyk5mo

    Risk: CRITICAL · 4 issues

Provenance

Signed by skilld at 04bfd5b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month

Capability

metadata
{
  "version": "0.4.0"
}

README badge

README badge for oaustegard/claude-skills/container-layer