ai-agent-skills: Instructions file for Claude Code

CLAUDE.md

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

For all tasks in this repository, the conventions in AGENTS.md apply — read it first and follow it fully (verify commands, sandbox quirk, SKILL.md rules). In case of conflict, AGENTS.md wins.

Repository Purpose

A collection of reusable AI agent skills in the open SKILL.md format. Skills are designed to be AI-agnostic — they rely only on standard tools (git, gh, shell commands) and contain no Claude-specific dependencies.

Skill Structure

Each skill lives in .claude/skills/<skill-name>/ and follows this layout:

<skill-name>/          # kebab-case folder name, must match SKILL.md `name:` field
  SKILL.md             # required; YAML frontmatter + Markdown instructions
  references/          # optional; supporting docs loaded on demand
  scripts/             # optional; executable Bash/Python helpers
  assets/              # optional; templates, fonts, icons

SKILL.md Frontmatter Rules

• name: kebab-case, no spaces or capitals, must match the folder name
• description: under 1024 characters, must include both WHAT the skill does and WHEN to trigger it (specific user-facing phrases); no XML angle brackets
• No README.md inside skill folders — use SKILL.md or references/ instead

Installing Skills for Claude Code

Via npm (recommended): Installs skills, statusline.sh, and the formatter Stop hook. Enable git URL installs once:

npm config set allow-git all

Install (Linux / macOS / WSL):

npm install -g --ignore-scripts https://github.com/dboeckli/ai-agent-skills.git#master && \
  bash "$(npm root -g)/@dboeckli/ai-agent-skills/scripts/install-skills.sh"

Install (Windows — PowerShell):

npm config set allow-git all
npm install -g --ignore-scripts https://github.com/dboeckli/ai-agent-skills.git#master
& "$(npm root -g)/@dboeckli/ai-agent-skills/scripts/install-skills.ps1"