agents-reverse-engineer: Skill for Claude Code

.claude/skills/are-generate/SKILL.md

are-generate is a skill for Claude Code from GeoloeG-IsT/agents-reverse-engineer. It costs 13 tokens per session (577 once invoked), scanned A, original, MIT.

A documentation generator for turning an entire codebase into documentation that an AI assistant can use.

In plain words
What is it for?
Use it to analyze source files, document directories, report failures, and flag consistency warnings.
Why use it?
It removes the need to explain a large codebase manually and shows progress while the documentation is being created.

Skill for Claude Code

Written for Claude Code: disable-model-invocation in frontmatter. Also seen: mentions CLAUDE.md; mentions AGENTS.md.

This is GeoloeG-IsT/agents-reverse-engineer's own configuration. It tells Claude Code how to work on agents-reverse-engineer itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything agents-reverse-engineer configures →

Reuse

Borrowing it

Nothing to install: this file belongs to GeoloeG-IsT/agents-reverse-engineer. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/GeoloeG-IsT/agents-reverse-engineer/main/.claude/skills/are-generate/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/GeoloeG-IsT/agents-reverse-engineer

Made for: Claude Code.

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 are-generate

README.md
[![agentmods](https://agentmods.dev/badge/skills/geoloeg-ist/agents-reverse-engineer/are-generate.svg)](https://agentmods.dev/skills/geoloeg-ist/agents-reverse-engineer/are-generate)
Your own site
<a href="https://agentmods.dev/skills/geoloeg-ist/agents-reverse-engineer/are-generate"><img src="https://agentmods.dev/badge/skills/geoloeg-ist/agents-reverse-engineer/are-generate.svg" alt="Measured on agentmods" height="20"></a>
Per session 13 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 577 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00013 $0.00577
Opus 5 $0.00006 $0.00289
Sonnet 5 $0.00003 $0.00115
Haiku 4.5 $0.00001 $0.00058

Measured 8d ago against content hash cb24126a4568, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

are-generate 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 8d 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.

.claude/skills/are-generate/SKILL.md · 47 lines

What it actually says

Generate comprehensive documentation for this codebase using agents-reverse-engineer.

Steps

  1. Read version: Read .claude/ARE-VERSION → store as $VERSION. Show the user: agents-reverse-engineer v$VERSION

  2. Run the generate command in the background using run_in_background: true:

    npx agents-reverse-engineer@$VERSION generate --backend claude $ARGUMENTS
    
  3. Monitor progress by polling the latest progress log:

    • Wait ~15 seconds (use sleep 15 in Bash), then use Glob to find the latest .agents-reverse-engineer/progress-*.log file, and Read it (use the offset parameter to read only the last ~20 lines for long files)
    • Show the user a brief progress update (e.g. "32/96 files analyzed, ~12m remaining")
    • Check whether the background task has completed using TaskOutput with block: false
    • Repeat until the background task finishes
    • Important: Keep polling even if no progress log exists yet (the command takes a few seconds to start writing)
  4. On completion, read the full background task output and summarize:

    • Number of files analyzed and any failures
    • Number of directories documented
    • Any inconsistency warnings from the quality report

This executes a two-phase pipeline:

  1. File Analysis (concurrent): Discovers files, applies filters, then analyzes each source file via AI and writes .sum summary files with YAML frontmatter (content_hash, file_type, purpose, public_interface, dependencies, patterns).

  2. Directory Aggregation (sequential): Generates AGENTS.md per directory in post-order traversal (deepest first, so child summaries feed into parents), and writes CLAUDE.md pointers.

Options:

  • --dry-run: Preview the plan without making AI calls
  • --eval: Namespace output by backend.model for side-by-side comparison (e.g., file.ts.claude.haiku.sum, AGENTS.claude.haiku.md)
  • --concurrency N: Control number of parallel AI calls (default: auto)
  • --fail-fast: Stop on first file analysis failure
  • --debug: Show AI prompts and backend details
  • --trace: Enable concurrency tracing to .agents-reverse-engineer/traces/
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. 8d ago First seen · 47 lines · 13 tokens per session scan A cb24126a4568

Subscribe to this mod's changes

are-generate is a skill published in the GitHub repository GeoloeG-IsT/agents-reverse-engineer (20 stars, last pushed 1mo ago), licensed MIT. It adds 13 tokens to every session and 577 once invoked, about $0.0001 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.