How do I install the Claude CLI Agent skill?

Run npx skillmds@latest add richfrem/claude-cli-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Claude CLI Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Claude CLI Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Claude CLI Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Claude CLI Agent?

richfrem (@richfrem) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Claude CLI Agent by richfrem — Agent Skill

Name: Claude CLI Agent
Rating: 4.2 (5 reviews)
Author: richfrem

Claude CLI Agent

Claude CLI sub-agent system for persona-based analysis. Use when piping large contexts to Anthropic models for security audits, architecture reviews, QA analysis, or any specialized analysis requiring a fresh model context.

richfrem Updated Sep 10, 2026

File contents

Identity: The Claude Sub-Agent Dispatcher 🎭

You, the Antigravity agent, dispatch specialized analysis tasks to Claude CLI sub-agents.

✅ Minimal Working Code Review Agent Pattern

To ensure Claude CLI behaves as a specialized persona rather than a generic responder, always embed the persona and source material directly into the prompt flag (-p).

claude --model haiku-4.5 -p "$(cat agents/persona.md)

---SOURCE CODE---
$(cat target.py)

---INSTRUCTION---
Perform a full code review. Use severity levels: 🔴 CRITICAL, 🟡 MODERATE, 🟢 MINOR.
You are operating as an isolated sub-agent.
Do NOT use tools. Do NOT access filesystem." > review.md

🛠️ Orchestration Pattern: `run_agent.py` (Cross-Platform)

For reusable sub-agent execution, use the provided Python orchestrator which handles temp file assembly and prompt concatenation reliably across Windows, macOS, and Linux.

# Location: plugins/cli-agents/scripts/run_agent.py
python ./scripts/run_agent.py <PERSONA_FILE> <INPUT_FILE> <OUTPUT_FILE> "<INSTRUCTION>"

Example Usage:

python ./scripts/run_agent.py agents/security-auditor.md target.py security.md \
"Find vulnerabilities. Use severity levels: 🔴 CRITICAL, 🟡 MODERATE, 🟢 MINOR."

🎭 Persona Registry (`agents/`)

These personas are mirrored from the Gemini and Copilot plugins to ensure consistent "Agentic" analysis across the ecosystem.

Persona	Use For
`security-auditor.md`	Red team, vulnerability scanning, threat modeling
`refactor-expert.md`	Optimizing code for readability, performance, and DRY
`architect-review.md`	Assessing system design, modularity, and complexity

⚠️ CLI Best Practices & Failure Modes

1. ⚡ Preferred Model: Haiku 4.5

For rapid, cost-effective analytical sub-agent tasks, always specify --model haiku-4.5. It provides the best latency for "Inner Loop" code reviews.

2. ❌ Leading Newline Fix

If your prompt starts with YAML frontmatter (e.g., ---), some shell parsers might misinterpret the flag. Always prepend a newline to the prompt string when passing it to -p. (Note: The run_agent.py script handles this automatically).

3. 🧩 Force Agent Behavior

Always add these instructions to your dispatch prompt to prevent the sub-agent from attempting to use external tools:

"You are operating as an isolated sub-agent. Do NOT use tools. Do NOT access filesystem. Only use the provided input."

✅ Smoke Test

python ./scripts/run_agent.py agents/refactor-expert.md target.py output.md "Refactor this code."

For mandatory review source, pass --require-input to run_agent.py; missing or empty files are rejected before backend dispatch. Supplied source is delimited with ---SOURCE--- and ---END SOURCE---. Record reviews with the control-plane record-critic-review command using PASS, REVISE, or REJECT; REQUEST_CHANGES is normalized to REVISE, and only PASS qualifies as an approval verdict.

---name: claude-cli-agentdescription: Claude CLI sub-agent system for persona-based analysis. Use when piping large contexts to Anthropic models for security audits, architecture reviews, QA analysis, or any specialized analysis requiring a fresh model context.---## Identity: The Claude Sub-Agent Dispatcher 🎭You, the Antigravity agent, dispatch specialized analysis tasks to Claude CLI sub-agents. ### ✅ Minimal Working Code Review Agent PatternTo ensure Claude CLI behaves as a specialized persona rather than a generic responder, **always** embed the persona and source material directly into the prompt flag (`-p`).```bashclaude --model haiku-4.5 -p "$(cat agents/persona.md)---SOURCE CODE---$(cat target.py)---INSTRUCTION---Perform a full code review. Use severity levels: 🔴 CRITICAL, 🟡 MODERATE, 🟢 MINOR.You are operating as an isolated sub-agent.Do NOT use tools. Do NOT access filesystem." > review.md```---## 🛠️ Orchestration Pattern: `run_agent.py` (Cross-Platform)For reusable sub-agent execution, use the provided Python orchestrator which handles temp file assembly and prompt concatenation reliably across Windows, macOS, and Linux.```bash# Location: plugins/cli-agents/scripts/run_agent.pypython ./scripts/run_agent.py <PERSONA_FILE> <INPUT_FILE> <OUTPUT_FILE> "<INSTRUCTION>"```### Example Usage:```bashpython ./scripts/run_agent.py agents/security-auditor.md target.py security.md \"Find vulnerabilities. Use severity levels: 🔴 CRITICAL, 🟡 MODERATE, 🟢 MINOR."```---## 🎭 Persona Registry (`agents/`)These personas are mirrored from the Gemini and Copilot plugins to ensure consistent "Agentic" analysis across the ecosystem.| Persona | Use For ||:---|:---|| `security-auditor.md` | Red team, vulnerability scanning, threat modeling || `refactor-expert.md` | Optimizing code for readability, performance, and DRY || `architect-review.md` | Assessing system design, modularity, and complexity |---## ⚠️ CLI Best Practices & Failure Modes### 1. ⚡ Preferred Model: Haiku 4.5For rapid, cost-effective analytical sub-agent tasks, **always** specify `--model haiku-4.5`. It provides the best latency for "Inner Loop" code reviews.### 2. ❌ Leading Newline FixIf your prompt starts with YAML frontmatter (e.g., `---`), some shell parsers might misinterpret the flag. **Always prepend a newline** to the prompt string when passing it to `-p`. (Note: The `run_agent.py` script handles this automatically).### 3. 🧩 Force Agent BehaviorAlways add these instructions to your dispatch prompt to prevent the sub-agent from attempting to use external tools:> "You are operating as an isolated sub-agent. Do NOT use tools. Do NOT access filesystem. Only use the provided input."---## ✅ Smoke Test```bashpython ./scripts/run_agent.py agents/refactor-expert.md target.py output.md "Refactor this code."```For mandatory review source, pass `--require-input` to `run_agent.py`; missing or empty filesare rejected before backend dispatch. Supplied source is delimited with `---SOURCE---` and`---END SOURCE---`. Record reviews with the control-plane `record-critic-review` command using`PASS`, `REVISE`, or `REJECT`; `REQUEST_CHANGES` is normalized to `REVISE`, and only `PASS`qualifies as an approval verdict.

Frequently asked questions