# What This Repository Is

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

- Skill: `tools-only/what-this-repository-is` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/what-this-repository-is`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/what-this-repository-is/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/what-this-repository-is

---

# CLAUDE.md

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

## What This Repository Is

A personal collection of reusable Claude Code **skills** and **commands**, installed globally via symlinks to `~/.claude/skills/` and `~/.claude/commands/`.

## Repository Structure

- **Top-level skill folders** (`refactor-components/`, `refactor-code/`, `pr-comments/`, `pr-review/`): Custom skills authored in this repo. Each contains a `SKILL.md`.
- **`commands/`**: Custom slash commands (`.md` files) — `/commit`, `/pr`, `/sync-env-to-github`.
- **`skills/`**: Git submodule pointing to [Anthropic's skills repo](https://github.com/anthropics/skills). Contains the `skill-creator` skill and many reference skills. This is a separate git repo — do not modify files inside it directly.
- **`install.sh` / `uninstall.sh`**: Symlink management scripts that link skill folders and command files into `~/.claude/`.

## How Install Works

`install.sh` iterates top-level directories containing a `SKILL.md` file (skipping hidden dirs and `commands/`), creating symlinks in `~/.claude/skills/`. It also symlinks each `.md` file in `commands/` to `~/.claude/commands/`. The `uninstall.sh` script reverses this by removing only symlinks that point back to this repo.

## Creating New Skills

A skill is a directory with a `SKILL.md` file containing YAML frontmatter (`name`, `description`, optional `disable-model-invocation`, `argument-hint`) followed by markdown instructions. Place new skill directories at the repo root, then re-run `./install.sh`.

## Creating New Commands

A command is a single `.md` file in `commands/` with YAML frontmatter (`allowed-tools`, `description`, optional `argument-hint`) followed by markdown instructions. The filename (minus `.md`) becomes the slash command name.

## Conventions

- Skills use `disable-model-invocation: true` when they should only run through explicit user invocation.
- Commands declare `allowed-tools` in frontmatter to specify which tools they can use (e.g., `Bash(git add:*)`).
- The `/commit` command uses conventional commit format: `type(scope): description`.
- The `/pr` command always targets `main` as the base branch.