shinpr/nautilus / .agents/skills/prototype-guide
prototype-guide
VerifiedDefines evidence-grounded prototype quality and external-generator prompt construction. Use when generating or evaluating a prototype, or exporting a prompt for Lovable, v0, or a similar tool.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.2 KB |
| references/lovable-template.md | markdown | 4.4 KB |
| references/prototype-prompt-guide.md | markdown | 7.9 KB |
| references/prototype-quality.md | markdown | 5.5 KB |
| references/v0-template.md | markdown | 3.6 KB |
SKILL.md
View on GitHub---
name: prototype-guide
description: Defines evidence-grounded prototype quality and external-generator prompt construction. Use when generating or evaluating a prototype, or exporting a prompt for Lovable, v0, or a similar tool.
---
# Prototype Guide
## Purpose
A prototype makes one product decision observable before delivery. Apply product evidence and design decisions that affect that observation; leave unrelated implementation choices to the generator.
## Required Context
Start from:
1. the hypothesis and its success/failure criteria;
2. the persona and scenario when they change behavior or evaluation;
3. the product and design sources selected by `references/prototype-quality.md`.
Classify a missing input as blocking only when it controls the tested flow or interpretation. Name the missing decision and the evidence that would resolve it.
## Shared Prototype Contract
- Focus on one validation decision. Combine hypotheses only when the same interaction and evidence resolve them together.
- Make the critical flow, consequences, and relevant recovery behavior observable.
- Use domain-realistic content and data rather than generic placeholders.
- Apply the highest-priority available design source instead of re-inferring existing decisions.
- Implement the states that can occur and affect the validation decision. Report each implemented trigger and any non-obvious exclusion whose absence could change evaluation.
- Keep the visible UI product-native; carry test setup and evaluation evidence in the completion report.
- Preserve the artifacts needed to evaluate, reproduce, or reuse the result.
## Reference Routing
- WHEN generating or evaluating a prototype artifact: read `references/prototype-quality.md` and apply every applicable criterion.
- WHEN exporting a prompt for an external generator: also read `references/prototype-prompt-guide.md` and the selected platform template.
- WHEN product-specific usability, persona, state, or accessibility decisions are needed: load `design-perspective`.
## Scope Boundary
This skill owns prototype quality and prompt construction. `recipe-validate` owns the validation lifecycle and hypothesis record. `recipe-prototype-prompt` owns explicit external prompt export. The prototype generator owns the HTML artifact.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |