Skip to content

Claude Code

Claude Code is Anthropic's official CLI for AI-assisted development. It helps with code generation, debugging, refactoring, and general software engineering tasks.

Installation

brew install --cask claude-code

Configuration

Global CLAUDE.md

Create a global configuration file at ~/.claude/CLAUDE.md to set personal preferences that apply across all projects.

Download the team's standard configuration: CLAUDE.md

mkdir -p ~/.claude
gh api -H "Accept: application/vnd.github.raw" repos/majority-dev/dt-documentation/contents/docs/assets/claude/CLAUDE.md > ~/.claude/CLAUDE.md

Project-level CLAUDE.md

Each repository can have its own CLAUDE.md at the project root. This file contains project-specific instructions that override or extend global settings.

my-project/
├── CLAUDE.md          # Project-specific instructions
├── src/
└── ...

Skills

Skills are reusable prompts that can be invoked with /<skill-name>. They help standardize common tasks across the team.

Skill Locations

Skills can be stored in three locations:

Location Scope Path
Personal Your machine only ~/.claude/skills/
Project Single repository .claude/skills/
Shared Team-wide Dedicated repo or shared folder

Creating a Skill

Create a markdown file with the skill instructions:

mkdir -p ~/.claude/skills

Example skill (~/.claude/skills/test-generator.md):

Generate pytest unit tests for the specified Python code.

Requirements:
- Use pytest fixtures where appropriate
- Include edge cases and error scenarios
- Use descriptive test names following pattern: test_<function>_<scenario>_<expected>
- Mock external dependencies

Using Skills

Invoke a skill by typing its name prefixed with /:

/test-generator

Team Shared Skills

The following skills are available for the team. Download them to your ~/.claude/skills/ directory.

create-skill

Creates new Claude Code skills with proper structure and best practices.

Download: create-skill/SKILL.md

mkdir -p ~/.claude/skills/create-skill
gh api -H "Accept: application/vnd.github.raw" repos/majority-dev/dt-documentation/contents/docs/assets/claude/skills/create-skill/SKILL.md > ~/.claude/skills/create-skill/SKILL.md

Usage: /create-skill [skill-name]

update-deps

Updates project dependencies to latest versions, optionally creating a GitHub issue and PR.

Download: update-deps/SKILL.md

mkdir -p ~/.claude/skills/update-deps
gh api -H "Accept: application/vnd.github.raw" repos/majority-dev/dt-documentation/contents/docs/assets/claude/skills/update-deps/SKILL.md > ~/.claude/skills/update-deps/SKILL.md

Usage: /update-deps

issue

Creates a GitHub issue in majority-dev/projects and a corresponding branch in the current repo. Use when starting new work that needs issue tracking.

Download: issue/SKILL.md

mkdir -p ~/.claude/skills/issue
gh api -H "Accept: application/vnd.github.raw" repos/majority-dev/dt-documentation/contents/docs/assets/claude/skills/issue/SKILL.md > ~/.claude/skills/issue/SKILL.md

Usage: /issue <issue-title>

Install All Skills

To install all team skills at once:

mkdir -p ~/.claude/skills/create-skill ~/.claude/skills/update-deps ~/.claude/skills/issue
gh api -H "Accept: application/vnd.github.raw" repos/majority-dev/dt-documentation/contents/docs/assets/claude/skills/create-skill/SKILL.md > ~/.claude/skills/create-skill/SKILL.md
gh api -H "Accept: application/vnd.github.raw" repos/majority-dev/dt-documentation/contents/docs/assets/claude/skills/update-deps/SKILL.md > ~/.claude/skills/update-deps/SKILL.md
gh api -H "Accept: application/vnd.github.raw" repos/majority-dev/dt-documentation/contents/docs/assets/claude/skills/issue/SKILL.md > ~/.claude/skills/issue/SKILL.md

Best Practices

  • Keep CLAUDE.md instructions concise and specific
  • Update project CLAUDE.md when team conventions change
  • Share useful skills with the team via the shared skills repository
  • Use skills for repetitive tasks to ensure consistency