Quick Start

Getting Started

Follow this guide to integrate the Claude Code configuration suite into your repository. This setup enables intelligent skill activation, automated code reviews, and custom command workflows in under five minutes.

1. Prerequisites

Ensure you have the following installed:

• Node.js (v18 or higher)
• Claude Code CLI: npm install -g @anthropic-ai/claude-code

2. Initialize Project Structure

The core of this configuration lives in the .claude directory. Create the following structure in your project root:

mkdir -p .claude/skills .claude/agents .claude/hooks .claude/commands

3. Configure Your First Skill

Skills provide Claude with domain-specific context. Create a markdown file to define a convention (e.g., your testing pattern).

File: .claude/skills/testing-patterns/SKILL.md

# Testing Standards
- Use Vitest for all unit tests.
- Mock all network requests using MSW.
- Name files with the `.test.ts` suffix.

4. Enable the Skill Evaluation Engine

The skill-eval.js hook automatically suggests relevant skills based on your prompt and file context.

1. Copy the skill-eval.js script into .claude/hooks/.
2. Create a skill-rules.json to define triggers:

{
  "skills": {
    "testing-patterns": {
      "triggers": {
        "keywords": ["test", "spec", "vitest"],
        "keywordPatterns": ["write a test", "fix the test"]
      },
      "priority": 10
    }
  },
  "scoring": {
    "keyword": 5,
    "keywordPattern": 10
  }
}

5. Configure Settings

Link your hooks and settings in .claude/settings.json. This ensures Claude executes the evaluation engine before processing your prompts.

{
  "hooks": {
    "pre-prompt": "node .claude/hooks/skill-eval.js"
  },
  "capabilities": {
    "mcp": true,
    "terminal": true
  }
}

6. Usage

Launch Claude Code from your terminal. It will automatically ingest your configuration and activate skills based on your input.

claude

Try it out:

"Hey Claude, create a new test for the auth utility."

Claude will detect the "test" keyword, trigger the testing-patterns skill, and apply your Vitest conventions automatically.

Next Steps

• Add Agents: Create specialized reviewers in .claude/agents/code-reviewer.md.
• Integrate MCP: Configure .mcp.json to connect JIRA or Linear.
• Automate Workflows: Copy the GitHub Actions from .github/workflows/ to enable scheduled audits and automated PR reviews.