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.