claude-code-extensions: Instructions file for Claude Code

OpenSpec Instructions

These instructions are for AI assistants working in this project.

Always open @/openspec/AGENTS.md when the request:

• Mentions planning or proposals (words like proposal, spec, change, plan)
• Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
• Sounds ambiguous and you need the authoritative spec before coding

Use @/openspec/AGENTS.md to learn:

• How to create and apply change proposals
• Spec format and conventions
• Project structure and guidelines

Keep this managed block so 'openspec update' can refresh the instructions.

CLAUDE.md

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

Repository Purpose

This repository is a working project for creating and managing Claude Code extensions: agents, hooks, commands, skills, and output styles. When users request new extensions, you should create them here using the patterns and templates defined below.

Extension Creation

IMPORTANT: When creating extensions, use the appropriate tool:

For Agents: Use meta-agent at .claude/agents/meta-agent.md

• Fetches the latest Claude Code documentation
• Generates complete, production-ready agent files
• Writes directly to .claude/agents/

For Skills: Use the /create-skill command

• Syntax: /create-skill <name> "<description>" [doc-urls...]
• Uses the skill skeleton template at templates/skill-skeleton/
• Generates SKILL.md and README.md with proper structure
• Evaluates and creates optional directories (templates/, scripts/, references/)
• Writes directly to .claude/skills/

Project Structure

.claude/
├── settings.json          # Hook configuration (all lifecycle events registered)
├── agents/                # Organized by category: core, orchestrators, universal, specialized
├── hooks/                 # Python scripts for lifecycle events
│   └── utils/            # Shared utilities (llm/, tts/)
├── commands/             # Reusable slash commands
└── skills/               # Model-invoked capabilities (flat structure)

templates/
└── skill-skeleton/       # Starter template for new skills

docs/claude-code/         # Official Claude Code documentation
├── sub-agents.md
├── hooks.md
├── hooks-reference.md
├── commands-reference.md
├── agent-skills.md
└── output-styles.md

logs/                     # Runtime logs (generated by hooks)