charly-distros
claudecodexBase OS images and hardware runtime — arch, fedora, debian, ubuntu, aurora, bazzite, GPU runtime (nvidia/cuda/rocm), bootc bootstrap, per-distro builders.
46 skills
Development internals for charly contributors — Go source map, install-plan IR, capabilities/OCI labels, vm-spec, libvirt/cloud-init renderers, cutover-policy, strict-policy, disposable, ovmf, generate-source, skill maintenance, and the agents/workflows/teams guide. Ships five agents (root-cause-analyzer, layer-validator, testing-validator, check-bed-runner, deploy-verifier).
Plugin charly-internals from marketplace charly-plugins in opencharly/marketplace. Commands read from the repo's manifest — 12 days ago.
agentsMulti-agent support across harnesses (Claude Code, Codex, Kimi) — sub-agents, dynamic workflows, agent teams, fresh validator sessions, and how each drives the `charly check` disposable beds. Use before authoring/invoking a sub-agent, dynamic workflow, agent team, or fresh validator session, or wiri
capabilitiesOCI label contract, Capabilities/BoxMetadata struct, CapabilityLabelMap completeness, LabelService round-trip, source-less deploy via `charly deploy from-box`, or adding an OCI label. Use before any of those.
cloud-init-rendererPure renderer from VmSpec + VmCloudInit to NoCloud seed ISO (user-data + meta-data + network-config). Covers composeUsers adopt-merge, SMBIOS vs cloud_init channels, xorriso ISO emission, charly_install.strategy. Use before editing cloud-init emission paths.
cutover-policyThe 'Hard Cutover by Default' policy for schema changes, API renames, and deprecations — forbidden patterns, required deliverables, rationale, examples. Use when planning or reviewing a breaking change.
disposable`disposable: true` is the ONE and ONLY authorization for autonomous destroy + rebuild via `charly update`. Use before any task involving `charly update`, live verification on rebuildable targets, or marking a VM/container deploy safe-to-nuke.
egressCUE EGRESS validation — validating (and where valuable, generating) the config files charly WRITES to a system before the bytes hit disk. Use before working on candy/plugin-fleet/egress.go, the vendored egress schemas, ValidateEgress, or adding an egress schema.
generate-sourceContainerfile generation: `charly box generate` output, multi-stage builds, intermediate images, the .build/ directory. Use when debugging/understanding generated Containerfiles or reading charly Go source.
git-workflowThe feat/-branch, R10-gated, PR-ONLY, org-workflow-validated, never-force-push landing across the main repo, box submodules, marketplace, and the proxy-resolved sdk contract module. Use when committing, branching, pushing, opening PRs, or landing with gh; covers sync-to-upstream, fork+PR, cross-repo
go-qualityCheck charly's Go source for AGENTS.md compliance + code quality: golangci-lint v2, gopls, go vet, gofmt, the .go compliance checklist (R2/R3/R5), the legitimate-pattern allowlist. Use before a Go code-quality audit or lint sweep.
goGo CLI development: building the charly binary, running tests, source structure, and the SDD operationalization (spec/schema/*.cue -> `charly task cue-gen`). Use before reading/modifying charly Go source or spec/schema/*.cue.
install-planInstallPlan is the shared deployment IR — external local/VM/pod/Kubernetes/Android targets, executor reverse-channel, host-engine steps, guest SSH, pod overlays, Kustomize, Containerfile emission, deploy wire types. Use before changing the InstallPlan or any deploy target.
libvirt-rendererTranslation facade from VmSpec + LibvirtDomain to libvirt domain XML and QEMU argv — RenderDomainXML, device emission (passt, portForward, virtio-gpu), firmware plumbing, LibvirtDomain schema. Use before editing libvirt XML emission.
local-infraGo file map for the host side of `local:` + VM deploy execution — deploy_chain.go, sshconfig, hostdistro, install_ledger, builder_run, reverse_ops, deploy_ref. Use before reading/modifying those files or debugging local/VM deploy.
marketplaceHow the OpenCharly skill/marketplace corpus is GENERATED, refreshed, and consumed — the ownership split, regeneration command + schema prerequisite, deploy drift gate, daily refresh, per-harness caches. Use before editing the corpus or refs list.
ovmfUEFI firmware (OVMF_CODE + OVMF_VARS) path resolution for VMs — per-distro path table, per-VM NVRAM copies, secure-boot variants, the empty-strings=skip contract. Use before editing UEFI firmware resolution.
plugin-containerdThe out-of-tree charly ENGINE plugin serving engine:containerd (verb:containerd / command:containerd) — every engine op delegates to container.InvokeEngineOp. `containerd` is the engine word; `nerdctl` is only the CLI binary it is driven through. Use when working with the engine:containerd provider,
pluginAuthoring/modifying a charly PLUGIN — a candy with a `plugin:` block contributing Providers (verbs/kinds/deploy-targets/steps/builders/commands), its CUE schema, builtin or external. Covers the unified Provider model, per-plugin CUE-schema contract, SDK, loader.
repo-setupHow the opencharly GitHub org and opencharly/.github (dotgithub) configuration and workflows drive every repository — the ONE org ruleset, the org-required `charly/pr-validator` workflow, native auto-merge, tag-on-merge CalVer, and the per-repo settings. Use when setting up a NEW repository, adding
root-cause-analyzerR1 mandatory failure analysis — the 8-step root cause analysis process. MUST be invoked before any remediation when an unexpected error, warning, or anomaly occurs.
skillsSkill maintenance: when and how to update skills, root rulebooks, and README.md. Use when updating documentation, feeding back operational insights, or auditing skill coverage.
strict-policyOperationalization of AGENTS.md R1-R5 plus the RDD and ADE pillars — the engineering-discipline rules that come BEFORE runtime verification. Use when a failure/warning/anomaly surfaces, a plan rests on a high-risk unproven assumption, a pattern is about to land in a second surface, a sleep/retry/mag
vm-deploy-targetThe external VM deploy substrate applies InstallPlan inside a guest via the reverse-channel SSH executor — plugin-deploy-vm, VM boot/readiness, Charly delivery, nested pods, lifecycle, VmDeployState, DeployExecutor, the pluginDeployTarget/UnifiedDeployTarget seams. Use before editing VM-target deplo
vm-specGo type reference for VmSpec and the discriminated-union source types (cloud_image | bootc | clone | imported | bootstrap | iso | container_disk) — every field, validation rules, the adopt-user decision. Use before editing VmSpec Go code or authoring vm.yml entries.
check-bed-runnerRuns an existing disposable check bed to completion via `charly check run <bed>` (the full R10 sequence) and returns the VERBATIM verdict — per-step status, overall exit code, failing-step log tail. Use as the R10 acceptance executor; never summarizes away a failure.
deploy-verifierEvaluates a deployment config (a charly box OR a user deploy) and verifies expected state matches reality, returning concrete evidence-backed findings. Read-mostly: probes image artifacts and running deployments; never mutates.
layer-validatorValidates charly.yml structure and candy/layer claims against the schema and the checked-out repos, returning evidence-backed verdicts. Use before editing any charly.yml.
pr-validatorBlocking — the FRESH PR evaluator. Independently validates a pull request against the active harness rulebook + relevant skills and certifies its verdict (PASS/BLOCK). Uses gh_pr_status for pull-request state. Spawned with a NEW context; re-derives everything from the PR itself.
root-cause-analyzerMandatory first response to any failure, error, warning, or anomaly (R1): 8-step root cause analysis with evidence.
testing-validatorConfirms that features have been locally tested and verified (R10), inspecting the changed paths and the recorded evidence.
Base OS images and hardware runtime — arch, fedora, debian, ubuntu, aurora, bazzite, GPU runtime (nvidia/cuda/rocm), bootc bootstrap, per-distro builders.
46 skills
Self-contained skills + MCP wiring for the selkies-desktop family (Wayland desktop in a container with VNC + Chrome). Ships the chrome-devtools MCP server (port 9224).
45 skills · 1 MCP server
Self-contained skills + MCP wiring for charly coder/dev images (arch-coder, debian-coder, fedora-coder, ubuntu-coder, charly-arch). Ships the charly MCP server (port 18765). Bundles language runtimes (golang, rust, nodejs).
32 skills · 1 MCP server
Live-container evaluation and probe verbs — `charly check` orchestrator + per-protocol live probes (cdp, wl, wl-overlay, dbus, vnc, spice, libvirt, record).
24 skills
CLI utilities and the charly binary deploy artifacts — ripgrep, himalaya, whisper, nano-pdf, summarize, ordercli, gogcli, sherpa-onnx, plus the `charly` binary deployment skill.
24 skills
Infrastructure services and system layers — postgresql, redis, valkey, vectorchord, k3s cluster, traefik, supervisord, tailscale, gocryptfs, virtualization, dbus-layer, tmux-layer.
22 skills
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
15 skills · hooks
Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.
1 MCP server
Build powerful, stateful CLI interfaces for any GUI application using the cli-anything harness methodology.
5 commands
Automates browser interactions for web testing, form filling, screenshots, and data extraction
12 skills
Use Alibaba Open Code Review from local Codex.
2 skills
Claude Code skill for creating and presenting Slidev slidedecks
1 skill
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.