About ns-proto-creator
ns-proto-creator is a design skill for capturing an existing UI with Playwright and building or evolving a single prototype from observed evidence. It guides teams through documentation, quality checks, and visual handoff.
Key features
- 01Capture UI with Playwright
- 02Document the existing interface
- 03Create or evolve one prototype
- 04Review prototype quality
- 05Maintain appearance specifications
- 06Offer visual-guide handoff
Use cases
- 01Recreate observed screens in a prototype
- 02Extend an existing prototype in place
- 03Document current UI for design work
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill ns-proto-creatorAfter installing, type/ns-proto-creatorin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
evals/evals.jsonreferences/as-is-docs.mdbuild-prototype.mdcapture-playwright.mdDetails
From the project READMEProto Creator
Delivery face: Playwright reverse prototyping. Capture → AS-IS docs → create/evolve one prototype/ → quality → living appearance → optional visual guides.
Orchestrate. Load worker SKILL.md at delegation. No inline full design checklists or Element|How tables.
Layout (locked)
prototype/ # THE prototype — create once, evolve forever
docs/ # AS-IS briefs, screenshots, appearance guides
docs/specs/ # Living domain specs (when consolidating)
- Missing
prototype/→ create. - Existing
prototype/→ evolve in place. - Never scaffold
vN/prototype/or ask version-folder name. Versioning = git. Optional: remind commit after meaningful evolve.
Harness
See ../../ns-harness/references/session-boot.md and ../../ns-harness/references/artifact-layout.md.
Near-miss routing
| User wants | Redirect |
|---|---|
Only *-visual.md / descrição normativa / guia de aparência | ns-proto-visual-guide |
| Full SDD version / requirements / tasks | ns-spec-driven |
| Bare bugfix, no prototype scope | ns-coder |
| Brownfield architecture map only | Tell user run /ns-harness prepare |
Boot (mandatory, once per session)
Short natural-language questions. No giant questionnaire.
- Base URL — login / which Playwright MCP profile if multiple.
- Scope — screens, roles, add/change.
- Prototype mode — detect
prototype/:- absent → create
- present → evolve in place
No version-id / v1 folder question.
Journey
flowchart TB
boot[Boot questions]
capture[Capture Playwright]
asis[AS-IS docs]
build[Build or evolve prototype]
quality[Best practices + guidelines]
living[Living appearance]
handoff[Offer visual guide]
boot --> capture --> asis --> build --> quality --> living --> handoff
| Phase | Reference / worker | Behavior |
|---|---|---|
| Capture | references/capture-playwright.md | Discover Playwright MCP; navigate; screenshots; note structure, fonts, icons, density |
| AS-IS | references/as-is-docs.md | Write/update docs/ briefs from evidence |
| Build / Evolve | references/build-prototype.md + ns-frontend-design | Only under prototype/; mirror flows/fields/states; modern stack — no legacy clone |
| Quality | ns-best-practices | Hygiene + Web Interface Guidelines review on prototype surfaces |
| Living | ns-living-spec appearance | Create docs/specs/ + INDEX if missing; SHALL for visible product behavior only |
| Handoff | ns-proto-visual-guide | Offer / run for implementation appearance MDs |
Hard rules
- One prototype tree; evolve in place; never parallel
vN/copies - Fidelity from live Playwright evidence; no invented screens
- Stack-free modern UI under
prototype/— loadns-frontend-design - English for this skill's artifacts; project docs language follows repo
- Versioning = git; optional commit remind after meaningful evolve
- No hardcoded product-specific login — project rules / user credentials path
Related skills
ns-proto-visual-guide— normative appearance MDs/ns-harnesscodebase-reverse-spec.md— business reverse from code (complement URL capture)ns-frontend-design/ns-best-practices— design + quality workers