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.
npx agentmods add skills/ralfstrobel/agentic-brownfield-coding/headlessnpx skills add ralfstrobel/agentic-brownfield-coding --skill headlessgit clone --depth 1 https://github.com/ralfstrobel/agentic-brownfield-codingWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00047 | $0.02531 |
| Opus 5 | $0.00023 | $0.01265 |
| Sonnet 5 | $0.00009 | $0.00506 |
| Haiku 4.5 | $0.00005 | $0.00253 |
Grade A, and why
headless 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.
How it starts
The opening of the file, as written. The whole thing — 160 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Claude Code Headless Batch Setup
Your goal is to help the user assemble a small shell script that drives claude -p over many inputs,
running one ephemeral micro-session per item. The result usually lives under .claude/headless/ and pairs
a driver script (*.sh) with a system prompt file (*.md) and potentially an input list file.
Additional user arguments: $ARGUMENTS
Language hint: Always create all generated script content and comments in English, while continuing to speak to the user in the language of their choice.
Platform hint: Instructions and templates assume a Linux host with GNU coreutils. Adapt to the detected user OS.
- macOS — Substitute BSD equivalents for GNU-only utilities.
- Windows — Still use
.shfiles (skip irrelevantchmod +x), assuming Git Bash is available at runtime.
Workflow
- Ensure the user intent is clear. If user arguments are absent or ambiguous, especially regarding the upcoming decisions, elicit the necessary information via informal conversation with the user.
- Advise the user on a sensible strategy using the given background as reference. Push back on choices that are likely to cause token usage escalation, contention, or silent failures.
- Pick the best suited template and copy it to
.claude/headless/<descriptive-name>.shandchmod +xit.- foreach-file.sh — one invocation per file matching a glob argument.
- foreach-line.sh — one invocation per line of stdin (PR numbers, IDs, URLs).
- foreach-task.sh — one invocation per unchecked item in a sibling checklist file. This is the most powerful driver script, capable of ingesting, tracking and resuming progress on arbitrary items. Use when the user wants to prepare and iterate on hand-curated task list (in this or a separate session).
- foreach-task-parallel.sh — same as
foreach-task.shbut runsBATCH_SIZEtasks concurrently per batch. However, tasks with overlapping access scope will race. Check the assumptions block at the top of the script for compatibility before suggesting this option.
- Copy the matching prompt template to
.claude/headless/<descriptive-name>.md.- foreach-file.md
- foreach-line.md
- foreach-task.md (also used for the parallel variant) For task-based scripts, also create a task file based on foreach-task.tasks.md. Tailor all of these files to the user's needs, falling back to interactive feedback as required.
- Tune the parameters in the script such as
CLAUDE_ARGSandBATCH_SIZEper the decisions below. - Review the generated content and flag relevant pitfalls that apply to this setup.
- Remind the user how to run the script from the current working directory,
suggesting a test run on the first items (script can be aborted at any time using
Ctrl+C).
What ships with it
8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- templates/foreach-file.md 790 B
- templates/foreach-file.sh 2.3 KB runs code
- templates/foreach-line.md 799 B
- templates/foreach-line.sh 2.3 KB runs code
- templates/foreach-task-parallel.sh 5.6 KB runs code
- templates/foreach-task.md 798 B
- templates/foreach-task.sh 4.1 KB runs code
- templates/foreach-task.tasks.md 312 B
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.
- 2d ago First seen · 160 lines · 47 tokens per session scan A 416264b90d72
headless is a skill published in the GitHub repository ralfstrobel/agentic-brownfield-coding (28 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 47 tokens to every session and 2,531 once invoked, about $0.0002 per session on Opus 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-08-30.
Other skills, from other repositories
claude-md-writer
Use when creating or refactoring CLAUDE.md files - enforces best practices for size, structure, and content organization.
fable-ruki-agenty
Фейбл руки-агенты — ручной режим оркестрации, где Fable не пишет код, а пишет спеки в тела GH issues и раздаёт готовые задачи рукам: кодинг, код-ревью, gh-операции, CLI-механика, DoD-верификация и укладка файлов — Codex; разведка, чтение и скауты — Grok-воркеры через Orca. Вызывается пользователем явно, не моделью.
explore-codebase
MUST BE USED PROACTIVELY. Universal read-only codebase exploration. Combines jrag graph navigation (call chains, routes, service boundaries, impact analysis, FQN resolution) with broad file-system search (grep, glob, file reading). Use for any exploration: locating code, tracing dependencies, finding patterns, 'where…
paperclip-api
Use when managing Paperclip AI agent companies - creating tasks, managing agents, approving hires, running heartbeats, or any Paperclip control-plane operations via CLI or REST API. Triggers on "paperclip", "задача агенту", "одобри найм", "heartbeat", "запусти агента".
dispatching-parallel-agents
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies.
subagent-driven-development
Use when executing implementation plans with independent tasks in the current session.