Agent-Focus-Group AGENTS.md

Agent-Focus-Group AGENTS.md is an instructions file for Codex, OpenCode from EmZod/Agent-Focus-Group. It costs 2,284 tokens per session, scanned C, original, MIT.

A testing guide and command-line tool for checking whether AI instructions are clear to several AI models. It uses a skill file, a Markdown document that describes a tool or capability, and sends it with a task to the models.

In plain words
What is it for?
Use it to test skill files, improve AI tool documentation, and generate podcasts with multiple voices as described in its example.
Why use it?
It reveals confusing instructions and missing documentation before you publish them. This helps find gaps that a single review may miss.

Instructions file for CodexOpenCode

Install

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.

agentmods
npx agentmods add instructions/emzod/agent-focus-group/agents-md
Clone the repo
git clone --depth 1 https://github.com/EmZod/Agent-Focus-Group

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for Agent-Focus-Group AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/emzod/agent-focus-group/agents-md.svg)](https://agentmods.dev/instructions/emzod/agent-focus-group/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/emzod/agent-focus-group/agents-md"><img src="https://agentmods.dev/badge/instructions/emzod/agent-focus-group/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 2,284 This file is loaded in full into every session.
When invoked 2,284 The same file — it is already loaded in full.
Security scan C 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What 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.

ModelPer sessionOnce invoked
Fable 5 $0.02284 $0.02284
Opus 5 $0.01142 $0.01142
Sonnet 5 $0.00457 $0.00457
Haiku 4.5 $0.00228 $0.00228

Measured 3d ago against content hash 75e1645a2ccf, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

Agent-Focus-Group AGENTS.md scanned grade C with 2 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 3d 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.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

- **Bun runtime** — Install from https://bun.sh (`curl -fsSL https://bun.sh/install | bash`)

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Bun runtime** — Install from https://bun.sh (`curl -fsSL https://bun.sh/install | bash`)
AGENTS.md · 267 lines

How it starts

The opening of the file, as written. The whole thing — 267 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Instructions

TL;DR: Test skill docs against multiple AI models. Run bun run src/cli.ts test <skill-file.md> "<task>" -m qwen/qwen3-coder:free and see what models found confusing.

Prerequisites

Before using Focus Group, you need:

  • Bun runtime — Install from https://bun.sh (curl -fsSL https://bun.sh/install | bash)
  • OpenRouter API key — Free signup at https://openrouter.ai/keys
  • A skill file — Markdown doc describing your tool (see "What's a Skill File?" below)

What This Is

Focus Group tests AI tool documentation by sending it to multiple AI models along with a task. The models respond as QA testers — reporting what confused them and suggesting improvements. This helps you find documentation gaps before shipping.

What's a Skill File?

A skill file is a markdown document containing instructions for AI agents. It describes a tool, API, or capability that an AI should be able to use. See examples/sample-skill.md for a complete example.

# Podcast Generator

Generate podcasts with multiple voices.

## Usage
podcast-gen --voices <count> --duration <minutes> --output <file>

## Parameters
- `--voices`: Number of distinct voices (1-5)
- `--duration`: Length in minutes
- `--output`: Output file path (.mp3)

## Example
podcast-gen --voices 3 --duration 30 --output episode.mp3

Installation

# Clone and install
git clone https://github.com/EmZod/Agent-Focus-Group
cd Agent-Focus-Group
bun install

Important: All commands must be run from inside the Agent-Focus-Group directory.

Quick Start (Free, Zero Cost)

# 1. Set your API key (get from https://openrouter.ai/keys)
export OPENROUTER_API_KEY="sk-or-v1-..."

# 2. Create a test skill file
cat > test-skill.md << 'EOF'
# Test Tool
Does something useful.

## Usage
test-tool --input <file>

## Example
test-tool --input data.txt
EOF

# 3. Run test with FREE model (zero cost)
bun run src/cli.ts test test-skill.md "Process the data in data.txt" -m qwen/qwen3-coder:free

# 4. Results appear in ~30-60 seconds
# View saved results anytime:
bun run src/cli.ts show latest

Read the full file on GitHub · 267 lines

Changes

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.

  1. 3d ago First seen · 267 lines · 2,284 tokens per session scan C 75e1645a2ccf

Subscribe to this mod's changes

Agent-Focus-Group AGENTS.md is an instructions file published in the GitHub repository EmZod/Agent-Focus-Group (2 stars, last pushed 7mo ago), licensed MIT. It adds 2,284 tokens to every session, about $0.0114 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

LLM_trader AGENTS.md

AGENTS.md instructions for qrak/LLM_trader, covering llm trader — master architecture blueprint, 0. instruction authority, 1. system overview, 2. agent inventory and 3. application lifecycle.

qrak/LLM_trader · 22,821 tokens

1Panel-Appstore AGENTS.md

Instructions for arch3rPro/1Panel-Appstore, covering repository guidelines, project shape, app package layout, 1panel conventions and app creation workflow.

arch3rPro/1Panel-Appstore · 821 tokens

abap_wiki AGENTS.md

AGENTS.md instructions for Gixsy95/abap_wiki, covering agents.md - abapwiki operating contract, 1. identity and mission, 2. language, 3. architecture: the two planes and 4. inviolable rules.

Gixsy95/abap_wiki · 3,283 tokens

gnosis-mcp CLAUDE.md

Instructions for nicholasglazer/gnosis-mcp, covering gnosis mcp -- mcp documentation server, architecture, backend protocol, dependencies and tools.

nicholasglazer/gnosis-mcp · 3,017 tokens

python-docs-mcp-server AGENTS.md

AGENTS.md instructions for ayhammouda/python-docs-mcp-server, covering repository guidance, project, autonomous agent execution, canonical commands and mcp testing flow.

ayhammouda/python-docs-mcp-server · 902 tokens

jdocmunch-mcp CLAUDE.md

Claude Code instructions for jgravelle/jdocmunch-mcp, covering jdocmunch-mcp, standing operational notes (jdoc-specific), standing lessons (suite-wide), release: the two steps that are only written down here and 1. read ci for the pushed sha before any irreversible step.

jgravelle/jdocmunch-mcp · 16,700 tokens