Communitygithub.com

ComeOnOliver/skillshub

Convertit les PRD en perles (beads) pour exécution via ralph-tui. Crée une épopée avec des perles enfants pour chaque user story.

Qu'est-ce que skillshub ?

Cette compétence permet de transformer un document PRD (Product Requirements Document) en un ensemble de tâches structurées appelées 'perles' (beads), utilisables par l'outil ralph-tui. Elle analyse le PRD pour en extraire les sections clés (Quality Gates, User Stories) et génère automatiquement un fichier `.beads/beads.jsonl` contenant une épopée (epic) et ses perles enfants avec leurs dépendances, priorités et critères d'acceptation. L'objectif est de découper le travail en histoires suffisamment petites pour être réalisées en une seule itération de ralph-tui, et de garantir que les dépendances sont correctement ordonnées (schéma → backend → UI). Cette compétence est spécialement conçue pour le plugin Beads Tracker de ralph-tui, mais pourra être adaptée à d'autres trackers (Linear, GitHub Issues) ultérieurement.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Ralph TUI - Créer des Perles (Beads)

Convertit les PRD en perles (épopée + tâches enfants) pour exécution autonome via ralph-tui.

Remarque : Cette compétence est fournie avec le plugin Beads Tracker de ralph-tui. Les futurs plugins de suivi (Linear, GitHub Issues, etc.) incluront leurs propres compétences de création de tâches.


Le Travail

Prendre un PRD (fichier markdown ou texte) et créer des perles dans .beads/beads.jsonl :

  1. Extraire les Quality Gates de la section "Quality Gates" du PRD
  2. Créer une perle épopée pour la fonctionnalité
  3. Créer des perles enfants pour chaque user story (avec les Quality Gates ajoutées)
  4. Configurer les dépendances entre les perles (schéma → backend → UI)
  5. Produire un résultat prêt pour ralph-tui run --tracker beads

Étape 1 : Extraire les Quality Gates

Recherchez la section "Quality Gates" dans le PRD :

## Quality Gates

Ces commandes doivent fonctionner pour chaque user story :
- `pnpm typecheck` - Vérification des types
- `pnpm lint` - Linting

Pour les histoires UI, inclure également :
- Vérifier dans le navigateur avec la compétence dev-browser

Extrayez :

  • Gates universels : Commandes qui s'appliquent à TOUTES les histoires (p. ex., pnpm typecheck)
  • Gates UI : Commandes qui s'appliquent uniquement aux histoires UI (p. ex., vérification dans le navigateur)

Si aucune section Quality Gates n'existe : Demandez à l'utilisateur quelles commandes doivent fonctionner, ou utilisez une valeur par défaut raisonnable comme npm run typecheck.


Format de Sortie

Les perles utilisent la commande bd create avec la syntaxe HEREDOC pour gérer en toute sécurité les caractères spéciaux :

# Créer l'épopée (lien vers le PRD source)
bd create --type=epic \
  --title="[Nom de la fonctionnalité]" \
  --description="$(cat <<'EOF'
[Description de la fonctionnalité du PRD]
EOF
)" \
  --external-ref="prd:./tasks/nom-fonctionnalite-prd.md"

# Créer une perle enfant (avec Quality Gates dans les critères d'acceptation)
bd create \
  --parent=EPIC_ID \
  --title="[Titre de l'histoire]" \
  --description="$(cat <<'EOF'
[Description de l'histoire avec critères d'acceptation INCLUANT les Quality Gates]
EOF
)" \
  --priority=[1-4]

CRITIQUE : Utilisez toujours <<'EOF' (avec guillemets simples) pour le délimiteur HEREDOC. Cela empêche l'interprétation par le shell des backticks, des $variables et des () dans les descriptions.


Taille des Histoires : La Règle #1

Chaque histoire doit pouvoir être réalisée en UNE itération de ralph-tui (~une fenêtre de contexte de l'agent).

ralph-tui lance une nouvelle instance d'agent par itération sans mémoire du travail précédent. Si une histoire est trop grande, l'agent manque de contexte avant de terminer.

Histoires de taille adaptée :

  • Ajouter une colonne à une base de données + migration
  • Ajouter un composant UI à une page existante
  • Mettre à jour une action serveur avec une nouvelle logique
  • Ajouter une liste déroulante de filtre à une liste

Trop grandes (à diviser) :

  • "Construire le tableau de bord complet" → Diviser en : schéma, requêtes, composants UI, filtres
  • "Ajouter l'authentification" → Diviser en : schéma, middleware, UI de connexion, gestion des sessions
  • "Refactoriser l'API" → Diviser en une histoire par endpoint ou par motif

Règle empirique : Si vous ne pouvez pas décrire le changement en 2-3 phrases, c'est trop grand.


Ordre des Histoires : D'abord les Dépendances

Les histoires s'exécutent dans l'ordre des dépendances. Les histoires précédentes ne doivent pas dépendre des suivantes.

Ordre correct :

  1. Changements de schéma/base de données (migrations)
  2. Actions serveur / logique backend
  3. Composants UI qui utilisent le backend
  4. Vues de tableau de bord/résumé qui agrègent les données

Ordre incorrect :

  1. ❌ Composant UI (dépend d'un schéma qui n'existe pas encore)
  2. ❌ Changement de schéma

Dépendances avec bd dep add

Utilisez la commande bd dep add pour spécifier quelles perles doivent être terminées en premier :

# Créer d'abord les perles
bd create --parent=epic-123 --title="US-001 : Ajouter le schéma" ...
bd create --parent=epic-123 --title="US-002 : Créer l'API" ...
bd create --parent=epic-123 --title="US-003 : Construire l'UI" ...

# Ajouter ensuite les dépendances (le problème dépend du bloqueur)
bd dep add ralph-tui-002 ralph-tui-001  # US-002 dépend de US-001
bd dep add ralph-tui-003 ralph-tui-002  # US-003 dépend de US-002

Syntaxe : bd dep add <problème> <dépend_de> — le problème dépend de (est bloqué par) dépend_de.

ralph-tui va :

  • Afficher les perles bloquées comme "bloquées" jusqu'à ce que les dépendances soient terminées
  • Ne jamais sélectionner une perle pour exécution tant que ses dépendances sont ouvertes
  • Inclure le contexte de dépendance dans l'invite lorsqu'il travaille sur une perle

Ordre correct des dépendances :

  1. Changements de schéma/base de données (aucune dépendance)
  2. Logique backend (dépend du schéma)
  3. Composants UI (dépend du backend)
  4. Intégration/polissage (dépend de l'UI)

Critères d'Acceptation : Quality Gates + Spécifiques à l'Histoire

La description de chaque perle doit inclure les critères d'acceptation avec :

  1. Critères spécifiques à l'histoire du PRD (ce que cette histoire accomplit)
  2. Quality Gates de la section Quality Gates du PRD (ajoutés à la fin)

Bons critères (vérifiables) :

  • "Ajouter la colonne investorType à la table investor avec une valeur par défaut 'cold'"
  • "La liste déroulante de filtre a les options : Tout, Froid, Ami"
  • "Cliquer sur le bouton bascule affiche une boîte de dialogue de confirmation"

Mauvais critères (vagues) :

  • ❌ "Fonctionne correctement"
  • ❌ "L'utilisateur peut faire X facilement"
  • ❌ "Bonne UX"
  • ❌ "Gère les cas limites"

Règles de Conversion

  1. Extraire les Quality Gates du PRD d'abord
  2. Chaque user story → une perle
  3. Première histoire : Aucune dépendance (crée la fondation)
  4. Histoires suivantes : Dépendent de leurs prédécesseurs (UI dépend du backend, etc.)
  5. Priorité : Basée sur l'ordre des dépendances, puis l'ordre du document (0=critique, 2=moyen, 4=backlog)
  6. Toutes les histoires : status: "open"
  7. Critères d'acceptation : Critères de l'histoire + Quality Gates ajoutées
  8. Histoires UI : Ajouter également les gates spécifiques à l'UI (vérification dans le navigateur)

Division des Gros PRD

Si un PRD contient de grandes fonctionnalités, divisez-les :

Original :

"Ajouter un suivi de sensibilisation des amis avec différents messages"

Divisé en :

  1. US-001 : Ajouter le champ investorType à la base de données
  2. US-002 : Ajouter un bouton bascule de type à la liste des investisseurs UI
  3. US-003 : Créer la logique de progression de phase spécifique aux amis
  4. US-004 : Créer les modèles de messages pour les amis
  5. US-005 : Câbler la génération de tâches pour les amis
  6. US-006 : Ajouter un filtre par type
  7. US-007 : Mettre à jour le formulaire de nouvel investisseur
  8. US-008 : Mettre à jour les compteurs du tableau de bord

Chacun est un changement ciblé qui peut être réalisé et vérifié indépendamment.


Exemple

PRD d'entrée :

# PRD : Sensibilisation des Amis

Ajouter la possibilité de marquer les investisseurs comme "amis" pour une sensibilisation chaleureuse.

## Quality Gates

Ces commandes doivent fonctionner pour chaque user story :
- `pnpm typecheck` - Vérification des types
- `pnpm lint` - Linting

Pour les histoires UI, inclure également :
- Vérifier dans le navigateur avec la compétence dev-browser

## User Stories

### US-001 : Ajouter le champ investorType à la table investor
**Description :** En tant que développeur, j'ai besoin de catégoriser les investisseurs comme 'cold' ou 'friend'.

**Critères d'acceptation :**
- [ ] Ajouter la colonne investorType : 'cold' | 'friend' (valeur par défaut 'cold')
- [ ] Générer et exécuter la migration avec succès

### US-002 : Ajouter un bouton bascule de type aux lignes de la liste des investisseurs
**Description :** En tant que Ryan, je veux basculer le type d'investisseur directement depuis la liste.

**Critères d'acceptation :**
- [ ] Chaque ligne a un bouton bascule Froid | Ami
- [ ] Le basculement affiche une boîte de dialogue de confirmation
- [ ] Sur confirmation : met à jour le type dans la base de données

### US-003 : Filtrer les investisseurs par type
**Description :** En tant que Ryan, je veux filtrer la liste pour voir uniquement les amis ou les froids.

**Critères d'acceptation :**
- [ ] Liste déroulante de filtre : Tout | Froid | Ami
- [ ] Le filtre persiste dans les paramètres d'URL

Perles de sortie :

# Créer l'épopée (lien vers le PRD source)
bd create --type=epic \
  --title="Suivi de Sensibilisation des Amis" \
  --description="$(cat <<'EOF'
Sensibilisation chaleureuse pour les retours sur le deck
EOF
)" \
  --external-ref="prd:./tasks/amis-sensibilisation-prd.md"

# US-001 : Aucune dépendance (première - crée le schéma)
bd create --parent=ralph-tui-abc \
  --title="US-001 : Ajouter le champ investorType à la table investor" \
  --description="$(cat <<'EOF'
En tant que développeur, j'ai besoin de catégoriser les investisseurs comme 'cold' ou 'friend'.

## Critères d'Acceptation
- [ ] Ajouter la colonne investorType : 'cold' | 'friend' (valeur par défaut 'cold')
- [ ] Générer et exécuter la migration avec succès
- [ ] pnpm typecheck fonctionne
- [ ] pnpm lint fonctionne
EOF
)" \
  --priority=1

# US-002 : Histoire UI (obtient également la vérification navigateur)
bd create --parent=ralph-tui-abc \
  --title="US-002 : Ajouter un bouton bascule de type aux lignes de la liste des investisseurs" \
  --description="$(cat <<'EOF'
En tant que Ryan, je veux basculer le type d'investisseur directement depuis la liste.

## Critères d'Acceptation
- [ ] Chaque ligne a un bouton bascule Froid | Ami
- [ ] Le basculement affiche une boîte de dialogue de confirmation
- [ ] Sur confirmation : met à jour le type dans la base de données
- [ ] pnpm typecheck fonctionne
- [ ] pnpm lint fonctionne
- [ ] Vérifier dans le navigateur avec la compétence dev-browser
EOF
)" \
  --priority=2

# Ajouter la dépendance : US-002 dépend de US-001
bd dep add ralph-tui-002 ralph-tui-001

# US-003 : Histoire UI
bd create --parent=ralph-tui-abc \
  --title="US-003 : Filtrer les investisseurs par type" \
  --description="$(cat <<'EOF'
En tant que Ryan, je veux filtrer la liste pour voir uniquement les amis ou les froids.

## Critères d'Acceptation
- [ ] Liste déroulante de filtre : Tout | Froid | Ami
- [ ] Le filtre persiste dans les paramètres d'URL
- [ ] pnpm typecheck fonctionne
- [ ] pnpm lint fonctionne
- [ ] Vérifier dans le navigateur avec la compétence dev-browser
EOF
)" \
  --priority=3

# Ajouter la dépendance : US-003 dépend de US-002
bd dep add ralph-tui-003 ralph-tui-002

Emplacement de Sortie

Les perles sont écrites dans : .beads/beads.jsonl

Après la création, exécutez ralph-tui :

# Travailler sur une épopée spécifique
ralph-tui run --tracker beads --epic ralph-tui-abc

# Ou laisser choisir la meilleure tâche automatiquement
ralph-tui run --tracker beads

ralph-tui va :

  1. Travailler sur les perles de l'épopée spécifiée (ou sélectionner la meilleure tâche disponible)
  2. Fermer chaque perle une fois terminée
  3. Fermer l'épopée quand tous les enfants sont terminés
  4. Afficher <promise>COMPLETE</promise> lorsque l'épopée est terminée

Liste de Vérification Avant de Créer les Perles

  • Extraire les Quality Gates du PRD (ou demander à l'utilisateur si manquant)
  • Chaque histoire est réalisable en une itération (assez petite)
  • Les histoires sont ordonnées par dépendance (schéma → backend → UI)
  • Les Quality Gates sont ajoutées aux critères d'acceptation de chaque perle
  • Les histoires UI ont une vérification navigateur (si spécifiée dans les Quality Gates)
  • Les critères d'acceptation sont vérifiables (pas vagues)
  • Aucune histoire ne dépend d'une histoire ultérieure (uniquement des histoires précédentes)
  • Les dépendances sont ajoutées avec bd dep add après la création des perles

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 associés