gen-spec

gen-spec is a skill for Claude Code from pe-menezes/vibeflow. It costs 74 tokens per session (2,323 once invoked), scanned A, original, MIT.

A skill that creates a technical specification from a product requirements document or a short feature description, using project-specific patterns from the .vibeflow folder.

In plain words
What is it for?
Writing objectives, scope, anti-scope, technical decisions, and three to seven binary Definition-of-Done checks.
Why use it?
It turns broad requirements into a bounded plan with testable completion checks and explicit exclusions.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the vibeflow plugin — 10 skills, 3 agents shipped together

Good fit Writing objectives, scope, anti-scope, technical decisions, and three to seven binary Definition-of-Done checks.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/pe-menezes/vibeflow/gen-spec
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.

Any agent
npx skills add pe-menezes/vibeflow --skill gen-spec
Clone the repo
git clone --depth 1 https://github.com/pe-menezes/vibeflow

Made for: Claude Code.

Or install vibeflow, the plugin that ships this one along with the rest of its 10 skills, 3 agents.

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 gen-spec

README.md
[![agentmods](https://agentmods.dev/badge/skills/pe-menezes/vibeflow/gen-spec/github.svg)](https://agentmods.dev/skills/pe-menezes/vibeflow/gen-spec)
Your own site
<a href="https://agentmods.dev/skills/pe-menezes/vibeflow/gen-spec"><img src="https://agentmods.dev/badge/skills/pe-menezes/vibeflow/gen-spec/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.

agentmods 80×15 button for gen-spec

Your own site · 80×15
<a href="https://agentmods.dev/skills/pe-menezes/vibeflow/gen-spec"><img src="https://agentmods.dev/badge/skills/pe-menezes/vibeflow/gen-spec.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 74 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,323 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00074 $0.02323
Opus 5.5 $0.00030 $0.00929
Sonnet 5.5 $0.00015 $0.00465
Haiku 4.5 $0.00007 $0.00232

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

Security

Grade A, and why

gen-spec 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 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.

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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

  • gen-spec — 88% identical, 0 lines differ
plugins/vibeflow/skills/gen-spec/SKILL.md · 185 lines

How it starts

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

Description and examples

What it does: Produces a technical spec in .vibeflow/specs/<slug>.md with objective, Definition of Done (3–7 binary checks), scope, anti-scope, technical decisions, and applicable patterns. Reads .vibeflow/ to ground the spec in your project. Can take a PRD path (from discover) or a short feature description.

Examples:

  • gen-spec .vibeflow/prds/login-flow.md — Generate spec from an existing PRD.
  • gen-spec adicionar endpoint POST /auth/login que retorna JWT — Generate spec from a one-line description (uses .vibeflow/ patterns).

Language

Detect the language of the user's current request or conversation. Write ALL output in that same language. Technical terms in English are acceptable regardless of the detected language. A few literals are exempt and stay in English in any output language, because other commands match them byte for byte: the ## References and ## Clarifications headings, the Scenarios: and Risk code: labels, the [NEEDS CLARIFICATION: …] marker, and the EARS keywords WHEN and THE SYSTEM SHALL.

Web Search Policy

Use WebSearch and WebFetch only when local context (.vibeflow/, codebase, git history) is insufficient — an unfamiliar framework or API. Local first.

Generate a complete spec for the feature in the user's current request.

Before writing the spec

  1. Read the input. A path to a .md inside .vibeflow/prds/ is a PRD: problem, audience, solution, scope, and anti-scope are already settled — your job is translating them into technical decisions, binary DoD checks, and applicable patterns. Anything else is a feature description. When the PRD has a ## Clarifications section, carry its entries into the spec's own ## Clarifications, so the answers travel with the contract.
  2. Load context from .vibeflow/, if it exists:
    • index.md — project context. Its Suggested budget: ≤ N line is this spec's budget; without it, ≤6 files.
    • conventions.md — the project's standards.
    • Patterns: read the ## Pattern Registry block in index.md (between <!-- vibeflow:patterns:start/end --> markers), cross-reference its tags and modules against the feature, and load the top 3–5 matches. With no registry, fall back to reading all pattern docs.

Read the full file on GitHub · 185 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 Changed · +53 lines bb229b47269e
  2. 1mo ago Changed · -1 lines 9ba6a8a9ba97
  3. 1mo ago First seen · 133 lines · 74 tokens per session scan A 3cdc08bd6724

Subscribe to this mod's changes

gen-spec is a skill published in the GitHub repository pe-menezes/vibeflow (32 stars, last pushed yesterday), licensed MIT. It adds 74 tokens to every session and 2,323 once invoked, about $0.0003 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-30.

Related

Other skills, from other repositories

code-review-csharp

Perform structured code reviews of C# source code covering naming conventions, performance, security, readability, and .NET best practices. Trigger phrases include "review this C# code", "check my C# for best practices", "analyze this C# class", "find issues in my C# code".

pnp/copilot-prompts · 66 tokens

megalinter-check

Collect MegaLinter lint errors for the current repository. Use when the user wants to know if the code passes linting, why the MegaLinter CI job fails, or before/after fixing lint errors. Two modes - watch a CI job (GitHub Actions, GitLab CI, Azure Pipelines, Bitbucket Pipelines) and parse its logs, or run MegaLinter…

ulises-jeremias/agent-toolkit · 96 tokens

assistant

Assistant — on any repo, scan README→docs→AGENTS→CONTRIBUTING→PR templates→task runners→devcontainer→CI→configs before code; cite sources; prefer AGENTS.md for agent behavior; portable across Cursor/Copilot/Claude; use agent-toolkit CLI when needed.

ulises-jeremias/agent-toolkit · 64 tokens

design-improvement

WHAT - Browser-grounded iterative design improvement. Consumes design-assessment findings, defines direction, prioritizes safe vs ambiguous changes, implements within existing design system, runs app, captures rendered evidence via browser, reviews and iterates. Reuses evidence model — no new scoring framework.

ulises-jeremias/agent-toolkit · 60 tokens

review

WCAG 2.2 AA curated accessibility review — distinguishes automatically detectable, browser-assisted, and manual/human-judgment findings with evidence citations and SC mapping. Composes with design-assessment/design-improvement/frontend-design-review.

ulises-jeremias/agent-toolkit · 48 tokens

chrome-devtools

Use Chrome DevTools MCP to control and inspect a live Chrome instance for network, console, performance, rendering, and Deep debugging. Pairs with playwright-cli (deterministic interaction/E2E) — complements, not duplicates.

ulises-jeremias/agent-toolkit · 50 tokens