setup-project

Validates project structure and bootstraps minimal monorepo scaffolding when essential files are missing.

4|1|Updated Jul 31, 2025
One-click install
npx skills add https://github.com/alvis/.agents --skill setup-project-alvis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-project
Source: https://github.com/alvis/.agents/tree/main/plugins/coding/skills/setup-project
Command: npx skills add https://github.com/alvis/.agents --skill setup-project-alvis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting work in a monorepo often means discovering a project directory is missing its package.json, TypeScript config, or source entry point. This Skill validates that a target path is ready for development and, only when essential files are missing, creates a minimal scaffold that mimics similar projects in the same monorepo. ## Core Features & Use Cases - Fast validation: Runs quick directory-level checks for package.json, source directories, and config files, reporting "already set up" when the project is complete. - Conditional bootstrap: Scans sibling projects for common patterns, then creates a minimal package.json, essential config files, and placeholder source, installing dependencies with the detected package manager (pnpm, npm, or yarn). - Verification and rollback: Re-runs structural checks after bootstrap, fixes minor issues, and rolls back created files on critical failure before retrying once. - Use Case: Before implementing a feature in a new packages/auth-service directory, run this Skill to confirm the package structure exists or generate the minimal scaffold so coding can begin immediately. ## Quick Start Set up the project at packages/auth-service as a service and confirm it is ready for development.

Frequently Asked Questions about setup-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a new project in a monorepo?

Provide the target path and optionally a type flag such as --type=app, lib, or service. The skill first validates existing structure, then creates a minimal package.json, config files, and placeholder source modeled on similar projects in the monorepo.

How do I validate that a project is ready for development?

Run the skill against the target path; it performs fast directory-level checks for package.json, a source directory with files, and project config files. If everything exists and matches sibling projects, it reports the project as already set up without modifying anything.

Does project scaffolding work with pnpm, npm, and yarn?

Yes, dependency installation uses whichever package manager is detected in the repository. Installation only runs during the bootstrap phase and is skipped when the project is already configured.

When should I not use automated project scaffolding?

Do not use it for implementing business logic or feature code, modifying an already-configured project, or creating structure beyond the minimum viable scaffold. It also rejects targets outside the repository or paths with no detectable monorepo root.

What happens if project bootstrap fails partway through?

Minor check failures are fixed and re-run. On a critical failure, the files created during bootstrap are rolled back and the bootstrap is retried once; if a blocker remains, it is reported instead of looping.