skyroc-admin-prd-prototype

Generate traceable PRDs and interactive standalone HTML prototypes for Skyroc Admin modules.

792|173|Updated Aug 8, 2024
One-click install
npx skills add https://github.com/Ohh-889/skyroc-admin --skill skyroc-admin-prd-prototype
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skyroc-admin-prd-prototype
Source: https://github.com/Ohh-889/skyroc-admin/tree/main/.agents/skills/skyroc-admin-prd-prototype
Command: npx skills add https://github.com/Ohh-889/skyroc-admin --skill skyroc-admin-prd-prototype

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Designing admin modules often produces PRDs disconnected from the real backend contract and static mockups that cannot be clicked or verified. This Skill grounds every design decision in the current FastAPI routes, schemas, permissions, and React implementation, then delivers interactive HTML prototypes validated on desktop and mobile widths.

Core Features & Use Cases

  • Evidence-based PRD writing: Reads current FastAPI contracts, React pages, design system docs, and optional reference implementations before writing, separating confirmed facts from design assumptions.
  • Standalone HTML prototypes: Generates one independently openable index.html per real page, with working drawers, dialogs, filters, toasts, dark theme, and responsive layouts down to 390px.
  • Structured acceptance workflow: Ships a static verification script, an acceptance checklist covering three viewport sizes, keyboard accessibility, and screenshot evidence requirements.
  • Use Case: Ask for a PRD and prototype for a new OSS file-management module; the Skill reads the current backend contract, writes the PRD, builds the HTML pages, runs the verification script, and reports what remains a design assumption.

Quick Start

Use the skyroc-admin-prd-prototype skill to write a PRD and generate interactive HTML prototypes for the user management module based on the current FastAPI contract.

Frequently Asked Questions about skyroc-admin-prd-prototype

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a PRD and HTML prototype for an admin module?

Invoke the skill by name and specify the target module. It reads the current FastAPI routes, schemas, and React pages, writes a Markdown PRD separating facts from assumptions, then generates one standalone index.html per real page with working interactions.

What makes these HTML prototypes different from static mockups?

Each prototype is a self-contained HTML file with functional drawers, dialogs, filters, toasts, and dark theme toggling. Pages link to each other via relative paths and must pass a static verification script plus browser checks at 1440px, 1024px, and 390px widths.

Does the prototype connect to the real FastAPI backend?

No. Prototypes use in-memory demo data and never call real write endpoints or embed tokens. The PRD explicitly marks which capabilities are implemented, partially implemented, or still design assumptions pending backend work.

How does the skill handle outdated interface information from old PRDs?

It re-reads the current FastAPI source code on every task and treats historical or external references only as business context. Conflicts are resolved in favor of the current backend contract, and unverifiable items are recorded as design assumptions.

What validation runs before a prototype is delivered?

The skill runs Oxfmt formatting checks and its verify-prototypes.mjs script, which enforces doctype, lang, viewport, focus styles, media queries, aria attributes, and absence of template placeholders. Browser testing then covers interactions, console errors, and three viewport sizes.

When should I not use this PRD prototype workflow?

Avoid it when you only need production React code changes, since the skill does not modify production frontend code unless explicitly requested. It is also unnecessary for trivial single-field changes that do not warrant a full PRD and prototype cycle.