atmos: Skill for Claude Code

.claude/skills/editions/SKILL.md

editions is a skill for Claude Code from cloudposse/atmos. It costs 93 tokens per session (1,798 once invoked), scanned A, original, Apache-2.0.

A contributor workflow for deciding when a change to a program's default settings needs a dated record of the old behaviour. It also guides the related file changes, checks, and regenerated test data.

In plain words
What is it for?
Use it when changing shipped configuration defaults, adding journal entries, checking the four-layer default model, regenerating snapshots or invariants, and noting behaviour changes that need further review.
Why use it?
Changing a default can affect users who already rely on the earlier behaviour. This workflow helps avoid missing the records and checks needed to preserve that history.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is cloudposse/atmos's own configuration. It tells Claude Code how to work on atmos 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 atmos configures →

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is go test ./pkg/edition/... ./pkg/config/... # anchor/resolve/journal + load_edition_test.go + invariants.

About the project

Atmos is an infrastructure runtime that coordinates tools such as Terraform, OpenTofu, Kubernetes, Helm, Packer, Ansible, and containers through consistent commands and configuration. It is for teams running cloud infrastructure on laptops, in CI, or through AI agents across environments and regions. Its catalogue entries provide skills, agents, commands, and other add-ons for Atmos workflows.

cloudposse/atmos · 1,403 stars · on GitHub · atmos.tools

Reuse

Borrowing it

Nothing to install: this file belongs to cloudposse/atmos. 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/cloudposse/atmos/main/.claude/skills/editions/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/cloudposse/atmos

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 editions

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

Your own site · 80×15
<a href="https://agentmods.dev/skills/cloudposse/atmos/editions"><img src="https://agentmods.dev/badge/skills/cloudposse/atmos/editions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 93 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,798 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.00093 $0.01798
Opus 5.5 $0.00037 $0.00719
Sonnet 5.5 $0.00019 $0.00360
Haiku 4.5 $0.00009 $0.00180

Measured yesterday against content hash 455563c2937f, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

editions 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 yesterday.

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/editions/SKILL.md · 120 lines

How it starts

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

Editions (Date-Anchored Defaults)

Source of truth: docs/prd/editions.md. This skill is the contributor-facing decision tree for "does my change need edition handling", not a restatement of the architecture — read docs/prd/editions.md for the four-layer model, pkg/edition/journal.go's Entry schema, and the guardrail tests before touching anything. This skill exists because the deciding question ("does this default change supersede prior behavior?") is easy to answer wrong by only checking the literal rule ("new keys are never journal-gated") without checking what the rule is for.

The decision tree

Ask these in order. Stop at the first "yes."

1. Does this change a previously-shipped key's literal default value? (e.g. flipping settings.terminal.pager's struct default from "true" to "false".)

→ Yes: KindValue journal entry required. Follow docs/prd/editions.md's "Contributor workflow" exactly:

  1. Change the literal in setDefaultConfiguration (pkg/config/load.go), and in defaultCliConfig (pkg/config/default.go) if that struct also carries the field. Confirm the key isn't set in the embedded atmos.yaml (layer (b) must stay journaled-key-free).
  2. Append a dated Entry{Date, Key, Kind: KindValue, Old, New, Description, Ref} to pkg/edition/journal.go — Ref is the PR URL, Old/New typed as the field is typed today.
  3. Regenerate the snapshot: ATMOS_REGENERATE_DEFAULTS_SNAPSHOT=true go test ./pkg/config -run TestDefaultConfigurationSnapshot.

Skipping this is not optional — pkg/config/default_snapshot_test.go fails the build on an unjournaled value change.

2. Is this a brand-new key whose default doesn't change what Atmos already, unconditionally did? (e.g. a new opt-in flag for genuinely new functionality with no prior equivalent — nothing before this key ever did what it controls, not even as hardcoded behavior.)

→ No action needed. docs/prd/editions.md: "new defaults are never journal-gated." Only edit the layer that introduces the key and regenerate the snapshot (new-key diffs there don't require a journal entry, just committing the updated golden file).

Read the full file on GitHub · 120 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. yesterday Changed · -6 lines 455563c2937f
  2. 1mo ago First seen · 126 lines · 93 tokens per session scan A f1e9c0bd6b7c

Subscribe to this mod's changes

editions is a skill published in the GitHub repository cloudposse/atmos (1,403 stars, last pushed today), licensed Apache-2.0. It adds 93 tokens to every session and 1,798 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-09-15.

Related

Other skills, from other repositories

gke-basics

Trigger: Use when working with Google Kubernetes Engine basics — cluster setup, node pools, workloads, networking, and storage fundamentals.

skillmds/skillmd · 4 tokens

clum-mcp

A procedure for using clum, a remote Linux operations platform that runs commands through a secure proxy rather than direct SSH. It also describes how to inspect systems, investigate failures, compare solutions, and review incidents.

tddh/clum · 19 tokens

skypilot-multi-cloud-orchestration

Multi-cloud orchestration for ML workloads with automatic cost optimization. Use when you need to run training or batch jobs across multiple clouds, leverage spot instances with auto-recovery, or optimize GPU costs across providers.

davila7/claude-code-templates · 51 tokens

x-nets

Enhanced netstat module with cached data and structured output. View network connections, routing tables, and interface statistics in interactive or TSV/CSV formats. Dependency: This is an x-cmd module. Install x-cmd first (see x-cmd skill for installation options). see x-cmd skill for installation.

x-cmd/x-cmd · 69 tokens

x-osv

CLI for Google OSV database. Query vulnerabilities for packages, scan local projects for vulnerable dependencies. Dependency: This is an x-cmd module. Install x-cmd first (see x-cmd skill). Required Tool: Install osv-scanner for project scanning (see https://github.com/google/osv-scanner).

x-cmd/x-cmd · 72 tokens

x-uptime

Enhanced uptime with structured YAML output showing uptime, users, and 1/5/15-minute load averages. Dependency: This is an x-cmd module. Install x-cmd first (see x-cmd skill for installation options). see x-cmd skill for installation.

x-cmd/x-cmd · 67 tokens