Claude Code Project Instructions

You are working with a Claude Code plugin repository that contains reusable skills extending Claude's capabilities. This skill provides project-specific context and conventions.

Repository Structure

This is a multi-skill plugin repository. Each skill is self-contained in `skills/<name>/`:

```

skills/<name>/

├── .claude-plugin/

│ └── plugin.json # Skill manifest (hooks, metadata)

├── SKILL.md # YAML frontmatter + Claude instructions

├── README.md # User documentation

├── commands/ # Slash commands (auto-discovered)

├── hooks/ # Shell scripts for lifecycle events

└── scripts/ # Python utilities

```

The root `.claude-plugin/marketplace.json` catalogs all available skills. Users install individual skills independently - installing one does not install another's dependencies.

Common Commands

| Task | Command |

|------|---------|

| Build ABOUTME index | `python skills/aboutme-index/scripts/build_index.py . -o .claude/aboutme-index.json` |

| Check missing headers | `python skills/aboutme-index/scripts/build_index.py . --check` |

| Check index staleness | `python skills/aboutme-index/scripts/build_index.py . --stale` |

| Update single file | `python skills/aboutme-index/scripts/update_file.py <file>` |

ABOUTME Convention

**All code files must start with ABOUTME headers** - the first 2 lines describing the file's purpose:

```python

ABOUTME: Brief description of what this file does.

ABOUTME: Additional context about its purpose.

```

This enables semantic indexing via the `aboutme-index` skill. Run `--check` to find files missing headers before committing.

Creating New Skills

When creating a new skill:

1. **Create directory structure**:

```

skills/<name>/

├── .claude-plugin/plugin.json

└── SKILL.md

```

2. **Create `plugin.json`** with required fields:

```json

{

"name": "<name>",

"description": "Brief description",

"version": "1.0.0",

"author": { "name": "Your Name" },

"license": "MIT"

}

```

3. **Create `SKILL.md`** with YAML frontmatter and instructions:

```yaml

---

name: my-skill

description: Brief description shown in skill picker. Use when...

---

# Detailed instructions for Claude

```

4. **Add hooks** (optional) to `plugin.json` and create `hooks/` directory. Use `${CLAUDE_PLUGIN_ROOT}` for paths:

```json

{

"command": "${CLAUDE_PLUGIN_ROOT}/hooks/my-hook.sh"

}

```

5. **Add commands** (optional) in `commands/` - auto-discovered by Claude Code

6. **Register** the skill in root `.claude-plugin/marketplace.json` under the `plugins` array

Hook Execution

Hooks use `${CLAUDE_PLUGIN_ROOT}` which resolves to the installed skill's root directory:

```json

{

"hooks": {

"session-start": {

"command": "${CLAUDE_PLUGIN_ROOT}/hooks/rebuild-index-on-start.sh"

}

}

}

```

This ensures hooks execute within the correct skill context.

Installation Pattern

Users install skills via the marketplace:

```bash

/plugin marketplace add stickystyle/claude-skills

/plugin install aboutme-index@stickystyle-skills

/plugin install uv@stickystyle-skills

```

Each skill installs independently with its own hooks and commands.

Key Principles

When to Use This Skill

Use this skill when: