# Boilerplate

> Generate project scaffolds from descriptions. Use when starting a new project, scaffolding, or creating "CLI in Go", "React app with auth", or similar from a short description. Use when this capability is needed.

- Skill: `tomevault-io/boilerplate` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/boilerplate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/boilerplate/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/boilerplate

---


# Boilerplate

Generate minimal project scaffolds from short descriptions. Turn "CLI in Go with cobra" or "React app with auth" into a runnable structure with the right files and commands.

## When to Use

- User wants to start a new project from a description
- User asks for a scaffold, boilerplate, or starter
- User says "create a X that does Y" and expects a project layout

## Workflow

1. **Parse request**: Language, framework, key features (auth, DB, API, CLI)
2. **Choose stack**: Specific tools (e.g. cobra for Go CLI, Vite+React for frontend)
3. **Design layout**: Directories, main entry, config, README
4. **Generate**: Minimal files to run (main, config, one example)
5. Ask for clarifications, personalisation if needed

## Scaffold Rules

1. **Minimal**: Only what's needed to run and one clear path (e.g. one command, one route).
2. **Conventional**: Standard layout (e.g. cmd/ for Go, src/ for TS/JS).
3. **Runnable**: User can install deps and run with 1–2 commands.
4. **Documented**: README with install, run, and (if applicable) env vars.

## README for Scaffolds

```markdown
# [Project Name]

[One-line description]

## Setup

\`\`\`bash
[install deps: npm install, go mod download, etc.]
\`\`\`

## Run

\`\`\`bash
[npm run dev, go run ., etc.]
\`\`\`

## [Optional: Env / Config]
```

## What to Generate

- **Always**: Entry point, dependency file (package.json, go.mod, Cargo.toml, etc.), README
- **When relevant**: Config (e.g. .env.example), one test, .gitignore
- **Avoid**: Full app logic; keep to minimal “hello world” or one feature

## Ambiguity

If the request is vague:

- Pick one reasonable stack and say what you chose: "Using Vite + React; say if you want Next.js instead."
- Default to TypeScript for Node/React unless they say "JavaScript".

## Anti-Patterns

- ❌ Huge template with many options; keep it small
- ❌ Unrunnable (missing deps, wrong paths)
- ❌ No README or run instructions
- ❌ Over-engineered (e.g. full DDD for a tiny CLI)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/lvndry) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->