name: "Project Scaffolding Skill" description: "First impressions matter. Set projects up for success." applyTo: "/scaffold,/init,/new,/create,**/README*"

Project Scaffolding Skill

First impressions matter. Set projects up for success.

Essential Files

README Structure

<!-- Hero SVG banner -->
# Project Name

> One-line description

## Features
- Feature 1
- Feature 2

## Quick Start
[3 commands max]

## Documentation
[Links]

## License
[Badge + link]

Hero Banner Pattern

• Width: 800-1200px
• Height: 200-400px
• Include: Logo, tagline, 3-5 key features
• Format: SVG (scalable), PNG fallback
• Dark/light mode variants

Documentation Folder

docs/
├── README.md           # Index
├── QUICK-START.md      # 5-min guide
├── ARCHITECTURE.md     # System design
├── API.md              # Reference
└── CONTRIBUTING.md     # Dev guide

Planning Files

Config Files by Stack

Quality Gates

• README has hero banner
• Quick start works in < 5 min
• License specified
• Contributing guide exists
• .gitignore appropriate for stack

Synapses

See synapses.json for connections.