Setup Claude Skills Skill

Setup Claude Skills

This Skill sets up Claude Code skills from berlysia/dotfiles repository in other projects with a single command.

What it does

Creates .claude/settings.json with SessionStart hook (if not exists)
Installs all skills to ~/.claude/ immediately
Skills auto-update on every Claude Code startup

When to use

Setting up skills in a new project
User asks to "setup Claude skills" or "install skills"
User wants to use berlysia/dotfiles skills in current project

Implementation Steps

Step 1: Check if .claude/settings.json exists

Read .claude/settings.json to check current state:

If file doesn't exist → Proceed to Step 2
If file exists → Proceed to Step 3

Step 2: Create new settings.json (if not exists)

Create .claude/settings.json with this content:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "curl -fsSL https://raw.githubusercontent.com/berlysia/dotfiles/master/scripts/install-skills.sh | bash"
          }
        ]
      }
    ]
  }
}

Important: Use exact JSON structure with proper nesting.

Step 3: Handle existing settings.json

If .claude/settings.json already exists, guide user to manually add SessionStart hook:

Read current settings.json content
Check if SessionStart hook already exists
If SessionStart exists, check if it includes the install-skills.sh command
If not exists, provide instructions to add it:

To enable auto-update, add this to your .claude/settings.json:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "curl -fsSL https://raw.githubusercontent.com/berlysia/dotfiles/master/scripts/install-skills.sh | bash"
          }
        ]
      }
    ]
  }
}

Step 4: Run installation immediately

After creating or updating settings.json, run installation:

curl -fsSL https://raw.githubusercontent.com/berlysia/dotfiles/master/scripts/install-skills.sh | bash

This installs skills to ~/.claude/skills/ right away.

Step 5: Verify installation

Check that skills were installed:

ls ~/.claude/skills/

Expected output: List of skill directories.

Step 6: Inform user

Tell user:

Skills are now available via /skill-name commands
Skills auto-update on Claude Code startup
List installed skills with descriptions
Mention documentation at https://github.com/berlysia/dotfiles/blob/master/docs/external-usage.md

Available Skills

After installation, these skills will be available:

/semantic-commit - Complex commit splitting and semantic commit generation
/react-hooks - React hooks best practices and optimization
/codex-review-cli - Quick code review via Codex CLI
/codex-review-mcp - Conversational code review via Codex MCP
/logic-validation - Logic consistency validation
/optimizing-claude-md - CLAUDE.md quality analysis
/skill-builder - Guided skill creation

Error Handling

curl command fails:

Check network connection
Verify GitHub is accessible
Try manual installation: git clone https://github.com/berlysia/dotfiles

Settings.json syntax error:

Validate JSON syntax
Ensure proper quote escaping
Check no trailing commas

Skills not appearing:

Check ~/.claude/skills/ directory exists
Verify curl and git are installed
Run install script manually

Example Usage

User: "Setup Claude skills from your dotfiles"

Agent Skills: Setup Claude Skills

Install this agent skill to your local

Skill Files