Agent skill

Sdd Generator

by ricneves-ai in ricneves-ai/flowgrammers-skills

Especialista em SDD (Software Design Document) — transforma um PRD completo numa estrutura de specs quebrada por pasta no formato .specs/NNN-nome/, com contextos isolados por feature, arquivo…

MITAuto-check passedProduct & Project Management

Install Sdd Generator

skills CLI
$ npx skills add ricneves-ai/flowgrammers-skills --skill sdd-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ricneves-ai/flowgrammers-skills sdd-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ricneves-ai/flowgrammers-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/sdd-generator .claude/skills/sdd-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sdd-generator
GitHub stars
115
Token cost
~1.1k tokens
SKILL.md length
396 words
Files
4 (incl. references)
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Especialista em SDD (Software Design Document) — transforma um PRD completo numa estrutura de specs quebrada por pasta no formato .specs/NNN-nome/, com contextos isolados por feature, arquivo…

  • Works in 3 steps: Mostrar o plano de decomposição primeiro… → Aguardar confirmação OU prosseguir… → Gerar todos os arquivos em sequência,…
  • Também quando o usuário mencionar executar specs
  • SKILL.md covers O que esta skill produz, PROCESSO OBRIGATÓRIO, REGRAS DE QUALIDADE and FORMATO DE SAÍDA, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Sdd Generator is an agent skill from ricneves-ai/flowgrammers-skills. Especialista em SDD (Software Design Document) — transforma um PRD completo numa estrutura de specs quebrada por pasta no formato .specs/NNN-nome/, com contextos isolados por feature, arquivo EXECUTAR-SPECS.md que dispara subagentes em paralelo, regras de nomenclatura e templates prontos para Claude Code. Use esta skill SEMPRE que o usuário enviar um PRD, documento de requisitos, lista de features, história de usuário detalhada, ou pedir para "quebrar em specs", "gerar SDD", "criar estrutura de tasks", "preparar…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/executar-specs-template.md`, `references/exemplos-decomposicao.md` and `references/spec-template.md`).

It sits in Product & Project Management, covering PRD writing. The repository describes itself as: Flowgrammers Skills - Enteprise Skills. The licence is MIT.

When your agent uses it

  • Também quando o usuário mencionar executar specs
  • Subagentes paralelos
  • Specs por feature
  • Contexto isolado por task ou perguntar como organizar um projeto para agentes

Example prompts

  • “quebrar em specs”
  • “gerar SDD”
  • “criar estrutura de tasks”
  • “/sdd-generator”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Mostrar o plano de decomposição primeiro (lista das NNN features com uma linha cada)
  2. Aguardar confirmação OU prosseguir diretamente se o usuário disser "pode gerar tudo"
  3. Gerar todos os arquivos em sequência, cada um em bloco de código com o path

What it can do on your machine

Read from SKILL.md and the folder at commit 1ae2d4a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sdd Generator loads about 1.1k tokens when it runs, and up to ~3.1k if it reads all its reference files. Until then it costs about 200 tokens; SKILL.md has 396 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~200
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ricneves-ai/flowgrammers-skills at commit 1ae2d4a, republished under its MIT licence (© ricneves-ai). 396 words, ~1,113 tokens.

Download SKILL.mdSave it as .claude/skills/sdd-generator/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
sdd-generator
description
Especialista em SDD (Software Design Document) — transforma um PRD completo numa estrutura de specs quebrada por pasta no formato .specs/NNN-nome/, com contextos isolados por feature, arquivo EXECUTAR-SPECS.md que dispara subagentes em paralelo, regras de nomenclatura e templates prontos para Claude Code. Use esta skill SEMPRE que o usuário enviar um PRD, documento de requisitos, lista de features, história de usuário detalhada, ou pedir para "quebrar em specs", "gerar SDD", "criar estrutura de tasks", "preparar para Claude Code", "montar .specs", "estruturar subagentes" ou qualquer variação. Trigger também quando o usuário mencionar "executar specs", "subagentes paralelos", "specs por feature", "contexto isolado por task" ou perguntar como organizar um projeto para agentes.

SDD Generator — Especialista em Software Design Documents

Você é um arquiteto de software especialista em decompor PRDs em specs executáveis para Claude Code com subagentes paralelos e contextos isolados.

O que esta skill produz

Dado um PRD, você gera a estrutura completa:

.specs/
├── 001-criar-projeto/
│   └── spec.md
├── 002-registrar-usuario/
│   └── spec.md
├── 003-login-usuario/
│   └── spec.md
├── NNN-nome-da-feature/
│   └── spec.md
├── archive/          ← specs concluídas (mover após execução)
├── shared/
│   ├── como-executar.md
│   └── regras-de-nomenclatura.md
├── templates/
│   └── spec-template.md
└── EXECUTAR-SPECS.md ← orquestrador de subagentes

PROCESSO OBRIGATÓRIO

Passo 1 — Análise do PRD

Leia o PRD completo e extraia:

  • Domínios/módulos do sistema
  • Features atômicas (cada uma deve ser executável de forma independente)
  • Dependências entre features (para ordenar corretamente os NNNs)
  • Stack tecnológica mencionada ou inferida
  • Critérios de aceitação por feature
Passo 2 — Decomposição em Features Atômicas

Regras de decomposição:

  • Cada spec deve ser executável por um único subagente sem contexto externo
  • Máximo de 1 responsabilidade por spec (Single Responsibility)
  • Features devem ser ordenadas por dependência (o que precisa existir antes vem com número menor)
  • Nome da pasta: NNN-verbo-substantivo (ex: 003-login-usuario, 007-cadastro-ideia)
  • Verbos preferidos: criar, registrar, login, carregar, cadastrar, listar, editar, deletar, integrar, configurar, deploy
Passo 3 — Gerar cada spec.md

Cada spec.md segue o template em references/spec-template.md. Leia-o agora.

Passo 4 — Gerar EXECUTAR-SPECS.md

Arquivo orquestrador que dispara todos os subagentes. Leia references/executar-specs-template.md para o formato exato.

Passo 5 — Gerar arquivos shared/

Sempre gerar:

  • shared/como-executar.md — instruções de execução do projeto
  • shared/regras-de-nomenclatura.md — convenções do projeto

REGRAS DE QUALIDADE

Cada spec.md DEVE ter:
  • Contexto completo e auto-suficiente (o agente NÃO tem acesso a outras specs)
  • Stack explícita (frameworks, libs, versões se relevante)
  • Critérios de aceitação verificáveis
  • Arquivos a criar/modificar listados
  • Dependências (qual spec deve estar pronta antes)
  • Comandos de teste/validação
Show full SKILL.md (154 more words)Show less
EXECUTAR-SPECS.md DEVE ter:
  • Instrução para usar --dangerously-skip-permissions no Claude Code
  • Cada feature como um bloco de subagente independente
  • Ordem de execução respeitando dependências
  • Indicação de quais podem rodar em PARALELO
Contexto isolado significa:
  • Cada subagente recebe APENAS o que precisa para sua task
  • Não assume que outro agente já rodou (valida precondições)
  • Tem seu próprio critério de sucesso

FORMATO DE SAÍDA

Quando o usuário enviar um PRD, você deve:

  1. Mostrar o plano de decomposição primeiro (lista das NNN features com uma linha cada)
  2. Aguardar confirmação OU prosseguir diretamente se o usuário disser "pode gerar tudo"
  3. Gerar todos os arquivos em sequência, cada um em bloco de código com o path

Se estiver com acesso ao filesystem, criar os arquivos diretamente em .specs/. Se não tiver, entregar como blocos de código markdown com paths explícitos.


REFERÊNCIAS

  • references/spec-template.md — template padrão de spec.md
  • references/executar-specs-template.md — template do orquestrador
  • references/exemplos-decomposicao.md — exemplos reais de decomposição de PRDs

© ricneves-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in sdd-generator of ricneves-ai/flowgrammers-skills.

  • SKILL.md
  • references/executar-specs-template.md
  • references/exemplos-decomposicao.md
  • references/spec-template.md

Open the folder on GitHubat commit 1ae2d4a

Compare with similar skills

Sdd Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sdd Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sdd Generator this skillricneves-ai/flowgrammers-skills115—~1.1kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
Ralph Tui Create JSONsubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Prd Generator

    jamesrochabrun/skills

    Generate comprehensive Product Requirements Documents (PRDs) for product managers.

    216 GitHub starsUsed in 2 repos~3.8k tokens
    Product & Project ManagementAuto-check passed

More from ricneves-ai/flowgrammers-skills

All 10 skills in this repo
  • Prd Generator

    ricneves-ai/flowgrammers-skills

    Gerador de PRD (Product Requirements Document) em portugues-BR a partir de um Product Brief.

    115 GitHub stars~2k tokensUpdated 15 days ago
    Auto-check passed
  • Codigo Automacao

    ricneves-ai/flowgrammers-skills

    Skills para desenvolvimento de software, debug, APIs, automações no-code e uso avançado de ferramentas de IA para desenvolvimento.

    115 GitHub stars~2.3k tokensUpdated 15 days ago
    Auto-check: notes
  • Conteudo Copy

    ricneves-ai/flowgrammers-skills

    Skills para criação de conteúdo escrito, copy persuasivo, headlines, emails e artigos em português BR.

    115 GitHub stars~3k tokensUpdated 15 days ago
    Auto-check passed
  • Marketing Vendas

    ricneves-ai/flowgrammers-skills

    Skills para funis de vendas, propostas comerciais, tratamento de objeções e publicidade digital com contexto do mercado brasileiro.

    115 GitHub stars~2.9k tokensUpdated 15 days ago
    Auto-check passed
  • Rotina Organizacao

    ricneves-ai/flowgrammers-skills

    Skills de produtividade pessoal com metodologias GTD, time blocking, gestão de energia e organização de projetos pessoais.

    115 GitHub stars~2.5k tokensUpdated 15 days ago
    Auto-check passed
  • SEO Analitica

    ricneves-ai/flowgrammers-skills

    Skills para otimização de SEO técnico, análise de dados, criação de dashboards e inteligência de negócio para empresas brasileiras.

    115 GitHub stars~2.3k tokensUpdated 15 days ago
    Auto-check passed

Questions about Sdd Generator

What does Sdd Generator do?

Especialista em SDD (Software Design Document) — transforma um PRD completo numa estrutura de specs quebrada por pasta no formato .specs/NNN-nome/, com contextos isolados por feature, arquivo…. Sdd Generator is an agent skill from ricneves-ai/flowgrammers-skills.md que dispara subagentes em paralelo, regras de nomenclatura e templates prontos para Claude Code.

When should I use Sdd Generator?

Sdd Generator fits situations like: também quando o usuário mencionar executar specs; subagentes paralelos; specs por feature; contexto isolado por task ou perguntar como organizar um projeto para agentes.

How do I install Sdd Generator in Claude Code?

Run `npx skills add ricneves-ai/flowgrammers-skills --skill sdd-generator -a claude-code`. Or copy the skill folder (sdd-generator in ricneves-ai/flowgrammers-skills) into .claude/skills/sdd-generator in your project. Claude Code loads it when a task matches its description.

How do I install Sdd Generator in Codex?

Run `npx skills add ricneves-ai/flowgrammers-skills --skill sdd-generator -a codex`. Or copy the skill folder (sdd-generator in ricneves-ai/flowgrammers-skills) into .agents/skills/sdd-generator in your project. Codex loads it when a task matches its description.

Can I use Sdd Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ricneves-ai/flowgrammers-skills --skill sdd-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sdd-generator, .gemini/skills/sdd-generator, .github/skills/sdd-generator and .opencode/skills/sdd-generator in your project.

What does Sdd Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Sdd Generator is instructions for the agent only.

Does Sdd Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sdd Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sdd Generator use?

Sdd Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sdd Generator use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Sdd Generator?

Skills that share tags, products or a category with Sdd Generator: CCPM Project Management (automazeio/ccpm, 8.4k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars) and Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sdd Generator?

ricneves-ai (a GitHub user) maintains it in ricneves-ai/flowgrammers-skills, which has 115 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 25, 2026.

Source: ricneves-ai/flowgrammers-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.