CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This repository contains dotfiles, Claude Code skills, and an Ansible playbook for Ubuntu dev machine setup.

Ansible Setup

Run the playbook to provision a new Ubuntu machine:

ansible-playbook -i hosts.ini setup.yml

Run specific tags:

ansible-playbook -i hosts.ini setup.yml --tags "dev"  # tmux, zsh, fzf, ripgrep, neovim, claude
ansible-playbook -i hosts.ini setup.yml --tags "languages"  # python, node, bun

Skills

Skills are defined in .claude/skills/[skill-name]/SKILL.md using YAML frontmatter for metadata.

Available Skills

• reflect: Analyze sessions and propose improvements to skills. Invoke with /reflect or /reflect [skill-name]. Supports toggle commands (/reflect on|off|status) for automatic end-of-session reflection.

Creating New Skills

Place skill files at .claude/skills/[skill-name]/SKILL.md with frontmatter:

---
name: skill-name
description: What this skill does
allowed-tools: Read, Write, Edit, Grep, Glob, Task, Bash, AskUserQuestion
---

Dotfiles

• .bashrc - Auto-attaches to tmux session "default" on interactive shells
• .gitconfig - GPG signing enabled, nvim as editor
• .tmux.conf - Prefix: backtick, vi mode, mouse enabled
• .config/init.lua - Neovim: 4-space indentation, space leader
• .inputrc - Bracketed paste disabled