aspens CLAUDE.md

A project instruction guide for Aspens, a toolkit that manages coding-agent skills, commands, releases, and conventions.

In plain words
What is it for?
Use it when working on Aspens areas such as command-line behavior, agent customization, documentation syncing, repository analysis, or Claude and Codex support.
Why use it?
It gives the agent the project-specific context needed to work consistently across Aspens features.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/aspenkit/aspens/claude-md
Clone the repo
git clone --depth 1 https://github.com/aspenkit/aspens
Per session 1,029 This file is loaded in full into every session.
When invoked 1,029 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin 88% copy Near-identical to another mod 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 $0.01029 $0.01029
Opus 5 $0.00515 $0.00515
Sonnet 5 $0.00206 $0.00206
Haiku 4.5 $0.00103 $0.00103

Measured 2d ago against content hash 16f4935da0d3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

aspens CLAUDE.md 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 2d ago.

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.

Origin

This is a copy

88% identical to aspens AGENTS.md — 34 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 51 lines

How it starts

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

aspens

Skills

  • .claude/skills/base/skill.md — Base repo skill; load whenever working in this repo.
  • .claude/skills/agent-customization/skill.md — LLM-powered injection of project context into installed agent templates via aspens customize agents
  • .claude/skills/claude-runner/skill.md — Claude/Codex CLI execution layer — prompt loading, stream-json parsing, file output extraction, path sanitization, skill file writing, and skill rule generation
  • .claude/skills/cli-shell/skill.md — Top-level Commander wiring, welcome screen, missing-hook warning, CliError exit handling, and the public programmatic API surface
  • .claude/skills/codex-support/skill.md — Multi-target output system — target abstraction, backend routing, content transforms for Codex CLI and future targets
  • .claude/skills/doc-impact/skill.md — Context health analysis — freshness, domain coverage, hub surfacing, drift detection, LLM-powered interpretation, and auto-repair for generated agent context
  • .claude/skills/doc-sync/skill.md — Incremental skill updater that maps git diffs to affected skills and optionally auto-syncs via a post-commit hook
  • .claude/skills/import-graph/skill.md — Static import analysis that builds dependency graphs, domain clusters, hub files, git churn hotspots, and file priority rankings
  • .claude/skills/repo-scanning/skill.md — Deterministic repo analysis — language/framework detection, structure mapping, domain discovery, health checks, and import graph integration
  • .claude/skills/save-tokens/skill.md — Token-saving session automation — statusline, prompt guard, precompact handoffs, session rotation, and handoff commands for Claude Code
  • .claude/skills/skill-generation/skill.md — LLM-powered generation pipeline for Claude Code skills and CLAUDE.md — doc-init command, prompt system, context building, and output parsing
  • .claude/skills/template-library/skill.md — Bundled agents, commands, hooks, and settings that users install via aspens add, aspens doc init, and aspens save-tokens into their .claude/ directories

Read the full file on GitHub · 51 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. 2d ago First seen · 51 lines · 1,029 tokens per session scan A 16f4935da0d3

Subscribe to this mod's changes

aspens CLAUDE.md is an instructions file published in the GitHub repository aspenkit/aspens (96 stars, last pushed 17d ago), licensed MIT. It adds 1,029 tokens to every session, about $0.0051 per session on Opus 5. A static security scan graded it A with 0 findings. It is 88% identical to aspens AGENTS.md, differing in 34 lines, and is treated as a copy.