Communitygithub.com

ComeOnOliver/skillshub

Konvertiert PRDs in das prd.json-Format für die Ausführung mit ralph-tui. Erstellt JSON-Aufgabendateien mit User Stories, Abnahmekriterien und Abhängigkeiten. Auslöser: create prd.json, convert to json, ralph json, create json tasks.

Was ist skillshub?

Dieses Skill konvertiert Product Requirement Documents (PRDs) in das prd.json-Format, das von ralph-tui zur autonomen Ausführung verwendet wird. Es ist als Teil des ralph-tui-Ökosystems konzipiert und extrahiert Quality Gates, User Stories und Abhängigkeiten aus einer PRD-Markdown-Datei. Der Skill erstellt eine flache JSON-Struktur mit einem "name"-Feld und einem "userStories"-Array – ohne verschachtelte Objekte oder Wrapper. Jede User Story erhält eine eindeutige ID, Abnahmekriterien (inklusive der globalen Quality Gates), eine Priorität basierend auf der Abhängigkeitsreihenfolge und ein "dependsOn"-Array. Der Skill unterstützt aktuelle Plattformen wie ralph-tui und wird in Zukunft mit weiteren Tracker-Plugins (Linear, GitHub Issues usw.) erweiterbar sein. Die Ausgabe erfolgt standardmäßig in ./tasks/prd.json.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Ralph TUI - JSON-Aufgaben erstellen

Konvertiert PRDs in das prd.json-Format für die autonome Ausführung mit ralph-tui.

Hinweis: Dieses Skill ist mit dem JSON-Tracker-Plugin von ralph-tui gebündelt. Zukünftige Tracker-Plugins (Linear, GitHub Issues usw.) werden eigene Skills zur Aufgabenerstellung mitbringen.

⚠️ WICHTIG: Die Ausgabe MUSS ein FLACHES JSON-Objekt mit "name" und "userStories" auf der HAUPTEBENE sein. NICHT den Inhalt in ein "prd"-Objekt oder "tasks"-Array packen. Siehe Abschnitt "Schema-Anti-Patterns" unten.


Die Aufgabe

Nehmen Sie ein PRD (Markdown-Datei oder Text) und erstellen Sie eine prd.json-Datei:

  1. Quality Gates extrahieren aus dem Abschnitt "Quality Gates" des PRD
  2. User Stories aus dem PRD parsen
  3. Quality Gates an die Abnahmekriterien jeder Story anhängen
  4. Abhängigkeiten zwischen den Stories einrichten
  5. Ausgabe bereit für ralph-tui run --prd <pfad>

Schritt 1: Quality Gates extrahieren

Suchen Sie nach dem Abschnitt "Quality Gates" im PRD:

## Quality Gates

Diese Befehle müssen für jede User Story bestehen:
- `pnpm typecheck` - Typprüfung
- `pnpm lint` - Linting

Für UI-Stories zusätzlich:
- Im Browser mit dev-browser Skill überprüfen

Extrahieren Sie:

  • Universelle Gates: Befehle, die für ALLE Stories gelten (z.B. pnpm typecheck)
  • UI-Gates: Befehle, die nur für UI-Stories gelten (z.B. Browserüberprüfung)

Wenn kein Abschnitt "Quality Gates" existiert: Fragen Sie den Benutzer, welche Befehle bestehen sollen, oder verwenden Sie einen sinnvollen Standard wie npm run typecheck.


Ausgabeformat

Die JSON-Datei MUSS ein FLACHES Objekt auf der Hauptebene sein:

{
  "name": "[Projektname aus PRD oder Verzeichnis]",
  "branchName": "ralph/[feature-name-kebab-case]",
  "description": "[Feature-Beschreibung aus PRD]",
  "userStories": [
    {
      "id": "US-001",
      "title": "[Story-Titel]",
      "description": "Als [Benutzer] möchte ich [Funktion], um [Nutzen]",
      "acceptanceCriteria": [
        "Kriterium 1 aus PRD",
        "Kriterium 2 aus PRD",
        "pnpm typecheck besteht",
        "pnpm lint besteht"
      ],
      "priority": 1,
      "passes": false,
      "notes": "",
      "dependsOn": []
    },
    {
      "id": "US-002",
      "title": "[UI-Story, die von US-001 abhängt]",
      "description": "...",
      "acceptanceCriteria": [
        "...",
        "pnpm typecheck besteht",
        "pnpm lint besteht",
        "Im Browser mit dev-browser Skill überprüfen"
      ],
      "priority": 2,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-001"]
    }
  ]
}

WICHTIG: Schema-Anti-Patterns (NICHT VERWENDEN)

Die folgenden Muster sind UNGÜLTIG und führen zu Validierungsfehlern:

❌ FALSCH: Wrapper-Objekt

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

Dies packt alles in ein "prd"-Objekt. TUN SIE DAS NICHT. Die Felder "name" und "userStories" müssen auf der HAUPTEBENE liegen.

❌ FALSCH: Verwendung von "tasks" statt "userStories"

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

Das Array heißt "userStories", nicht "tasks".

❌ FALSCH: Komplexe verschachtelte Strukturen

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

Auch wenn das PRD Phasen/Meilensteine/Sprints beschreibt, MÜSSEN Sie diese in ein einziges "userStories"-Array abflachen.

❌ FALSCH: Verwendung von "status" statt "passes"

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

Verwenden Sie "passes": false für unerledigte Stories, "passes": true für erledigte.

✅ RICHTIG: Flache Struktur auf Hauptebene

{
  "name": "Android Kotlin Migration",
  "branchName": "ralph/kotlin-migration",
  "userStories": [
    {"id": "US-001", "title": "Scraper-Schnittstelle erstellen", "passes": false, "dependsOn": []},
    {"id": "US-002", "title": "WeebCentralScraper implementieren", "passes": false, "dependsOn": ["US-001"]}
  ]
}

Story-Größe: Die #1 Regel

Jede Story muss in EINER ralph-tui-Iteration (~einem Agent-Kontextfenster) abschließbar sein.

Ralph-tui erzeugt für jede Iteration eine frische Agenteninstanz ohne Erinnerung an vorherige Arbeit. Wenn eine Story zu groß ist, hat der Agent nicht genug Kontext, um sie zu beenden.

Angemessene Größe:

  • Datenbankspalte + Migration hinzufügen
  • UI-Komponente zu einer bestehenden Seite hinzufügen
  • Server-Action mit neuer Logik aktualisieren
  • Filter-Dropdown zu einer Liste hinzufügen

Zu groß (teilen Sie diese):

  • "Das gesamte Dashboard bauen" → Aufteilen in: Schema, Abfragen, UI-Komponenten, Filter
  • "Authentifizierung hinzufügen" → Aufteilen in: Schema, Middleware, Login-UI, Session-Handling
  • "Die API umgestalten" → Aufteilen in eine Story pro Endpunkt oder Muster

Faustregel: Wenn Sie die Änderung nicht in 2-3 Sätzen beschreiben können, ist sie zu groß.


Abhängigkeiten mit dependsOn

Verwenden Sie das dependsOn-Array, um anzugeben, welche Stories zuerst abgeschlossen sein müssen:

{
  "id": "US-002",
  "title": "API-Endpunkte erstellen",
  "dependsOn": ["US-001"],  // Wird erst ausgewählt, wenn US-001 bestanden ist
  ...
}

Ralph-tui wird:

  • US-002 als "blockiert" anzeigen, bis US-001 abgeschlossen ist
  • US-002 nie zur Ausführung auswählen, solange US-001 offen ist
  • "Voraussetzungen: US-001" in den Prompt aufnehmen, wenn an US-002 gearbeitet wird

Richtige Abhängigkeitsreihenfolge:

  1. Schema/Datenbank-Änderungen (keine Abhängigkeiten)
  2. Backend-Logik (abhängig von Schema)
  3. UI-Komponenten (abhängig von Backend)
  4. Integration/Feinschliff (abhängig von UI)

Abnahmekriterien: Quality Gates + Story-spezifisch

Jede Story sollte Abnahmekriterien enthalten:

  1. Story-spezifische Kriterien aus dem PRD (was diese Story erreicht)
  2. Quality Gates aus dem Abschnitt "Quality Gates" des PRD (am Ende angehängt)

Gute Kriterien (überprüfbar):

  • "status-Spalte zur tasks-Tabelle mit Standardwert 'open' hinzufügen"
  • "Filter-Dropdown hat Optionen: Alle, Offen, Geschlossen"
  • "Klicken auf Löschen zeigt Bestätigungsdialog"

Schlechte Kriterien (vage):

  • ❌ "Funktioniert korrekt"
  • ❌ "Benutzer kann X einfach machen"
  • ❌ "Gute UX"
  • ❌ "Behandelt Randfälle"

Konvertierungsregeln

  1. Quality Gates zuerst aus PRD extrahieren
  2. Jede User Story → ein JSON-Eintrag
  3. IDs: Sequenziell (US-001, US-002, usw.)
  4. Priorität: Basierend auf Abhängigkeitsreihenfolge (1 = höchste)
  5. dependsOn: Array mit Story-IDs, die diese Story benötigt
  6. Alle Stories: passes: false und leere notes
  7. branchName: Vom Feature-Namen ableiten, kebab-case, mit ralph/ präfix
  8. Abnahmekriterien: Story-Kriterien + Quality Gates angehängt
  9. UI-Stories: Auch UI-spezifische Gates anhängen (Browserüberprüfung)

Ausgabeort

Standard: ./tasks/prd.json (neben den PRD-Markdown-Dateien)

Dies hält alle PRD-bezogenen Dateien im tasks/-Verzeichnis zusammen.

Oder geben Sie einen anderen Pfad an - ralph-tui verwendet ihn mit:

ralph-tui run --prd ./pfad/zu/prd.json

Beispiel

Eingabe-PRD:

# PRD: Aufgaben-Prioritätssystem

Fügen Sie Prioritätsstufen zu Aufgaben hinzu.

## Quality Gates

Diese Befehle müssen für jede User Story bestehen:
- `pnpm typecheck` - Typprüfung
- `pnpm lint` - Linting

Für UI-Stories zusätzlich:
- Im Browser mit dev-browser Skill überprüfen

## User Stories

### US-001: Prioritätsfeld zur Datenbank hinzufügen
**Beschreibung:** Als Entwickler muss ich Aufgabenpriorität speichern können.

**Abnahmekriterien:**
- [ ] Prioritätsspalte hinzufügen: 1-4 (Standard 2)
- [ ] Migration läuft erfolgreich

### US-002: Prioritätsabzeichen auf Aufgabenkarten anzeigen
**Beschreibung:** Als Benutzer möchte ich Aufgabenpriorität auf einen Blick sehen.

**Abnahmekriterien:**
- [ ] Abzeichen zeigt P1/P2/P3/P4 mit Farben
- [ ] Abzeichen ohne Hover sichtbar

### US-003: Prioritätsfilter-Dropdown hinzufügen
**Beschreibung:** Als Benutzer möchte ich Aufgaben nach Priorität filtern.

**Abnahmekriterien:**
- [ ] Filter-Dropdown: Alle, P1, P2, P3, P4
- [ ] Filter bleibt in URL erhalten

Ausgabe prd.json:

{
  "project": "my-app",
  "branchName": "ralph/task-priority",
  "description": "Prioritätsstufen zu Aufgaben hinzufügen",
  "userStories": [
    {
      "id": "US-001",
      "title": "Prioritätsfeld zur Datenbank hinzufügen",
      "description": "Als Entwickler muss ich Aufgabenpriorität speichern können.",
      "acceptanceCriteria": [
        "Prioritätsspalte hinzufügen: 1-4 (Standard 2)",
        "Migration läuft erfolgreich",
        "pnpm typecheck besteht",
        "pnpm lint besteht"
      ],
      "priority": 1,
      "passes": false,
      "notes": "",
      "dependsOn": []
    },
    {
      "id": "US-002",
      "title": "Prioritätsabzeichen auf Aufgabenkarten anzeigen",
      "description": "Als Benutzer möchte ich Aufgabenpriorität auf einen Blick sehen.",
      "acceptanceCriteria": [
        "Abzeichen zeigt P1/P2/P3/P4 mit Farben",
        "Abzeichen ohne Hover sichtbar",
        "pnpm typecheck besteht",
        "pnpm lint besteht",
        "Im Browser mit dev-browser Skill überprüfen"
      ],
      "priority": 2,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-001"]
    },
    {
      "id": "US-003",
      "title": "Prioritätsfilter-Dropdown hinzufügen",
      "description": "Als Benutzer möchte ich Aufgaben nach Priorität filtern.",
      "acceptanceCriteria": [
        "Filter-Dropdown: Alle, P1, P2, P3, P4",
        "Filter bleibt in URL erhalten",
        "pnpm typecheck besteht",
        "pnpm lint besteht",
        "Im Browser mit dev-browser Skill überprüfen"
      ],
      "priority": 3,
      "passes": false,
      "notes": "",
      "dependsOn": ["US-002"]
    }
  ]
}

Ausführung mit ralph-tui

Nach dem Erstellen von prd.json:

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

Ralph-tui wird:

  1. Stories aus prd.json laden
  2. Die Story mit der höchsten Priorität auswählen, die passes: false und keine blockierenden Abhängigkeiten hat
  3. Einen Prompt mit Story-Details + Abnahmekriterien generieren
  4. Den Agenten ausführen, um die Story zu implementieren
  5. Bei Erfolg passes: true setzen
  6. Wiederholen, bis alle Stories bestanden sind

Checkliste vor dem Speichern

  • Quality Gates aus PRD extrahiert (oder Benutzer gefragt, falls fehlend)
  • Jede Story in einer Iteration abschließbar
  • Stories nach Abhängigkeit geordnet (Schema → Backend → UI)
  • dependsOn korrekt für jede Story gesetzt
  • Quality Gates an die Abnahmekriterien jeder Story angehängt
  • UI-Stories haben Browserüberprüfung (falls in Quality Gates angegeben)
  • Abnahmekriterien sind überprüfbar (nicht vage)
  • Keine zirkulären Abhängigkeiten

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

Verwandte Skills