Skip to content

Claude Code Best Practices

A reference library for setting up Claude Code on any project. Copy what you need — templates, skills, hooks, and guides.

Source Repository

ai-best-practice — all files are meant to be copied into your project and customized.

Quick Start

Copy the CLAUDE.md template into your project root and customize it for your stack.

cp templates/CLAUDE.md.template /path/to/your-project/CLAUDE.md

Add skills to .claude/skills/ — each is a self-contained workflow.

cp -r skills/code-review /path/to/your-project/.claude/skills/

Install hook scripts for automated guardrails — block secrets, protect files, enforce lint.

cp hooks/security-check.py /path/to/your-project/.claude/hooks/

The Setup Guide covers everything: CLAUDE.md, skills, hooks, memory, settings, agent teams.

What's Inside

  • Guides

    • Setup Guide — comprehensive Claude Code configuration
    • Security — what to share, what to protect, prompt injection awareness
    • UI/UX Best Practices — design systems, components, accessibility

  • Skills & Hooks

    • Skills — 4 reusable skills (handover, code-review, skill-creator, update-report)
    • Hooks — 13 hook events, 7 ready-to-use scripts
    • External Tools — curated third-party skills and libraries

  • Agents & Templates

    • Agents — team patterns, custom agents, coordination strategies
    • Templates — starter CLAUDE.md and settings-local.json

Pages at a Glance

Page What You'll Find
Setup Guide CLAUDE.md, skills, hooks, memory, settings, agent teams, workflow patterns
Security Risk model, credential management, prompt injection, emergency procedures
Hooks All 13 events, 7 scripts (security, lint gate, file protection, logging)
Skills handover, code-review, skill-creator, update-report with examples
Agents Agent teams, YAML frontmatter, common patterns, module boundaries
Templates Copy-paste CLAUDE.md and settings-local.json starters
UI/UX Design systems, responsive patterns, accessibility, recommended tools
External Tools UI/UX Pro Max, Marketing Skills, component libraries, a11y tools