project-scaffold_skill

Overview

This skill scaffolds new software projects with production-ready defaults and modern tooling. It guides a user through name, type, language/framework, and feature choices, then generates a complete codebase with templates, config files, and Git initialization. It supports frontend apps, CLIs, REST APIs, and monorepos in TypeScript/JavaScript or Python.

How this skill works

The skill interactively collects project details (kebab-case name, project type, language/framework, and optional features). It copies the appropriate base template, substitutes project variables (name in multiple cases, author, year) into template files, and adds selected feature files. Finally it creates a .gitignore, runs git init, and prints next steps including install and dev commands.

When to use it

• You want to create a new project or start a new app from scratch
• You need a starter repo with sensible defaults and modern tooling
• You want an opinionated boilerplate for frontend, CLI, API, or monorepo projects
• You want to include testing, linting, CI, Docker, or docs during initialization
• You want consistent project structure and automated template variable substitution

Best practices

• Validate project name in kebab-case and keep it 2–50 characters
• Choose TypeScript for type safety by default for JavaScript ecosystems
• Select only the features you plan to use to avoid configuration bloat
• Review and customize generated CI and Docker files before pushing to production
• Run the recommended install and dev commands shown after generation

Example use cases

• Scaffold a React + TypeScript single-page app with testing, linting, and GitHub Actions
• Create a Python CLI tool using Click with pytest and a publishing-ready layout
• Initialize an Express REST API in TypeScript with Docker and CI workflows
• Start a monorepo for multiple Node packages using pnpm and Turborepo
• Generate a minimal vanilla frontend site with Vite and a README and license