project-setup

Detects project environment and configures CLAUDE.md, rules, hooks, and settings.

189|25|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/sd0xdev/sd0x-harness --skill project-setup-sd0xdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-setup
Source: https://github.com/sd0xdev/sd0x-harness/tree/main/skills/project-setup
Command: npx skills add https://github.com/sd0xdev/sd0x-harness --skill project-setup-sd0xdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a new project for Claude Code requires manually detecting the framework, package manager, database, and scripts, then filling in CLAUDE.md placeholders and installing rules and hooks. This Skill automates that entire first-time configuration workflow with verification at each stage. ## Core Features & Use Cases - Environment Auto-Detection: Detects ecosystem (Node.js, Python, Go, Rust, Ruby, Java), framework, database, package manager, entrypoints, and script commands from manifest files. - CLAUDE.md Configuration: Renders the template with ecosystem-specific blocks and replaces all placeholders after user confirmation. - Rules, Hooks, and Scripts Installation: Copies 14 managed rules, 6 reminder hooks, and 5 runner scripts into .claude/ with conflict detection and manifest hash tracking. - Environment Variable Configuration: Recommends settings like CLAUDE_CODE_AUTO_COMPACT_WINDOW for 1M context models with legacy value upgrade prompts. - Use Case: After cloning a repository, run the setup once to get a fully configured CLAUDE.md, auto-loop rules, reminder hooks, and settings without manually editing any config files. ## Quick Start Run the project-setup skill to auto-detect my project environment and configure CLAUDE.md, rules, and hooks.

Frequently Asked Questions about project-setup

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

FAQPage Schema
How do I set up CLAUDE.md for a new project automatically?▼

Run the project-setup skill, which detects your framework, package manager, database, and scripts from manifest files like package.json or pyproject.toml. After you confirm the detection results, it writes a configured CLAUDE.md with all placeholders replaced.

How to auto-detect framework and database from package.json?▼

The skill reads dependencies and devDependencies to identify frameworks like NestJS, Express, Fastify, or Next.js, and databases like PostgreSQL, MySQL, or MongoDB. Detection priority rules are defined in references/detection-rules.md.

Does project setup work for Python or Go projects?▼

Yes, it supports Python (pyproject.toml), Go (go.mod), Rust (Cargo.toml), Ruby (Gemfile), and Java (pom.xml or build.gradle) in addition to Node.js. Each ecosystem has its own framework, database, entrypoint, and script detection rules.

Can I run project setup without installing hooks or rules?▼

Yes, use --detect-only to only see detection results, --lite to configure only CLAUDE.md, or --no-rules and --no-hooks to skip those phases. The --env-only flag runs only the environment variable configuration phase.

What happens when project setup finds conflicting existing files?▼

Existing files with identical content are skipped, while files with different content are skipped and reported as conflicts rather than overwritten. The skill uses fresh-install semantics; for smart merging of rules, run /install-rules directly.