CLAUDE.md - Skills Factory Orchestration

CLAUDE.md - Skills Factory Orchestration

This file provides top-level guidance for working with this Claude Code Skills Factory repository.

---

Repository Purpose

This repository is a **Claude Code Skills factory** - a collection of example skills that demonstrate how to create specialized capabilities for Claude Code. Skills are folders with instructions and resources that Claude loads when relevant to the user's task.

**Key Point**: This is NOT a development project itself. It's a reference repository that users can customize and extend for their own projects. Focus on helping users understand, adapt, and create their own skills based on these examples.

---

Modular CLAUDE.md Architecture

This repository uses **modular CLAUDE.md files** for different contexts. Claude automatically loads the appropriate file based on your working directory.

Navigation Map

Location	Purpose	When Claude Loads It
.github/CLAUDE.md	GitHub workflows, task hierarchy, automation	Working with GitHub issues, PRs, workflows
claude-skills-examples/CLAUDE.md	Skill architecture patterns, examples	Browsing or modifying example skills
generated-skills/CLAUDE.md	Production-ready skills catalog	Exploring or installing generated skills
documentation/CLAUDE.md	Templates and references structure	Working with templates or documentation

**How It Works**: Claude loads the most relevant CLAUDE.md based on your current task context, giving you focused guidance without information overload.

---

Repository Structure

claude-code-skills-factory/
├── README.md                    # Project overview and quick start
├── CLAUDE.md                    # This file - orchestration layer
├── .github/
│   ├── CLAUDE.md               # GitHub workflows & task hierarchy
│   └── workflows/              # Automation (smart-sync, plan-auto-close, etc.)
├── claude-skills-examples/
│   ├── CLAUDE.md               # Skill patterns & architecture
│   └── *.md, *.py              # Reference skill implementations
├── documentation/
│   ├── CLAUDE.md               # Templates & references guide
│   ├── references/             # Official docs (Skills, Agents, Codex CLI)
│   └── templates/              # Factory templates (SKILLS, AGENTS, PROMPTS, SLASH_COMMANDS)
└── generated-skills/
    ├── CLAUDE.md               # Production skills catalog
    └── */                      # Production-ready skills (AWS, Prompt Factory, etc.)

---

Key Principles

0. Critical Validation Rule ⚠️

**"Always validate your output against official native examples before declaring complete."**

When generating skills, agents, prompts, or slash commands:

1. Compare output against official Anthropic documentation
2. Check reference examples in documentation/references/
3. Verify all