What is aid-describe?

A guided interview that gathers requirements from a person and writes them to a REQUIREMENTS.md file. It clarifies what should be built, who will use it, and how success will be checked.

Use it at the start of a project to interview a stakeholder, capture requirements, and prepare for the next definition step.

It helps turn a rough idea into a defined scope and acceptance criteria through one question at a time.

aid-describe — Skill for Claude Code by AndreVianna/aid-methodology

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo

git clone --depth 1 https://github.com/AndreVianna/aid-methodology

agentmods

npx agentmods add skills/andrevianna/aid-methodology/aid-describe

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/andrevianna/aid-methodology/aid-describe/github.svg)](https://agentmods.dev/skills/andrevianna/aid-methodology/aid-describe)

Your own site

<a href="https://agentmods.dev/skills/andrevianna/aid-methodology/aid-describe"><img src="https://agentmods.dev/badge/skills/andrevianna/aid-methodology/aid-describe/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/andrevianna/aid-methodology/aid-describe"><img src="https://agentmods.dev/badge/skills/andrevianna/aid-methodology/aid-describe.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 119 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 4,051 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. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

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.

Model	Per session	Once invoked
Fable 5.1	$0.00119	$0.04051
Opus 5.5	$0.00048	$0.01620
Sonnet 5.5	$0.00024	$0.00810
Haiku 4.5	$0.00012	$0.00405

Measured 26d ago against content hash 34b679dae631, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

aid-describe 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 26d 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.

.agents/skills/aid-describe/SKILL.md · 312 lines

How it starts

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

Conversational Requirements Gathering

State machine: FIRST-RUN -> Q-AND-A -> CONTINUE -> {greenfield: DESCRIBE-SEED ->} COMPLETION [PAUSE -> /aid-define].

Agents Involved

aid-describe is multi-agent — different states use different agents.

State	Phase	Agent	Why
1–4	Conversational interview	`aid-interviewer`	Empathetic dialogue, deterministic advancing
DESCRIBE-SEED	Greenfield KB seed authoring (aid-describe step per D3)	`aid-interviewer` + dispatches `aid-reviewer` for step 5	Engine-driven 5-element seed elicitation + doc authoring + coherence check + greenfield-mode review gate

The frontmatter default agent: aid-interviewer covers States 1–4. DESCRIBE-SEED also uses aid-interviewer, additionally dispatching aid-reviewer for its step 5 greenfield-mode review gate.

Gather requirements from a human stakeholder through the seasoned-analyst elicitation engine (references/elicitation-engine.md): one fixed D1 opener followed by a deterministic five-step next-move selector that adapts each question to the current gap, calibration state, and move playbook (references/move-playbook.md, references/calibration.md, references/advisor-stance.md). One question per turn. Builds REQUIREMENTS.md incrementally -- each confirmed answer updates the document immediately.

Workspace structure:

.aid/
  knowledge/           <- shared KB (populated by /aid-discover)
  work-001-name/       <- one work = one interview cycle
    STATE.md           <- process (§§ Interview State, Cross-phase Q&A, Features State...)
    REQUIREMENTS.md    <- product (clean document, only project information)
    features/          <- product (one folder per feature, created by /aid-define)
      feature-001-name/
                       #  § 11 feature sections gain their technical specification
                       #  when /aid-specify runs

First run: Conversational interview from scratch. Subsequent runs (before approval): Resume interview for incomplete sections. After approval: Approved REQUIREMENTS.md is ready — run /aid-define {work} to decompose into features. Loopback: Process Q&A injected by downstream phases (e.g., /aid-specify).

Read the full file on GitHub · 312 lines

Files

What ships with it

13 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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.

26d ago Changed 34b679dae631
1mo ago Changed · +1 lines 35d7e94aa996
2mo ago First seen · 311 lines · 119 tokens per session scan A 2bae84bbe1db

Subscribe to this mod's changes

aid-describe is a skill published in the GitHub repository AndreVianna/aid-methodology (6 stars, last pushed 11d ago), licensed MIT. It adds 119 tokens to every session and 4,051 once invoked, about $0.0005 per session on Opus 5.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-31.

Planning

aid-describe next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
aid-describeAndreVianna/aid-methodology	Skill	6	11d ago	MIT	A	119	Claude Code
imagegenopenai/codex	Skill	134k	today	Apache-2.0	A	113	Codex
local-ai-agentsmicrosoft/ai-agents-for-beginners	Skill	79k	yesterday	MIT	A	200	Claude Code, Codex
playwright-climicrosoft/playwright	Skill	100k	yesterday	Apache-2.0	A	19	Claude Code
browser-automationopenclaw/openclaw	Skill	394k	today	MIT	A	36	Claude Code
systematic-debuggingobra/superpowers	Skill	314k	4d ago	MIT	A	21	Claude Code
next-cache-components-adoptionvercel/next.js	Skill	143k	today	MIT	A	95	Claude Code