mcpField
N
ns-proto-creator

ns-proto-creator

github.com/nextstage-brasilDesign & UI091 installsUpdated 6d ago
Repository

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

  1. 01Capture UI with Playwright
  2. 02Document the existing interface
  3. 03Create or evolve one prototype
  4. 04Review prototype quality
  5. 05Maintain appearance specifications
  6. 06Offer visual-guide handoff

Use cases

  1. 01Recreate observed screens in a prototype
  2. 02Extend an existing prototype in place
  3. 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-creator

After installing, type/ns-proto-creatorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
evals.json
references/
as-is-docs.md
build-prototype.md
capture-playwright.md

Details

From the project README

Proto 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 wantsRedirect
Only *-visual.md / descrição normativa / guia de aparêncians-proto-visual-guide
Full SDD version / requirements / tasksns-spec-driven
Bare bugfix, no prototype scopens-coder
Brownfield architecture map onlyTell user run /ns-harness prepare

Boot (mandatory, once per session)

Short natural-language questions. No giant questionnaire.

  1. Base URL — login / which Playwright MCP profile if multiple.
  2. Scope — screens, roles, add/change.
  3. 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
PhaseReference / workerBehavior
Capturereferences/capture-playwright.mdDiscover Playwright MCP; navigate; screenshots; note structure, fonts, icons, density
AS-ISreferences/as-is-docs.mdWrite/update docs/ briefs from evidence
Build / Evolvereferences/build-prototype.md + ns-frontend-designOnly under prototype/; mirror flows/fields/states; modern stack — no legacy clone
Qualityns-best-practicesHygiene + Web Interface Guidelines review on prototype surfaces
Livingns-living-spec appearanceCreate docs/specs/ + INDEX if missing; SHALL for visible product behavior only
Handoffns-proto-visual-guideOffer / 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/ — load ns-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-harness codebase-reverse-spec.md — business reverse from code (complement URL capture)
  • ns-frontend-design / ns-best-practices — design + quality workers

Comments

Markdown supported