install.md

Installation Guide

Prerequisites

• Claude Code installed and working
• jq installed (for hook scripts): brew install jq (macOS) or apt install jq (Linux)
• Git (to clone this repo)

Step 1: Clone the Repository

git clone https://github.com/giacomogaglione/claude-awesome-stack.git
cd claude-awesome-stack

Step 2: Choose a Stack

Browse the available stacks in the stacks/ directory:

Stack	Status	Description
python-ml	Ready	Python/ML development with debugging skills and auto-formatting hooks
frontend	Coming soon	React/Next.js development

Step 3: Install the Stack

Each stack has its own installation instructions. Here's the general pattern:

Copy CLAUDE.md

# From your project root:
cp path/to/claude-awesome-stack/stacks/<stack-name>/CLAUDE.md ./CLAUDE.md

This gives Claude Code project-specific instructions.

Copy Skills

mkdir -p .claude/skills
cp -r path/to/claude-awesome-stack/stacks/<stack-name>/skills/* .claude/skills/

Copy Hooks

mkdir -p .claude/hooks
cp -r path/to/claude-awesome-stack/stacks/<stack-name>/hooks/* .claude/hooks/
chmod +x .claude/hooks/*.sh

Copy Settings

cp path/to/claude-awesome-stack/stacks/<stack-name>/settings.json .claude/settings.json

Step 4: Verify

Start Claude Code in your project and test:

1. Skills loaded: Ask Claude to use a skill (e.g., "use the ml-debug skill to check my model")
2. Hooks working: Edit a Python file and check that formatting runs automatically
3. CLAUDE.md active: Ask Claude about project conventions -- it should reference the CLAUDE.md content

Troubleshooting

Hooks not running

• Verify scripts are executable: ls -la .claude/hooks/
• Check jq is installed: which jq
• Verify settings.json is in .claude/settings.json

Skills not found

• Skills must be in .claude/skills/<skill-name>/SKILL.md
• Check the directory structure matches exactly

Conflicts with existing settings

If you already have a .claude/settings.json, merge the hook entries manually rather than overwriting.