Communitygithub.com

ComeOnOliver/skillshub

Converte PRDs para o formato prd.json para execução com ralph-tui. Cria arquivos JSON de tarefas com histórias de usuário, critérios de aceitação e dependências. Acionado por: criar prd.json, converter para json, ralph json, criar tarefas json.

O que é skillshub?

Esta skill converte Documentos de Requisitos de Produto (PRDs) em arquivos prd.json estruturados, prontos para execução autônoma pelo ralph-tui. Ela extrai as histórias de usuário e os 'Gates de Qualidade' (Quality Gates) do PRD, como comandos de lint e typecheck, e os anexa aos critérios de aceitação de cada história. É fundamental que a saída seja um objeto JSON plano com os campos "name" e "userStories" no nível raiz, evitando antípadas comuns como objetos wrappers ou uso do array "tasks". A skill também configura dependências entre histórias via o campo "dependsOn", garantindo que histórias maiores (ex.: construir um dashboard inteiro) sejam quebradas em partes menores e executáveis em uma única iteração do agente. Suportada por ralph-tui, ela opera via comandos como "criar prd.json", "converter para json", "ralph json" ou "criar tarefas json", e o arquivo gerado é tipicamente salvo em ./tasks/prd.json.

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

Perguntar na sua IA favorita

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

Documentação

Ralph TUI - Criar Tarefas JSON

Converte PRDs para o formato prd.json para execução autônoma com ralph-tui.

Nota: Esta skill está incluída com o plugin de rastreador JSON do ralph-tui. Plugins de rastreador futuros (Linear, GitHub Issues, etc.) incluirão suas próprias skills de criação de tarefas.

⚠️ CRÍTICO: A saída DEVE ser um objeto JSON PLANO com "name" e "userStories" no nível RAÍZ. NÃO envolva o conteúdo em um objeto "prd" ou use um array "tasks". Veja a seção "Antipadrões de Esquema" abaixo.


A Tarefa

Pegue um PRD (arquivo markdown ou texto) e crie um arquivo prd.json:

  1. Extrair Gates de Qualidade da seção "Quality Gates" do PRD
  2. Analisar histórias de usuário do PRD
  3. Anexar gates de qualidade aos critérios de aceitação de cada história
  4. Configurar dependências entre histórias
  5. Saída pronta para ralph-tui run --prd <caminho>

Passo 1: Extrair Gates de Qualidade

Procure pela seção "Quality Gates" no PRD:

## Quality Gates

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

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

Extraia:

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

Se não houver seção de Quality Gates: Pergunte ao usuário quais comandos devem passar, ou use um padrão sensato como npm run typecheck.


Formato de Saída

O arquivo JSON DEVE ser um objeto PLANO no nível raiz:

{
  "name": "[Nome do projeto do PRD ou diretório]",
  "branchName": "ralph/[nome-da-funcionalidade-em-kebab-case]",
  "description": "[Descrição da funcionalidade do PRD]",
  "userStories": [
    {
      "id": "US-001",
      "title": "[Título da história]",
      "description": "Como um [usuário], quero [funcionalidade] para que [benefício]",
      "acceptanceCriteria": [
        "Critério 1 do PRD",
        "Critério 2 do PRD",
        "pnpm typecheck passa",
        "pnpm lint passa"
      ],
      "priority": 1,
      "passes": false,
      "notes": "",
      "dependsOn": []
    },
    {
      "id": "US-002",
      "title": "[História de UI que depende de US-001]",
      "description": "...",
      "acceptanceCriteria": [
        "...",
        "pnpm typecheck passa",
        "pnpm lint passa",
        "Verificar no navegador usando a skill dev-browser"
      ],
      "priority": 2,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-001"]
    }
  ]
}

CRÍTICO: Antipadrões de Esquema (NÃO USE)

Os seguintes padrões são INVÁLIDOS e causarão erros de validação:

❌ ERRADO: Objeto wrapper

{
  "prd": {
    "name": "...",
    "userStories": [...]
  }
}

Isso envolve tudo em um objeto "prd". NÃO FAÇA ISSO. Os campos "name" e "userStories" devem estar no nível RAÍZ.

❌ ERRADO: Usar "tasks" em vez de "userStories"

{
  "name": "...",
  "tasks": [...]
}

O array é chamado de "userStories", não "tasks".

❌ ERRADO: Estruturas aninhadas complexas

{
  "metadata": {...},
  "overview": {...},
  "migration_strategy": {
    "phases": [...]
  }
}

Mesmo que o PRD descreva fases/marcos/sprints, você DEVE achatá-los em um único array "userStories".

❌ ERRADO: Usar "status" em vez de "passes"

{
  "userStories": [{
    "id": "US-001",
    "status": "open"  // ERRADO!
  }]
}

Use "passes": false para histórias incompletas, "passes": true para completas.

✅ CORRETO: Estrutura plana na raiz

{
  "name": "Migração Kotlin para Android",
  "branchName": "ralph/migracao-kotlin",
  "userStories": [
    {"id": "US-001", "title": "Criar interface Scraper", "passes": false, "dependsOn": []},
    {"id": "US-002", "title": "Implementar WeebCentralScraper", "passes": false, "dependsOn": ["US-001"]}
  ]
}

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 gera 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 do tamanho certo:

  • 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 grandes (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, é muito grande.


Dependências com dependsOn

Use o array dependsOn para especificar quais histórias devem ser concluídas primeiro:

{
  "id": "US-002",
  "title": "Criar endpoints da API",
  "dependsOn": ["US-001"],  // Não será selecionado até US-001 passar
  ...
}

O ralph-tui irá:

  • Mostrar US-002 como "bloqueado" até US-001 ser concluída
  • Nunca selecionar US-002 para execução enquanto US-001 estiver aberta
  • Incluir "Pré-requisitos: US-001" no prompt ao trabalhar em US-002

Ordem de dependência correta:

  1. Mudanças no 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: Gates de Qualidade + Específicos da História

Os critérios de aceitação de cada história devem incluir:

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

Bons critérios (verificáveis):

  • "Adicionar coluna status à tabela de tarefas com padrão 'open'"
  • "Dropdown de filtro tem opções: Todas, Abertas, Fechadas"
  • "Clicar em excluir mostra diálogo de confirmação"

Maus critérios (vagos):

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

Regras de Conversão

  1. Extrair Gates de Qualidade do PRD primeiro
  2. Cada história de usuário → uma entrada JSON
  3. IDs: Sequenciais (US-001, US-002, etc.)
  4. Prioridade: Baseada na ordem de dependência (1 = maior)
  5. dependsOn: Array de IDs de história que esta história requer
  6. Todas as histórias: passes: false e notes vazios
  7. branchName: Derivado do nome da funcionalidade, em kebab-case, prefixado com ralph/
  8. Critérios de aceitação: Critérios da história + gates de qualidade anexados
  9. Histórias de UI: Anexar também gates específicos de UI (verificação no navegador)

Localização da Saída

Padrão: ./tasks/prd.json (junto com os arquivos markdown do PRD)

Isso mantém todos os arquivos relacionados ao PRD juntos no diretório tasks/.

Ou especifique um caminho diferente - o ralph-tui o usará com:

ralph-tui run --prd ./caminho/para/prd.json

Exemplo

PRD de Entrada:

# PRD: Sistema de Prioridade de Tarefas

Adicionar níveis de prioridade às tarefas.

## Quality Gates

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

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

## User Stories

### US-001: Adicionar campo de prioridade ao banco de dados
**Descrição:** Como desenvolvedor, preciso armazenar prioridade de tarefas.

**Critérios de Aceitação:**
- [ ] Adicionar coluna de prioridade: 1-4 (padrão 2)
- [ ] Migração executada com sucesso

### US-002: Exibir badge de prioridade nos cartões de tarefa
**Descrição:** Como usuário, quero ver a prioridade da tarefa rapidamente.

**Critérios de Aceitação:**
- [ ] Badge mostra P1/P2/P3/P4 com cores
- [ ] Badge visível sem passar o mouse

### US-003: Adicionar dropdown de filtro por prioridade
**Descrição:** Como usuário, quero filtrar tarefas por prioridade.

**Critérios de Aceitação:**
- [ ] Dropdown de filtro: Todas, P1, P2, P3, P4
- [ ] Filtro persiste na URL

prd.json de Saída:

{
  "project": "my-app",
  "branchName": "ralph/prioridade-tarefas",
  "description": "Adicionar níveis de prioridade às tarefas",
  "userStories": [
    {
      "id": "US-001",
      "title": "Adicionar campo de prioridade ao banco de dados",
      "description": "Como desenvolvedor, preciso armazenar prioridade de tarefas.",
      "acceptanceCriteria": [
        "Adicionar coluna de prioridade: 1-4 (padrão 2)",
        "Migração executada com sucesso",
        "pnpm typecheck passa",
        "pnpm lint passa"
      ],
      "priority": 1,
      "passes": false,
      "notes": "",
      "dependsOn": []
    },
    {
      "id": "US-002",
      "title": "Exibir badge de prioridade nos cartões de tarefa",
      "description": "Como usuário, quero ver a prioridade da tarefa rapidamente.",
      "acceptanceCriteria": [
        "Badge mostra P1/P2/P3/P4 com cores",
        "Badge visível sem passar o mouse",
        "pnpm typecheck passa",
        "pnpm lint passa",
        "Verificar no navegador usando a skill dev-browser"
      ],
      "priority": 2,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-001"]
    },
    {
      "id": "US-003",
      "title": "Adicionar dropdown de filtro por prioridade",
      "description": "Como usuário, quero filtrar tarefas por prioridade.",
      "acceptanceCriteria": [
        "Dropdown de filtro: Todas, P1, P2, P3, P4",
        "Filtro persiste na URL",
        "pnpm typecheck passa",
        "pnpm lint passa",
        "Verificar no navegador usando a skill dev-browser"
      ],
      "priority": 3,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-002"]
    }
  ]
}

Executando com ralph-tui

Após criar o prd.json:

ralph-tui run --prd ./tasks/prd.json

O ralph-tui irá:

  1. Carregar as histórias do prd.json
  2. Selecionar a história de maior prioridade com passes: false e sem dependências bloqueantes
  3. Gerar um prompt com detalhes da história + critérios de aceitação
  4. Executar o agente para implementar a história
  5. Marcar passes: true ao concluir
  6. Repetir até que todas as histórias passem

Lista de Verificação Antes de Salvar

  • Gates de Qualidade extraídos do PRD (ou perguntou ao usuário se estiverem faltando)
  • Cada história completável em uma iteração
  • Histórias ordenadas por dependência (esquema → backend → UI)
  • dependsOn configurado corretamente para cada história
  • Gates de qualidade anexados aos critérios de aceitação de cada história
  • Histórias de UI têm verificação no navegador (se especificado nos Quality Gates)
  • Critérios de aceitação são verificáveis (não vagos)
  • Nenhuma dependência circular

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