project-setup

Generate a starter CLAUDE.md with tech-stack notes and architecture from config files.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/paulingham/.claude --skill project-setup-paulingham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-setup
Source: https://github.com/paulingham/.claude/tree/main/skills/project-setup
Command: npx skills add https://github.com/paulingham/.claude --skill project-setup-paulingham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the bootstrap of a repository by generating a standardized CLAUDE.md (and AGENTS.md) that capture tech stack, architecture, conventions, and operational guidelines, so teams start from a consistent baseline.

Core Features & Use Cases

  • Detect common tech stacks from project files (e.g., Gemfile, package.json, pyproject.toml, go.mod) to inform CLAUDE.md content.
  • Generate a mapped architecture section and service/classification notes to guide future evolution.
  • Produce an AGENTS.md roster and initial phase commands to streamline project onboarding.

Quick Start

Run the project-setup skill to generate CLAUDE.md and AGENTS.md at the repo root.

Frequently Asked Questions about project-setup

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

FAQPage Schema
How do I generate a CLAUDE.md file for an existing repository?

To generate a CLAUDE.md for an existing repository, the project-setup Skill parses common config files like package.json or pyproject.toml to detect your tech stack and outputs a structured file with architecture and conventions.

What is the best way to scaffold project architecture and conventions documentation?

Scaffolding project architecture documentation is best handled by auto-detecting your tech stack from config files and generating a standardized CLAUDE.md that maps module boundaries, service classifications, and recommended commands.

Can I automatically create an AGENTS.md roster for my development team?

Yes, you can automatically create an AGENTS.md roster by running the project-setup Skill, which generates the file alongside CLAUDE.md to streamline project onboarding with initial phase commands.

Does project scaffolding work with both greenfield and existing codebases?

Project scaffolding works with both greenfield and existing codebases by parsing standard configuration files such as Gemfile and go.mod to produce a consistent baseline for tech-stack notes and operational guidelines.

How do tech stack detection and module boundaries get mapped into a CLAUDE.md?

Tech stack detection maps into CLAUDE.md by parsing configuration files to identify frameworks, then outputting a structured frontmatter-hosted document that defines module boundaries and service classifications.