agent-customization · git:20260407.185e870 · 2026-04-07 · sha256 bbb469bad8c0118e
agent-customization git:20260407.185e870A
Immutable. This exact content never changes and is served at /api/v1/blob/bbb469bad8c0118e.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_hrozgc3va4avphif/bbb469bad8c0118ee7de3d47bbea42de28ebe7d0304a9d01544729f6b150a847.json
Then /plugin install agent-customization@markdownregistry-hrozgc3va4avphif in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: agent-customization description: LLM-powered injection of project context into installed agent templates via `aspens customize agents` --- ## Activation This skill triggers when editing agent-customization files: - `src/commands/customize.js` - `src/prompts/customize-agents.md` --- You are working on **agent customization** — the feature that reads a project's skills and AGENTS.md, then uses Claude CLI to inject project-specific context into generic agent files in `.claude/agents/`. ## Key Files - `src/commands/customize.js` — Main command: finds agents, gathers context, calls Claude, writes results - `src/prompts/customize-agents.md` — System prompt telling Claude how to customize agents - `src/lib/runner.js` — `runClaude()`, `loadPrompt()`, `parseFileOutput()` shared across commands - `src/lib/skill-writer.js` — `writeSkillFiles()` writes parsed output to disk - `src/lib/timeout.js` — `resolveTimeout()` for timeout handling (default 300s) ## Key Concepts - **Claude-only feature:** Customize command reads `.aspens.json` and throws `CliError` if repo is configured for Codex-only (`targets: ['codex']`). Codex CLI has no agent concept. - **Context gathering:** `gatherProjectContext()` reads AGENTS.md (truncated at 3000 chars), all `.claude/skills/**/*.md` in full, and lists `.claude/guidelines/` paths without reading their contents. - **Agent discovery:** `findAgents()` recursively walks `.claude/agents/`, reads `.md` files, extracts `name:` via regex — falls back to filename if no frontmatter match. - **Read-only tools:** Claude is invoked with `allowedTools: ['Read', 'Glob', 'Grep']` and no maxTokens cap (unlike doc-init which sets per-call limits). - **Output parsing:** Claude returns `<file path="...">content</file>` XML tags, parsed by `parseFileOutput()`. Only `.claude/` paths are allowed. ## Critical Rules - **Claude-only** — throws `CliError` for Codex-only repos. Checks `readConfig(repoPath)` for target config. - **Read-only tools only** — Claude agents never get write tools. All output goes through `parseFileOutput()` → `writeSkillFiles()`. - **Context truncation** — AGENTS.md is capped at 3000 chars to avoid blowing up prompt size. Skills are read in full. - **Path safety** — `parseFileOutput()` only allows writes to `.claude/` prefixed paths. Customized agents stay in `.claude/agents/`. - **Dry-run support** — `--dry-run` flag previews output without writing. Confirmation prompt shown before writes. - **Model override** — `--model` flag passed through to `runClaude()` for model selection. --- **Last Updated:** 2026-04-02