build/skills/list/SKILL.md
List components from charly.yml and filesystem. MUST be invoked before any work involving: charly box list commands, enumerating images, layers, build targets, services, routes, volumes, or aliases.
npx skillsauth add overthinkos/overthink-plugins listInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Invoked as charly box list {images,layers,targets,services,routes,volumes,aliases}.
See /charly-image:image for the family overview.
Enumerate images, layers, build targets, and layer properties from charly.yml and the filesystem. Useful for discovery and scripting.
| Action | Command | Description |
|--------|---------|-------------|
| List boxes | charly box list boxes | All boxes defined in charly.yml |
| List layers | charly box list candies | All layers found on filesystem |
| List targets | charly box list targets | Build targets in dependency order |
| List services | charly box list services | Layers that declare a service: field |
| List routes | charly box list routes | Layers that declare a route: field |
| List volumes | charly box list volumes | Layers that declare volume: |
| List aliases | charly box list aliases | Layers that declare alias: |
| List image tags | charly box list tags [<box>] | Locally stored CalVer tags of charly-built images, newest first (rollback discovery for charly update --tag) |
# Show all images from charly.yml
charly box list boxes
# Output: one image name per line
# fedora
# fedora-builder
# sway-browser-vnc
# ...
# Show all layers found in candy/ directory
charly box list candies
# Dependency-ordered list -- useful for scripting builds
charly box list targets
# Which layers provide services?
charly box list services
# Which layers define routes (Traefik)?
charly box list routes
# Which layers declare persistent volumes?
charly box list volumes
# Which layers provide host command aliases?
charly box list aliases
charly box list … resolves charly.yml + candy/ via os.Getwd(). Override with -C <dir> / --dir <dir> / CHARLY_PROJECT_DIR=<dir>. See /charly-image:image "Project directory resolution".
charly box family siblings/charly-image:image -- Family overview + charly.yml composition reference/charly-build:build -- Build enumerated images/charly-build:generate -- Containerfile generation/charly-build:inspect -- Detailed inspection of a specific image/charly-build:merge -- Post-build layer consolidation/charly-build:new -- Scaffold a new candy/charly-build:pull -- Pull prebuilt images into local storage/charly-build:validate -- Validate charly.yml and layer definitions/charly-image:layer -- Layer authoring and structuretools
Use when authoring or modifying a charly PLUGIN — a candy with a `plugin:` block that contributes Providers (verbs/kinds/deploy-targets/steps/builders/commands), its own CUE schema, builtin (compiled-in) or external (out-of-tree git repo). Covers the unified Provider model, the per-plugin CUE-schema contract (single source → Go params for dev + schema-over-Describe RPC for runtime), the SDK, and the loader.
tools
The CUE data-validation / configuration CLI (cue), pinned to v0.16.1. Use when working with the cue candy, installing the cue binary into a box or onto a target:local dev host, or running the offline schema-vendoring pipeline that feeds charly's egress validation.
tools
CUE EGRESS validation — validating (and, where it adds value, generating) the config files charly WRITES to a system BEFORE the bytes hit disk. MUST be invoked before working on charly/egress.go, the vendored schemas under candy/plugin-egress/egress-schemas/vendor/, the ValidateEgress / registerVendoredEgressKind path, the offline `task cue:vendor` pipeline, or adding an egress schema for any written artifact (cloud-init, k8s manifests, traefik routes, runtime config, install ledger, systemd/quadlet units, ssh_config, libvirt XML).
tools
Kubernetes cluster-probe declarative check verb — the `kube:` check verb (nodes, pods, ingress, storage class, addon health, apply/delete, and arbitrary resource GETs) served out-of-process by the candy/plugin-kube plugin (vendored client-go; no external kubectl required).