Communitygithub.com

ComeOnOliver/skillshub

Convierte PRDs a formato prd.json para ejecución con ralph-tui. Crea archivos JSON de tareas con historias de usuario, criterios de aceptación y dependencias.

¿Qué es skillshub?

Este skill convierte Documentos de Requisitos de Producto (PRD) en archivos `prd.json` estructurados, diseñados para la ejecución autónoma con la herramienta `ralph-tui`. Es parte del ecosistema de ralph-tui y se integra con su plugin de seguimiento JSON, aunque otros plugins (Linear, GitHub Issues, etc.) incluirán sus propios skills de creación de tareas. La función principal del skill es extraer de un PRD (archivo markdown o texto) las puertas de calidad, las historias de usuario y sus criterios de aceptación, y luego generar un archivo JSON plano que siga un esquema estricto. Es fundamental que la estructura JSON sea plana a nivel raíz, con campos `name` y `userStories`, y que no se usen objetos contenedores como `prd` o arreglos llamados `tasks`. El skill también se encarga de asignar dependencias entre historias usando el campo `dependsOn`, establecer prioridades basadas en el orden de implementación (por ejemplo, esquema → backend → UI) y asegurar que cada historia sea lo suficientemente pequeña para completarse en una sola iteración del agente. Las historias de usuario que involucran interfaz de usuario (UI) reciben puertas de calidad adicionales, como la verificación en navegador. El resultado es un archivo `prd.json` listo para ser ejecutado con `ralph-tui run --prd <ruta>`.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Ralph TUI - Crear Tareas JSON

Convierte PRDs al formato prd.json para la ejecución autónoma con ralph-tui.

Nota: Este skill está incluido con el plugin de seguimiento JSON de ralph-tui. Los futuros plugins de seguimiento (Linear, GitHub Issues, etc.) incluirán sus propios skills de creación de tareas.

⚠️ CRÍTICO: La salida DEBE ser un objeto JSON PLANO con "name" y "userStories" al NIVEL RAÍZ. NO envuelvas el contenido en un objeto "prd" ni uses un arreglo "tasks". Consulta la sección "Antipatrones de Esquema" más abajo.


El Trabajo

Toma un PRD (archivo markdown o texto) y crea un archivo prd.json:

  1. Extraer las Puertas de Calidad de la sección "Puertas de Calidad" del PRD
  2. Analizar las historias de usuario del PRD
  3. Añadir las puertas de calidad a los criterios de aceptación de cada historia
  4. Configurar dependencias entre historias
  5. Generar la salida lista para ralph-tui run --prd <ruta>

Paso 1: Extraer Puertas de Calidad

Busca la sección "Puertas de Calidad" en el PRD:

## Puertas de Calidad

Estos comandos deben pasar para cada historia de usuario:
- `pnpm typecheck` - Verificación de tipos
- `pnpm lint` - Análisis de código

Para historias de UI, incluye también:
- Verificar en el navegador usando el skill dev-browser

Extrae:

  • Puertas universales: Comandos que se aplican a TODAS las historias (p. ej., pnpm typecheck)
  • Puertas de UI: Comandos que se aplican solo a las historias de UI (p. ej., verificación en navegador)

Si no existe la sección "Puertas de Calidad": Pregunta al usuario qué comandos deben pasar, o usa un valor predeterminado sensato como npm run typecheck.


Formato de Salida

El archivo JSON DEBE ser un objeto PLANO a nivel raíz:

{
  "name": "[Nombre del proyecto del PRD o del directorio]",
  "branchName": "ralph/[nombre-de-funcionalidad-en-kebab-case]",
  "description": "[Descripción de la funcionalidad del PRD]",
  "userStories": [
    {
      "id": "US-001",
      "title": "[Título de la historia]",
      "description": "Como [usuario], quiero [funcionalidad] para [beneficio]",
      "acceptanceCriteria": [
        "Criterio 1 del PRD",
        "Criterio 2 del PRD",
        "pnpm typecheck pasa",
        "pnpm lint pasa"
      ],
      "priority": 1,
      "passes": false,
      "notes": "",
      "dependsOn": []
    },
    {
      "id": "US-002",
      "title": "[Historia de UI que depende de US-001]",
      "description": "...",
      "acceptanceCriteria": [
        "...",
        "pnpm typecheck pasa",
        "pnpm lint pasa",
        "Verificar en el navegador usando el skill dev-browser"
      ],
      "priority": 2,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-001"]
    }
  ]
}

CRÍTICO: Antipatrones de Esquema (NO USAR)

Los siguientes patrones son INVÁLIDOS y causarán errores de validación:

❌ INCORRECTO: Objeto contenedor

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

Esto envuelve todo en un objeto "prd". NO HAGAS ESTO. Los campos "name" y "userStories" deben estar al NIVEL RAÍZ.

❌ INCORRECTO: Usar "tasks" en lugar de "userStories"

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

El arreglo se llama "userStories", no "tasks".

❌ INCORRECTO: Estructuras anidadas complejas

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

Incluso si el PRD describe fases/hitos/sprints, DEBES aplanarlos en un solo arreglo "userStories".

❌ INCORRECTO: Usar "status" en lugar de "passes"

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

Usa "passes": false para historias incompletas, "passes": true para completadas.

✅ CORRECTO: Estructura plana a nivel raíz

{
  "name": "Migración a Kotlin en Android",
  "branchName": "ralph/migracion-kotlin",
  "userStories": [
    {"id": "US-001", "title": "Crear interfaz Scraper", "passes": false, "dependsOn": []},
    {"id": "US-002", "title": "Implementar WeebCentralScraper", "passes": false, "dependsOn": ["US-001"]}
  ]
}

Tamaño de las Historias: La Regla #1

Cada historia debe poder completarse en UNA iteración de ralph-tui (~una ventana de contexto del agente).

Ralph-tui crea una instancia de agente nueva por iteración sin memoria del trabajo anterior. Si una historia es demasiado grande, el agente se queda sin contexto antes de terminar.

Historias de tamaño adecuado:

  • Añadir una columna a la base de datos + migración
  • Añadir un componente de UI a una página existente
  • Actualizar una server action con nueva lógica
  • Añadir un menú desplegable de filtros a una lista

Demasiado grandes (dividir estas):

  • "Construir todo el panel de control" → Dividir en: esquema, consultas, componentes de UI, filtros
  • "Añadir autenticación" → Dividir en: esquema, middleware, UI de inicio de sesión, manejo de sesiones
  • "Refactorizar la API" → Dividir en una historia por endpoint o patrón

Regla general: Si no puedes describir el cambio en 2-3 oraciones, es demasiado grande.


Dependencias con dependsOn

Usa el arreglo dependsOn para especificar qué historias deben completarse primero:

{
  "id": "US-002",
  "title": "Crear endpoints de API",
  "dependsOn": ["US-001"],  // No se seleccionará hasta que US-001 pase
  ...
}

Ralph-tui:

  • Mostrará US-002 como "bloqueada" hasta que US-001 se complete
  • Nunca seleccionará US-002 para ejecución mientras US-001 esté abierta
  • Incluirá "Prerrequisitos: US-001" en el prompt al trabajar en US-002

Orden de dependencia correcto:

  1. Cambios de esquema/base de datos (sin dependencias)
  2. Lógica de backend (depende del esquema)
  3. Componentes de UI (dependen del backend)
  4. Integración/pulido (depende de la UI)

Criterios de Aceptación: Puertas de Calidad + Específicos de la Historia

Los criterios de aceptación de cada historia deben incluir:

  1. Criterios específicos de la historia del PRD (lo que logra esta historia)
  2. Puertas de calidad de la sección "Puertas de Calidad" del PRD (añadidas al final)

Buenos criterios (verificables):

  • "Añadir columna status a la tabla tasks con valor predeterminado 'open'"
  • "El menú desplegable de filtros tiene opciones: Todas, Abiertas, Cerradas"
  • "Hacer clic en eliminar muestra un diálogo de confirmación"

Malos criterios (vagos):

  • ❌ "Funciona correctamente"
  • ❌ "El usuario puede hacer X fácilmente"
  • ❌ "Buena experiencia de usuario"
  • ❌ "Maneja casos extremos"

Reglas de Conversión

  1. Extraer Puertas de Calidad del PRD primero
  2. Cada historia de usuario → una entrada JSON
  3. IDs: Secuenciales (US-001, US-002, etc.)
  4. Prioridad: Basada en el orden de dependencia (1 = más alta)
  5. dependsOn: Arreglo de IDs de historias que esta historia requiere
  6. Todas las historias: passes: false y notes vacío
  7. branchName: Derivar del nombre de la funcionalidad, en kebab-case, con prefijo ralph/
  8. Criterios de aceptación: Criterios de la historia + puertas de calidad añadidas
  9. Historias de UI: También añadir puertas específicas de UI (verificación en navegador)

Ubicación de Salida

Predeterminado: ./tasks/prd.json (junto a los archivos markdown del PRD)

Esto mantiene todos los archivos relacionados con el PRD juntos en el directorio tasks/.

O especifica una ruta diferente - ralph-tui la usará con:

ralph-tui run --prd ./ruta/a/prd.json

Ejemplo

PRD de entrada:

# PRD: Sistema de Prioridad de Tareas

Añadir niveles de prioridad a las tareas.

## Puertas de Calidad

Estos comandos deben pasar para cada historia de usuario:
- `pnpm typecheck` - Verificación de tipos
- `pnpm lint` - Análisis de código

Para historias de UI, incluye también:
- Verificar en el navegador usando el skill dev-browser

## Historias de Usuario

### US-001: Añadir campo de prioridad a la base de datos
**Descripción:** Como desarrollador, necesito almacenar la prioridad de las tareas.

**Criterios de Aceptación:**
- [ ] Añadir columna de prioridad: 1-4 (predeterminado 2)
- [ ] La migración se ejecuta correctamente

### US-002: Mostrar insignia de prioridad en tarjetas de tareas
**Descripción:** Como usuario, quiero ver la prioridad de la tarea de un vistazo.

**Criterios de Aceptación:**
- [ ] La insignia muestra P1/P2/P3/P4 con colores
- [ ] La insignia es visible sin pasar el ratón

### US-003: Añadir menú desplegable de filtro por prioridad
**Descripción:** Como usuario, quiero filtrar tareas por prioridad.

**Criterios de Aceptación:**
- [ ] Menú desplegable de filtro: Todas, P1, P2, P3, P4
- [ ] El filtro persiste en la URL

Salida prd.json:

{
  "project": "mi-app",
  "branchName": "ralph/prioridad-tareas",
  "description": "Añadir niveles de prioridad a las tareas",
  "userStories": [
    {
      "id": "US-001",
      "title": "Añadir campo de prioridad a la base de datos",
      "description": "Como desarrollador, necesito almacenar la prioridad de las tareas.",
      "acceptanceCriteria": [
        "Añadir columna de prioridad: 1-4 (predeterminado 2)",
        "La migración se ejecuta correctamente",
        "pnpm typecheck pasa",
        "pnpm lint pasa"
      ],
      "priority": 1,
      "passes": false,
      "notes": "",
      "dependsOn": []
    },
    {
      "id": "US-002",
      "title": "Mostrar insignia de prioridad en tarjetas de tareas",
      "description": "Como usuario, quiero ver la prioridad de la tarea de un vistazo.",
      "acceptanceCriteria": [
        "La insignia muestra P1/P2/P3/P4 con colores",
        "La insignia es visible sin pasar el ratón",
        "pnpm typecheck pasa",
        "pnpm lint pasa",
        "Verificar en el navegador usando el skill dev-browser"
      ],
      "priority": 2,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-001"]
    },
    {
      "id": "US-003",
      "title": "Añadir menú desplegable de filtro por prioridad",
      "description": "Como usuario, quiero filtrar tareas por prioridad.",
      "acceptanceCriteria": [
        "Menú desplegable de filtro: Todas, P1, P2, P3, P4",
        "El filtro persiste en la URL",
        "pnpm typecheck pasa",
        "pnpm lint pasa",
        "Verificar en el navegador usando el skill dev-browser"
      ],
      "priority": 3,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-002"]
    }
  ]
}

Ejecutar con ralph-tui

Después de crear prd.json:

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

Ralph-tui:

  1. Cargará las historias desde prd.json
  2. Seleccionará la historia de mayor prioridad con passes: false y sin dependencias bloqueantes
  3. Generará un prompt con los detalles de la historia + criterios de aceptación
  4. Ejecutará el agente para implementar la historia
  5. Marcará passes: true al completarse
  6. Repetirá hasta que todas las historias pasen

Lista de Verificación Antes de Guardar

  • Puertas de Calidad extraídas del PRD (o preguntado al usuario si faltan)
  • Cada historia se puede completar en una iteración
  • Historias ordenadas por dependencia (esquema → backend → UI)
  • dependsOn configurado correctamente para cada historia
  • Puertas de calidad añadidas a los criterios de aceptación de cada historia
  • Las historias de UI tienen verificación en navegador (si se especifica en Puertas de Calidad)
  • Los criterios de aceptación son verificables (no vagos)
  • No hay dependencias circulares

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

Skills relacionados