# Repo Setup

> Performs initial repository setup including git hooks, demo site creation, and dependency installation. Use when cloning the repository for the first time, onboarding a new developer, or resetting the development environment.

- Skill: `umbraco/repo-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add umbraco/repo-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/umbraco/repo-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: umbraco (https://skillmd.com/u/umbraco)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/umbraco/repo-setup

---


# Setup Repository

You are helping set up the Umbraco.AI repository for local development.

## Task

Perform initial repository setup by running the appropriate setup scripts based on the user's platform and preferences.

## Available Setup Tasks

1. **Git Hooks** - Install git hooks for branch naming enforcement
    - Windows: `.\scripts\setup-git-hooks.ps1`
    - Linux/Mac: `./scripts/setup-git-hooks.sh`

2. **Demo Site** - Create unified solution with demo Umbraco instance
    - Windows: `.\scripts\install-demo-site.ps1`
    - Linux/Mac: `./scripts/install-demo-site.sh`
    - Options: `-SkipTemplateInstall` / `-Force` (PowerShell) or `--skip-template-install` / `--force` (Bash)

3. **Dependencies** - Install npm workspace dependencies
    - Command: `npm install`

4. **Initial Build** - Build the unified solution
    - Command: `dotnet build Umbraco.AI.local.slnx`

## Workflow

1. **Detect platform** - Check if Windows (PowerShell) or Linux/Mac (Bash)
2. **Ask user what to set up** - Use AskUserQuestion with options:
    - "Git hooks only"
    - "Git hooks + demo site"
    - "Full setup (hooks + demo + dependencies + build)"
    - Allow custom selections
3. **Execute selected tasks** in order
4. **Report results** - Show what was completed and any errors

## Important Notes

- Always run scripts from the repository root
- Check if demo site already exists before running install script
- Use platform-specific script extensions (.ps1 vs .sh)
- Provide clear feedback after each step
- If any step fails, report it but continue with remaining tasks if possible

## Example Flow

```
User invokes: /repo-setup

You ask: "What would you like to set up?"
- Git hooks only
- Git hooks + demo site
- Full setup (hooks + demo + dependencies + build)

User selects: "Full setup"

You execute:
1. Run setup-git-hooks script
2. Run install-demo-site script
3. Run npm install
4. Run dotnet build

Report: "Setup complete!"
```