Communitygithub.com

ComeOnOliver/skillshub

Gera um Documento de Requisitos de Produto (PRD) para orquestração de tarefas ralph-tui. Cria PRDs com histórias de usuário que podem ser convertidas em issues beads ou prd.json para execução automatizada. Dispara em: criar um prd, escrever prd para, planejar este recurso, requisitos para, especificar.

O que é skillshub?

Este skill é projetado para gerar Documentos de Requisitos de Produto (PRDs) otimizados para execução por agentes de IA através da ferramenta ralph-tui. O principal problema que resolve é a estruturação e decomposição de descrições de features em histórias de usuário pequenas e verificáveis, prontas para conversão em artefatos executáveis como beads issues ou o arquivo prd.json. Ele suporta plataformas que utilizam ralph-tui para orquestração de tarefas com agentes de IA. O skill funciona por meio de um processo iterativo de perguntas esclarecedoras, onde o agente faz de 3 a 5 perguntas iniciais (com opções de letras), adapta-se com base nas respostas e sempre pergunta sobre os "quality gates" (comandos de verificação) para garantir a qualidade. Após coletar contexto suficiente, gera um PRD completo com seções como Quality Gates, Histórias de Usuário e Requisitos Funcionais, encapsulando o resultado em marcadores `[PRD]...[/PRD]` para parsing pela TUI. É útil para equipes que querem acelerar o planejamento de features, garantindo que os requisitos sejam claros, testáveis e prontos para automação.

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

Perguntar na sua IA favorita

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

Documentação

Gerador de PRD para Ralph TUI

Crie Documentos de Requisitos de Produto detalhados e otimizados para execução por agentes de IA via ralph-tui.


O Trabalho

  1. Receber uma descrição de funcionalidade do usuário
  2. Fazer de 3 a 5 perguntas esclarecedoras essenciais (com opções de letras) - um conjunto de cada vez
  3. Sempre perguntar sobre os portões de qualidade (quais comandos devem passar)
  4. Após cada resposta, fazer perguntas de acompanhamento, se necessário (exploração adaptativa)
  5. Gerar um PRD estruturado quando tiver contexto suficiente
  6. Gerar o PRD encapsulado nos marcadores [PRD]...[/PRD] para análise pela TUI

Importante: Não comece a implementar. Apenas crie o PRD.


Etapa 1: Perguntas Esclarecedoras (Iterativo)

Faça perguntas um conjunto de cada vez. Cada resposta deve orientar suas próximas perguntas. Concentre-se em:

  • Problema/Objetivo: Que problema isso resolve?
  • Funcionalidade Principal: Quais são as ações principais?
  • Escopo/Limites: O que NÃO deve fazer?
  • Critérios de Sucesso: Como saberemos que está pronto?
  • Integração: Como isso se encaixa com as funcionalidades existentes?
  • Portões de Qualidade: Quais comandos devem passar para cada história? (OBRIGATÓRIO)

Formate as Perguntas Assim:

1. Qual é o objetivo principal desta funcionalidade?
   A. Melhorar a experiência de integração do usuário
   B. Aumentar a retenção de usuários
   C. Reduzir a carga de suporte
   D. Outro: [especifique]

2. Quem é o usuário alvo?
   A. Apenas novos usuários
   B. Apenas usuários existentes
   C. Todos os usuários
   D. Apenas usuários administradores

Isso permite que os usuários respondam com "1A, 2C" para iteração rápida.

Pergunta sobre Portões de Qualidade (OBRIGATÓRIA)

Sempre pergunte sobre os portões de qualidade - eles são específicos do projeto:

Quais comandos de qualidade devem passar para cada história de usuário?
   A. pnpm typecheck && pnpm lint
   B. npm run typecheck && npm run lint
   C. bun run typecheck && bun run lint
   D. Outro: [especifique seus comandos]

Para histórias de UI, devemos incluir verificação no navegador?
   A. Sim, use a habilidade dev-browser para verificar visualmente
   B. Não, os testes automatizados são suficientes

Questionamento Adaptativo

Após cada resposta, decida se:

  • Fazer perguntas de acompanhamento (se as respostas revelarem complexidade)
  • Perguntar sobre um novo aspecto (se a área atual estiver clara)
  • Gerar o PRD (se tiver contexto suficiente)

Normalmente, são necessárias de 2 a 4 rodadas de perguntas.


Etapa 2: Estrutura do PRD

Gere o PRD com estas seções:

1. Introdução/Visão Geral

Breve descrição da funcionalidade e do problema que ela resolve.

2. Objetivos

Objetivos específicos e mensuráveis (lista com marcadores).

3. Portões de Qualidade

CRÍTICO: Liste os comandos que devem passar para cada história de usuário.

## Portões de Qualidade

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

Para histórias de UI, inclua também:
- Verificar no navegador usando a habilidade dev-browser

Esta seção é extraída pelas ferramentas de conversão (ralph-tui-create-json, ralph-tui-create-beads) e anexada aos critérios de aceitação de cada história.

4. Histórias de Usuário

Cada história precisa de:

  • Título: Nome descritivo curto
  • Descrição: "Como um [usuário], quero [funcionalidade] para que [benefício]"
  • Critérios de Aceitação: Lista de verificação do que significa "pronto"

Cada história deve ser pequena o suficiente para ser implementada em uma sessão focada de agente de IA.

Formato:

### US-001: [Título]
**Descrição:** Como um [usuário], quero [funcionalidade] para que [benefício].

**Critérios de Aceitação:**
- [ ] Critério verificável específico
- [ ] Outro critério

Nota: NÃO inclua comandos de portão de qualidade nos critérios de histórias individuais - eles são definidos uma vez na seção Portões de Qualidade e aplicados automaticamente durante a conversão.

Importante:

  • Os critérios de aceitação devem ser verificáveis, não vagos
  • "Funciona corretamente" é ruim
  • "O botão mostra uma caixa de diálogo de confirmação antes de excluir" é bom
  • Cada história deve ser concluível de forma independente

5. Requisitos Funcionais

Lista numerada de funcionalidades específicas:

  • "FR-1: O sistema deve permitir que os usuários..."
  • "FR-2: Quando um usuário clicar em X, o sistema deve..."

Seja explícito e inequívoco.

6. Não-Objetivos (Fora do Escopo)

O que esta funcionalidade NÃO incluirá. Crítico para gerenciar o escopo.

7. Considerações Técnicas (Opcional)

  • Restrições ou dependências conhecidas
  • Pontos de integração com sistemas existentes
  • Requisitos de desempenho

8. Métricas de Sucesso

Como o sucesso será medido?

9. Perguntas em Aberto

Perguntas remanescentes ou áreas que precisam de esclarecimento.


Escrevendo para Agentes de IA

O PRD será executado por agentes de IA de codificação via ralph-tui. Portanto:

  • Seja explícito e inequívoco
  • As histórias de usuário devem ser pequenas (concluíveis em uma sessão)
  • Os critérios de aceitação devem ser, sempre que possível, verificáveis por máquina
  • Inclua caminhos de arquivo específicos, se você os conhecer
  • Faça referência a padrões de código existentes no projeto

Formato de Saída

CRÍTICO: Encapsule o PRD final nos marcadores para análise pela TUI:

[PRD]
# PRD: Nome da Funcionalidade

## Visão Geral
...

## Portões de Qualidade
...

## Histórias de Usuário
...
[/PRD]

Nomeação de arquivo: A TUI salvará em ./tasks/prd-[nome-da-funcionalidade].md


Exemplo de Fluxo de Conversa

Usuário: Crie um PRD para adicionar modo escuro à TUI

Assistente: Vou ajudá-lo a criar um PRD para o modo escuro. Deixe-me fazer algumas perguntas:

  1. Qual é o objetivo principal? A. Reduzir o cansaço visual em sessões longas B. Corresponder à preferência de tema do sistema C. Fornecer personalização visual D. Outro

  2. A configuração deve persistir? A. Sim, salvar no arquivo de configuração B. Não, apenas na sessão C. Seguir a preferência do sistema

Usuário: 1A, 2A

Assistente: Ótimo! Mais algumas perguntas:

  1. Quais componentes precisam de suporte ao modo escuro? A. Todos os componentes da TUI B. Apenas a visualização principal de execução C. Visualização principal + configurações D. Outro

  2. Quais comandos de qualidade devem passar para cada história? A. pnpm typecheck && pnpm lint B. npm run typecheck && npm run lint C. bun run typecheck D. Outro: [especifique]

  3. Para histórias de UI, incluir verificação no navegador? A. Sim, use a habilidade dev-browser B. Não, testes automatizados são suficientes

Usuário: 3A, 4A, 5A

Assistente: Perfeito, tenho informações suficientes para gerar o PRD.

[PRD]

PRD: Modo Escuro para Ralph TUI

Visão Geral

Adicionar suporte a modo escuro ao ralph-tui para reduzir o cansaço visual durante sessões longas de orquestração. A funcionalidade será aplicada a todos os componentes da TUI e persistirá a preferência do usuário no arquivo de configuração.

Objetivos

  • Fornecer uma experiência de visualização confortável em ambientes com pouca luz
  • Persistir a preferência de tema entre sessões
  • Aplicar estilo consistente a todos os componentes da TUI

Portões de Qualidade

Estes comandos devem passar para cada história de usuário:

  • pnpm typecheck - Verificação de tipos
  • pnpm lint - Linting

Para histórias de UI, inclua também:

  • Verificar no navegador usando a habilidade dev-browser

Histórias de Usuário

US-001: Adicionar configuração de tema

Descrição: Como um usuário, quero definir meu tema preferido (claro/escuro) para que ele persista entre as sessões.

Critérios de Aceitação:

  • Adicionar campo theme ao esquema de .ralph-tui.yaml
  • Suportar valores: "light", "dark", "system"
  • Padrão para "light" para compatibilidade reversa

US-002: Criar paleta de cores do tema escuro

Descrição: Como um usuário, quero um tema escuro de contraste suave que seja agradável aos olhos.

Critérios de Aceitação:

  • Definir paleta escura com tons de cinza (não preto puro)
  • Garantir taxas de contraste suficientes (WCAG AA)
  • Cores funcionam bem para todos os estados da UI (selecionado, hover, desabilitado)

US-003: Aplicar tema aos componentes da TUI

Descrição: Como um usuário, quero que todos os componentes da TUI respeitem minha preferência de tema.

Critérios de Aceitação:

  • Componente de cabeçalho usa cores do tema
  • Lista de tarefas usa cores do tema
  • Painéis de detalhes usam cores do tema
  • Barra de progresso usa cores do tema
  • Diálogos usam cores do tema

US-004: Adicionar alternância de tema nas configurações

Descrição: Como um usuário, quero alternar temas a partir das configurações da TUI.

Critérios de Aceitação:

  • Opção de tema visível na visualização de configurações
  • Alterações aplicam-se imediatamente sem reinicialização
  • Alterações persistem no arquivo de configuração

Requisitos Funcionais

  • FR-1: A configuração de tema deve ser legível a partir de .ralph-tui.yaml
  • FR-2: O tema deve ser aplicado na inicialização da TUI
  • FR-3: As alterações de tema nas configurações devem ser aplicadas imediatamente
  • FR-4: Todo o texto deve manter a legibilidade em ambos os temas

Não-Objetivos

  • Detecção automática do tema do sistema (melhoria futura)
  • Esquemas de cores personalizados além de claro/escuro
  • Substituições de tema por componente

Considerações Técnicas

  • Usar capacidades de theming do OpenTUI existentes, se disponíveis
  • Considerar criar um ThemeContext para componentes React
  • Minimizar re-renderizações quando o tema for alterado

Métricas de Sucesso

  • Todos os componentes renderizam corretamente no modo escuro
  • Nenhum problema de contraste de acessibilidade
  • O tema persiste entre sessões

Perguntas em Aberto

  • Devemos detectar automaticamente a preferência de tema do sistema na v2? [/PRD]

Lista de Verificação

Antes de gerar o PRD:

  • Fez perguntas esclarecedoras com opções de letras
  • Perguntou sobre os portões de qualidade (OBRIGATÓRIO)
  • Fez perguntas de acompanhamento quando necessário
  • Seção Portões de Qualidade incluída com comandos específicos do projeto
  • Histórias de usuário são pequenas e concluíveis de forma independente
  • Histórias de usuário NÃO incluem comandos de portão de qualidade (eles estão na seção Portões de Qualidade)
  • Requisitos funcionais são numerados e inequívocos
  • Seção de Não-Objetivos define limites claros
  • PRD está encapsulado nos marcadores [PRD]...[/PRD]

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