Skip to content
SkillMixed2,660 tokens in use

Claude Agents

Drive headless Claude Code (claude -p) from another agent as a peer, a builder or a fresh reviewer, through a wrapper that keeps sessions and modes.

680 stars on the repository MIT Licensephuryn/product-engineering · agent-teams/skills/claude-agents
npx skills add phuryn/product-engineering
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Claude Agents costs

40tokens idle
2,660tokens in use
5,351tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/claude_agent.py.

Touches

shelldetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure9/25
  • Examples12/15
  • Output10/15
  • Size15/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 42
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 42

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity100
  • Maintenance100
  • Community44
  • Maturity4
  • Momentum40

Claude Agents lets any agent hand work to a headless Claude Code session: ask Claude to argue a decision, build a stage, or review a change it has never seen. It is triggered by requests like “ask Claude” or “have Claude build or review this”.

A Python wrapper, claude_agent.py, runs the session in three modes (consult, build, review), repeats the mode’s flags on every turn, resumes sessions per directory and prints one status line with the session id, permission mode, model and cost.

What You Get

  • claude_agent.py, a standard-library Python wrapper with consult, build and review modes
  • Rules for the opening brief and for follow-up turns that argue a decision through
  • Guidance on resume versus a fresh session, worktrees for parallel builds and explicit session ids
  • A status line after every run naming the actual permission mode, model, effort and cost
  • A troubleshooting reference for transcripts, sandbox setup, permission denials and usage limits

Common Use Cases

  • Getting a second opinion from a fresh Claude session on a plan
  • Giving a non-Claude agent a Claude builder for a stage
  • Running a fresh reviewer that never saw the build
  • Resuming an earlier headless session by id

What Makes It Unique

The wrapper resends the mode’s tools and permission flags on every turn, because a resume drops them otherwise, and it warns when the permission mode that ran differs from the one requested. Review mode is isolated by design: the reviewer has read tools only, with memory off and nothing saved, so it starts from the brief alone. The skill also says when to skip delegation: if the brief would be nearly as long as the diff, write the diff.

Under The Hood

The skill is instructions, a troubleshooting reference and one Python wrapper that uses only the standard library. The wrapper launches the claude command-line tool as a subprocess in the repository you name, sends the brief on stdin, and keeps a small state file with the session id. In build mode the delegate edits files and runs shell commands under auto mode, and consult mode can run read-only git commands, so the repository’s hooks run. Review mode restricts the delegate to read tools. The skill itself fetches no web pages.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers