richfrem/gemini-cli-agent
plugins/cli-agents/skills/gemini-cli-agent/SKILL.md
Gemini CLI sub-agent system for cost-efficient analysis using the `gemini` binary. Use when piping large contexts to cheaper Google Gemini models (gemini-3-flash-preview, gemini-3.1-pro-preview) for security audits, architecture reviews, or QA analysis. For frontier models (Gemini 3.5 Flash and above), use agy-cli-agent instead.
$ install --global
skillsauthnpx skillsauth add richfrem/agent-plugins-skills gemini-cli-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 29, 2026, 3:33 AM327.2s14 files scanned
SKILL.md
- name:
- gemini-cli-agent
- plugin:
- cli-agents
- description:
- >
- allowed-tools:
- Bash, Read, Write
[!WARNING] Gemini CLI consumer access ended June 18, 2026. Free, Pro, and Ultra users no longer have access. Only enterprise Gemini Code Assist Standard/Enterprise licenses retain the
geminibinary. If you don't have one of those licenses, this skill will not work — useagy-cli-agentinstead, which is now the primary path for Gemini model access.
Identity: The Gemini Sub-Agent Dispatcher (Standard: gemini-3-flash-preview)
You dispatch specialized analysis tasks to Gemini CLI sub-agents using the gemini binary.
[!IMPORTANT] Default model: gemini-3-flash-preview (cost-efficient). For deep reasoning, use gemini-3.1-pro-preview. For frontier models (Gemini 3.5 Flash+), use
agy-cli-agentinstead.
Minimal Working Pattern
gemini -m gemini-3-flash-preview -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
python ./scripts/run_agent.py <PERSONA_FILE> <INPUT_FILE> <OUTPUT_FILE> "<INSTRUCTION>" [MODEL_NAME]
Mandatory Health Check
Before any complex orchestration:
gemini --yolo -m gemini-3-flash-preview -p "hello"python ./scripts/run_agent.py agents/refactor-expert.md target.py ./heartbeat.md "Verify health"- Confirm
./heartbeat.mdis not empty.
Example
python ./scripts/run_agent.py agents/security-auditor.md target.py security.md \
"Find vulnerabilities. Use severity levels: 🔴 CRITICAL, 🟡 MODERATE, 🟢 MINOR."
Persona Registry (agents/)
| 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 |
Capability Boundary
Image Generation NOT supported
The gemini binary is text and code only. Image generation models require the Python google-genai SDK with a paid billing account.
Model Capacity
gemini-3.1-pro-preview may hit MODEL_CAPACITY_EXHAUSTED (429) under load — retry or fall back to gemini-2.5-pro.
CLI Best Practices
Avoid Shell Expansion for Large Contexts
$(cat ...) > 10KB can silently fail in background processes. Use run_agent.py which writes to a temp file.
Autonomous Orchestration (--yolo)
Pass --yolo to allow all tool calls to run without confirmation for headless operation.
Workspace Boundary (IDEClient Directory Mismatch)
Always invoke gemini from your active workspace directory. To operate in an external folder, pass a cd instruction in the prompt itself.
Backgrounding & TTY (SIGTTIN)
nohup gemini --yolo -m gemini-3-flash-preview -p "..." >> log.txt 2>&1 < /dev/null &
< /dev/null is critical to prevent SIGTTIN stops.
Update / Install
npm install -g @google/gemini-cli@latest
# or via npx (run_agent.py falls back to this automatically)
npx @google/gemini-cli
Smoke Test
gemini -p "hello"
python ./scripts/run_agent.py agents/refactor-expert.md target.py output.md "Refactor this code."
Related Skills
richfrem/issue-worktree-agent
testing
VerifiedTrustedCommunity
Skill for creating and managing isolated git worktrees (`.worktrees/issue-NNN`) for issue execution branches. USE ONLY when setting up or cleaning up isolated git worktrees for specific issue execution. DO NOT USE for managing local task files (use `task-agent`) or escalating tasks to issues (use `github-issue-backlog-agent`).
4SKILL.mdUpdated Jul 29, 2026
richfrem/issue-pr-lifecycle-agent
data-ai
VerifiedTrustedCommunity
Skill for orchestrating the end-to-end GitHub issue lifecycle flow: Issue -> Worktree -> Implementation -> PR Creation -> Resolution Closure. USE ONLY when running or dry-running full lifecycle orchestration for resolving an issue with a PR. DO NOT USE for isolated worktree management only (use `issue-worktree-agent`) or logging issues (use `github-issue-agent`).
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-prioritizer
tools
VerifiedTrustedCommunity
Automatically ranks GitHub issues (P0-P3) based on friction tier, frequency, and blockages, synchronizing priority labels and GitHub Projects v2 custom fields.
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-backlog-agent
testing
VerifiedTrustedCommunity
Bridge skill for escalating ephemeral local task scratchpad items (`tasks/*.md`) into durable, taxonomy-validated, evidence-rich GitHub Issues. USE ONLY when promoting a single-session local task into durable repository backlog. DO NOT USE for managing local kanban boards (use `task-agent` instead) or directly querying/commenting on issues (use `github-issue-agent` instead).
4SKILL.mdUpdated Jul 29, 2026