Communitygithub.com

ComeOnOliver/skillshub

Converte PRDs (Documentos de Requisitos de Produto) em beads (contas) para execução autônoma com ralph-tui usando beads-rust (CLI br). Cria uma épica com beads filhos para cada história de usuário. Use quando você tiver um PRD e quiser usar ralph-tui com beads-rust como fonte de tarefas.

O que é skillshub?

Este skill permite converter automaticamente um Documento de Requisitos de Produto (PRD) em um conjunto estruturado de 'beads' (contas) – uma épica e múltiplos beads filhos – prontos para execução autônoma via ralph-tui, utilizando a ferramenta beads-rust (comando `br`). O skill extrai as 'Quality Gates' (portões de qualidade) do PRD, cria um bead do tipo épica para a funcionalidade completa e, para cada história de usuário, gera um bead filho com critérios de aceitação que incluem tanto os critérios específicos da história quanto os portões de qualidade globais e específicos de UI. As dependências entre os beads são configuradas automaticamente (por exemplo, esquema → backend → UI), garantindo a ordem correta de execução. O resultado final é um conjunto de beads armazenado em um banco de dados SQLite (`.beads/`) e exportado para JSONL, pronto para ser consumido pelo ralph-tui com o tracker beads-rust. O skill enfatiza que cada história deve ser pequena o suficiente para ser completada em uma única iteração do ralph-tui e fornece regras claras para dividir histórias grandes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/subsy/ralph-tui-create-beads-rust

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Ralph TUI - Criar Beads (beads-rust)

Converte PRDs em beads (épica + tarefas filhas) para execução autônoma com ralph-tui usando beads-rust (CLI br).

Nota: Este skill usa o comando br do beads-rust. Se você tiver o beads original (bd) instalado, use o skill ralph-tui-create-beads.


O Trabalho

Pegue um PRD (arquivo markdown ou texto) e crie beads usando comandos br:

  1. Extraia os Portões de Qualidade da seção "Portões de Qualidade" do PRD
  2. Crie um bead épico para a funcionalidade
  3. Crie beads filhos para cada história de usuário (com os portões de qualidade anexados)
  4. Configure dependências entre os beads (esquema → backend → UI)
  5. Saída pronta para ralph-tui run --tracker beads-rust

Passo 1: Extrair Portões de Qualidade

Procure pela seção "Portões de Qualidade" no PRD:

## Portões de Qualidade

Estes comandos devem passar para toda história de usuário:
- `pnpm typecheck` - Verificação de tipos
- `pnpm lint` - Linting

Para histórias de UI, inclua também:
- Verifique no navegador usando o skill dev-browser

Extraia:

  • Portões universais: Comandos que se aplicam a TODAS as histórias (ex.: pnpm typecheck)
  • Portões de UI: Comandos que se aplicam apenas a histórias de UI (ex.: verificação no navegador)

Se não existir seção de Portões de Qualidade: Pergunte ao usuário quais comandos devem passar, ou use um padrão sensato como npm run typecheck.


Formato de Saída

Os beads usam o comando br create com sintaxe HEREDOC para lidar com segurança com caracteres especiais:

# Criar épica (link de volta para o PRD fonte)
br create --type=epic \
  --title="[Nome da Funcionalidade]" \
  --description="$(cat <<'EOF'
[Descrição da funcionalidade do PRD]
EOF
)" \
  --external-ref="prd:./tasks/feature-name-prd.md"

# Criar bead filho (com portões de qualidade nos critérios de aceitação)
br create \
  --parent=EPIC_ID \
  --title="[Título da História]" \
  --description="$(cat <<'EOF'
[Descrição da história com critérios de aceitação INCLUINDO portões de qualidade]
EOF
)" \
  --priority=[1-4]

CRÍTICO: Sempre use <<'EOF' (com aspas simples) para o delimitador HEREDOC. Isso evita a interpretação pelo shell de acentos graves, $variáveis e () nas descrições.


Tamanho da História: A Regra #1

Cada história deve ser completável em UMA iteração do ralph-tui (~uma janela de contexto do agente).

O ralph-tui cria uma nova instância de agente por iteração, sem memória do trabalho anterior. Se uma história for muito grande, o agente fica sem contexto antes de terminar.

Histórias de tamanho adequado:

  • Adicionar uma coluna no banco de dados + migração
  • Adicionar um componente de UI a uma página existente
  • Atualizar uma server action com nova lógica
  • Adicionar um dropdown de filtro a uma lista

Muito grande (divida estas):

  • "Construir o dashboard inteiro" → Dividir em: esquema, consultas, componentes de UI, filtros
  • "Adicionar autenticação" → Dividir em: esquema, middleware, UI de login, gerenciamento de sessão
  • "Refatorar a API" → Dividir em uma história por endpoint ou padrão

Regra prática: Se você não consegue descrever a mudança em 2-3 frases, é grande demais.


Ordem das Histórias: Dependências Primeiro

As histórias executam na ordem das dependências. Histórias anteriores não devem depender de histórias posteriores.

Ordem correta:

  1. Mudanças de esquema/banco de dados (migrações)
  2. Server actions / lógica de backend
  3. Componentes de UI que usam o backend
  4. Views de dashboard/resumo que agregam dados

Ordem errada:

  1. ❌ Componente de UI (depende de esquema que ainda não existe)
  2. ❌ Mudança de esquema

Dependências com br dep add

Use o comando br dep add para especificar quais beads devem ser concluídos primeiro:

# Crie os beads primeiro
br create --parent=epic-123 --title="US-001: Adicionar esquema" ...
br create --parent=epic-123 --title="US-002: Criar API" ...
br create --parent=epic-123 --title="US-003: Construir UI" ...

# Em seguida, adicione dependências (issue depende-do blocker)
br dep add ralph-tui-002 ralph-tui-001  # US-002 depende de US-001
br dep add ralph-tui-003 ralph-tui-002  # US-003 depende de US-002

Sintaxe: br dep add <issue> <depende-de> — o issue depende de (é bloqueado por) depende-de.

O ralph-tui irá:

  • Mostrar beads bloqueados como "bloqueados" até que as dependências sejam concluídas
  • Nunca selecionar um bead para execução enquanto suas dependências estiverem abertas
  • Incluir contexto de dependência no prompt ao trabalhar em um bead

Ordem correta de dependências:

  1. Mudanças de esquema/banco de dados (sem dependências)
  2. Lógica de backend (depende do esquema)
  3. Componentes de UI (dependem do backend)
  4. Integração/polimento (depende da UI)

Critérios de Aceitação: Portões de Qualidade + Específicos da História

A descrição de cada bead deve incluir critérios de aceitação com:

  1. Critérios específicos da história do PRD (o que esta história realiza)
  2. Portões de qualidade da seção de Portões de Qualidade do PRD (anexados ao final)

Bons critérios (verificáveis):

  • "Adicionar coluna investorType à tabela investor com padrão 'cold'"
  • "O dropdown de filtro tem opções: Todos, Frio, Amigo"
  • "Clicar no alternador mostra diálogo de confirmação"

Maus critérios (vagos):

  • ❌ "Funciona corretamente"
  • ❌ "O usuário pode fazer X facilmente"
  • ❌ "Boa UX"
  • ❌ "Lida com casos de borda"

Regras de Conversão

  1. Extraia os Portões de Qualidade do PRD primeiro
  2. Cada história de usuário → um bead
  3. Primeira história: Sem dependências (cria a fundação)
  4. Histórias subsequentes: Dependem das predecessoras (UI depende do backend, etc.)
  5. Prioridade: Baseada na ordem de dependência, depois na ordem do documento (0=crítico, 2=médio, 4=backlog)
  6. Todas as histórias: status: "open"
  7. Critérios de aceitação: Critérios da história + portões de qualidade anexados
  8. Histórias de UI: Anexar também portões específicos de UI (verificação no navegador)

Dividindo PRDs Grandes

Se um PRD tiver funcionalidades grandes, divida-as:

Original:

"Adicionar trilha de divulgação para amigos com diferentes mensagens"

Dividido em:

  1. US-001: Adicionar campo investorType ao banco de dados
  2. US-002: Adicionar alternador de tipo à UI da lista de investidores
  3. US-003: Criar lógica de progressão de fase específica para amigos
  4. US-004: Criar modelos de mensagem para amigos
  5. US-005: Integrar geração de tarefas para amigos
  6. US-006: Adicionar filtro por tipo
  7. US-007: Atualizar formulário de novo investidor
  8. US-008: Atualizar contagens do dashboard

Cada uma é uma mudança focada que pode ser completada e verificada independentemente.


Exemplo

PRD de entrada:

# PRD: Divulgação para Amigos

Adicionar capacidade de marcar investidores como "amigos" para divulgação calorosa.

## Portões de Qualidade

Estes comandos devem passar para toda história de usuário:
- `pnpm typecheck` - Verificação de tipos
- `pnpm lint` - Linting

Para histórias de UI, inclua também:
- Verifique no navegador usando o skill dev-browser

## Histórias de Usuário

### US-001: Adicionar campo investorType à tabela investor
**Descrição:** Como desenvolvedor, preciso categorizar investidores como 'frio' ou 'amigo'.

**Critérios de Aceitação:**
- [ ] Adicionar coluna investorType: 'cold' | 'friend' (padrão 'cold')
- [ ] Gerar e executar migração com sucesso

### US-002: Adicionar alternador de tipo às linhas da lista de investidores
**Descrição:** Como Ryan, quero alternar o tipo do investidor diretamente da lista.

**Critérios de Aceitação:**
- [ ] Cada linha tem alternador Frio | Amigo
- [ ] Alternar mostra diálogo de confirmação
- [ ] Ao confirmar: atualiza tipo no banco de dados

### US-003: Filtrar investidores por tipo
**Descrição:** Como Ryan, quero filtrar a lista para ver apenas amigos ou frios.

**Critérios de Aceitação:**
- [ ] Dropdown de filtro: Todos | Frio | Amigo
- [ ] Filtro persiste nos parâmetros de URL

Beads de saída:

# Criar épica (link de volta para o PRD fonte)
br create --type=epic \
  --title="Trilha de Divulgação para Amigos" \
  --description="$(cat <<'EOF'
Divulgação calorosa para feedback de deck
EOF
)" \
  --external-ref="prd:./tasks/friends-outreach-prd.md"

# US-001: Sem deps (primeiro - cria esquema)
br create --parent=ralph-tui-abc \
  --title="US-001: Adicionar campo investorType à tabela investor" \
  --description="$(cat <<'EOF'
Como desenvolvedor, preciso categorizar investidores como 'frio' ou 'amigo'.

## Critérios de Aceitação
- [ ] Adicionar coluna investorType: 'cold' | 'friend' (padrão 'cold')
- [ ] Gerar e executar migração com sucesso
- [ ] pnpm typecheck passa
- [ ] pnpm lint passa
EOF
)" \
  --priority=1

# US-002: História de UI (também recebe verificação no navegador)
br create --parent=ralph-tui-abc \
  --title="US-002: Adicionar alternador de tipo às linhas da lista de investidores" \
  --description="$(cat <<'EOF'
Como Ryan, quero alternar o tipo do investidor diretamente da lista.

## Critérios de Aceitação
- [ ] Cada linha tem alternador Frio | Amigo
- [ ] Alternar mostra diálogo de confirmação
- [ ] Ao confirmar: atualiza tipo no banco de dados
- [ ] pnpm typecheck passa
- [ ] pnpm lint passa
- [ ] Verifique no navegador usando o skill dev-browser
EOF
)" \
  --priority=2

# Adicionar dependência: US-002 depende de US-001
br dep add ralph-tui-002 ralph-tui-001

# US-003: História de UI
br create --parent=ralph-tui-abc \
  --title="US-003: Filtrar investidores por tipo" \
  --description="$(cat <<'EOF'
Como Ryan, quero filtrar a lista para ver apenas amigos ou frios.

## Critérios de Aceitação
- [ ] Dropdown de filtro: Todos | Frio | Amigo
- [ ] Filtro persiste nos parâmetros de URL
- [ ] pnpm typecheck passa
- [ ] pnpm lint passa
- [ ] Verifique no navegador usando o skill dev-browser
EOF
)" \
  --priority=3

# Adicionar dependência: US-003 depende de US-002
br dep add ralph-tui-003 ralph-tui-002

Sincronizando Mudanças

Após criar beads, sincronize para exportar para JSONL (para rastreamento git):

br sync --flush-only

Isso exporta o banco de dados SQLite para .beads/issues.jsonl para controle de versão.


Localização da Saída

Os beads são armazenados no diretório: .beads/ (banco de dados SQLite + exportação JSONL)

Após a criação, execute o ralph-tui:

# Trabalhar em uma épica específica
ralph-tui run --tracker beads-rust --epic ralph-tui-abc

# Ou deixe ele escolher a melhor tarefa automaticamente
ralph-tui run --tracker beads-rust

O ralph-tui irá:

  1. Trabalhar nos beads dentro da épica especificada (ou selecionar a melhor tarefa disponível)
  2. Fechar cada bead quando completo
  3. Fechar a épica quando todos os filhos estiverem prontos
  4. Gerar <promise>COMPLETE</promise> quando a épica estiver concluída

Lista de Verificação Antes de Criar Beads

  • Extraídos os Portões de Qualidade do PRD (ou perguntado ao usuário se ausentes)
  • Cada história é completável em uma iteração (pequena o suficiente)
  • Histórias ordenadas por dependência (esquema → backend → UI)
  • Portões de qualidade anexados aos critérios de aceitação de cada bead
  • Histórias de UI têm verificação no navegador (se especificado nos Portões de Qualidade)
  • Critérios de aceitação são verificáveis (não vagos)
  • Nenhuma história depende de uma história posterior (apenas de anteriores)
  • Dependências adicionadas com br dep add após criar os beads
  • Executado br sync --flush-only para exportar para rastreamento git

Diferenças do beads (versão Go)

Comandobeads (bd)beads-rust (br)
Criarbd createbr create
Dependênciasbd dep addbr dep add
Sincronizarbd syncbr sync --flush-only
Fecharbd closebr close
Armazenamento.beads/beads.jsonl.beads/*.db + exportação JSONL

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas