dev-setup

Scaffolds new projects with CLAUDE.md, planning files, gitignore, git-crypt, and GitHub repo setup.

3|Updated Oct 28, 2020
One-click install
npx skills add https://github.com/k0d3x8its/dotfiles --skill dev-setup-k0d3x8its
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-setup
Source: https://github.com/k0d3x8its/dotfiles/tree/main/claude/.claude/skills/dev-setup
Command: npx skills add https://github.com/k0d3x8its/dotfiles --skill dev-setup-k0d3x8its

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new project involves dozens of forgettable steps: creating folder structure, writing a README, configuring Claude Code settings, initializing planning files, merging .gitignore entries, setting up git, encrypting sensitive planning files, and creating a GitHub repo. This Skill turns that into one guided wizard so nothing is missed. ## Core Features & Use Cases - Guided project scaffolding: Asks one question at a time (name, description, type, stack) and creates the matching folder structure, README.md, and .claude/CLAUDE.md from templates. - Planning and session file initialization: Creates .work/PLAN.md, .work/FINDINGS.md, .work/PROGRESS.md, .memory/SESSION-LOG.md, CHANGELOG.md, and KNOWLEDGE.md. - Git, git-crypt, and GitHub integration: Runs git init, optionally encrypts planning files with git-crypt (key stored in Proton Pass), and creates a GitHub repo via the gh CLI. - Idempotent .gitignore merging: Append-if-missing merge under a marked block, so re-running never overwrites user-authored ignore rules. - Use Case: You just created an empty directory for a new TypeScript CLI tool. Run the wizard once and end up with a full folder scaffold, configured Claude Code permissions, encrypted planning files, and a pushed GitHub repo. ## Quick Start Run /dev-setup in your new project directory and answer the wizard's questions to scaffold the entire project.

Frequently Asked Questions about dev-setup

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

FAQPage Schema
How do I set up a new project with Claude Code configuration?▼

Run /dev-setup in the project root. The wizard collects the project name, type, and stack, then creates .claude/CLAUDE.md, .claude/settings.json with baseline permissions, a README, and the folder structure matching your project type.

How to initialize git and create a GitHub repo from the command line?▼

The wizard checks git status and offers git init with main as the default branch. It then optionally runs gh repo create with your chosen visibility, setting the remote and pushing in one command.

Does dev-setup overwrite my existing .gitignore file?▼

No. It performs an append-if-missing merge: existing lines are never reordered or deleted, and only missing patterns are appended under a '# --- added by /dev-setup ---' marker. Re-running is idempotent.

Can I encrypt planning files in a git repository?▼

Yes. The wizard offers git-crypt initialization, writes root-anchored .gitattributes rules for files like .work/PLAN.md and KNOWLEDGE.md, adds .gitignore negations, and stores the exported key in a Proton Pass vault.

Is it safe to re-run dev-setup on an existing project?▼

Yes. Every step checks whether the target file already exists and asks before overwriting, or skips silently. The .gitignore merge and git-crypt checks are designed to be no-ops on repeat runs.

What project types does the setup wizard support?▼

Four built-in types: web app, CLI/backend service, library/SDK, and script/automation, each with its own directory scaffold and .gitignore block. An 'Other' option lets you specify directories manually.