docs: Add FAQ section for common questions

README.md

@@ -392,3 +392,119 @@ This repository provides examples and templates for creating Claude Skills. The
 ---
 
 **Ready to build?** Try one of the shortcuts above, or explore the [factory templates](documentation/templates/) to start generating production-ready skills, agents, prompts, or slash commands!
+
+---
+
+## ❓ FAQ - Frequently Asked Questions
+
+### What is Claude Code Skill Factory?
+
+**Claude Code Skill Factory** is a comprehensive toolkit for generating production-ready Claude Skills and Claude Code Agents at scale. It provides templates, examples, and powerful prompt engineering systems to create custom skills and specialized agents for Claude AI across all platforms.
+
+### What can I build with this factory?
+
+| Factory | Output | Presets/Features |
+|---------|--------|-----------------|
+| **Skills Factory** | Complete Claude Skills with SKILL.md + Python + docs + ZIP | Interactive Q&A (4-5 questions), production-ready templates |
+| **Agents Factory** | Claude Code Agents with enhanced YAML + MCP support | Auto-invocation, tool access, color/field/expertise config |
+| **Prompt Factory** | Mega-prompts for any role | **69 presets** across 15 domains, XML/Claude/ChatGPT/Gemini formats, 7-point validation |
+| **Hooks Factory** | Claude Code hooks for workflow automation | 7 event types, safety validation, Python/JS/Rust/Go templates |
+| **Slash Command Factory** | Custom slash commands | 17 presets, 3 Anthropic patterns, 4-layer validation |
+| **Codex CLI Bridge** | Claude Code ↔ Codex CLI interoperability | CLAUDE.md → AGENTS.md sync, cross-tool collaboration |
+
+### How do I start building?
+
+| Shortcut | Method | Example |
+|----------|--------|---------|
+| **Interactive Builder** | Just ask Claude | "I want to build something" → factory-guide orchestrates |
+| **Slash Commands** | Use `/build` commands | `/build skill`, `/build agent`, `/build prompt`, `/build hook` |
+| **Ready-Made Skills** | Install Prompt Factory | `cp -r generated-skills/prompt-factory ~/.claude/skills/` → "I need a prompt for [role]" |
+
+### What slash commands are available?
+
+| Command | Purpose |
+|---------|---------|
+| `/build` | Interactive builder (skill/agent/prompt/hook) |
+| `/build-hook` | Build Claude Code hooks |
+| `/validate-output` | Validate generated output + auto-ZIP |
+| `/install-skill` | Install skills to Claude Code |
+| `/install-hook` | Install hooks to settings |
+| `/test-factory` | Run test examples |
+| `/factory-status` | Check system status |
+| `/sync-agents-md` | Generate AGENTS.md from CLAUDE.md |
+| `/codex-exec` | Execute Codex CLI commands |
+| `/sync-todos-to-github` | Convert TodoWrite tasks to GitHub issues |
+
+### What interactive agents guide me?
+
+| Agent | Purpose | Questions |
+|-------|---------|-----------|
+| **factory-guide** | Orchestrator - delegates to specialists | 1-2 questions |
+| **skills-guide** | Build Claude Skills | 4-5 questions |
+| **prompts-guide** | Use Prompt Factory | 5-7 questions |
+| **agents-guide** | Build Claude Code Agents | 5-6 questions |
+| **hooks-guide** | Build Claude Code Hooks | 5-7 questions |
+
+### What is Prompt Factory?
+
+**Prompt Factory** is the most popular ready-to-use skill with **69 professional presets** across 15 domains:
+- Business, Marketing, Product, Engineering, C-Level Advisory
+- Sales, HR, Legal, Finance, Operations
+- Design, Data Science, DevOps, Security, Research
+
+**Output formats**: XML, Claude, ChatGPT, Gemini
+**Quality validation**: 7-point system (clarity, completeness, specificity, actionability, examples, tone, consistency)
+
+### What is Codex CLI Bridge?
+
+**Codex CLI Bridge** enables Claude Code ↔ OpenAI Codex CLI interoperability:
+- Automatic CLAUDE.md → AGENTS.md translation
+- Reference-based architecture (no duplication)
+- Cross-tool team collaboration support
+- Safety mechanisms and auto-validation
+
+Shortcut: `/sync-agents-md` to sync documentation for Codex CLI users.
+
+### What are the installation requirements?
+
+| Requirement | Details |
+|-------------|---------|
+| **Claude Code** | Desktop CLI or IDE extension |
+| **Skills Directory** | `~/.claude/skills/` for skill installation |
+| **Hooks Settings** | `.claude/settings.json` or user-level settings |
+| **Optional** | Codex CLI for AGENTS.md sync |
+
+### What skills are included?
+
+| Skill | Purpose | Location |
+|-------|---------|----------|
+| **Prompt Factory** | 69 presets mega-prompt generator | `generated-skills/prompt-factory/` |
+| **Hook Factory** | Claude Code hooks automation | `generated-skills/hook-factory/` |
+| **Slash Command Factory** | Custom slash command generation | `generated-skills/slash-command-factory/` |
+| **Codex CLI Bridge** | Claude Code ↔ Codex CLI sync | `generated-skills/codex-cli-bridge/` |
+| **Agent Factory** | Claude Code Agent generation | `generated-skills/agent-factory/` |
+| **CLAUDE.md Enhancer** | CLAUDE.md generation & maintenance | `generated-skills/claude-md-enhancer/` |
+
+### How do I contribute?
+
+1. Fork the repository
+2. Add new example skills to `claude-skills-examples/`
+3. Ensure skills follow formatting standards
+4. Include complete implementation with samples
+5. Submit a pull request
+
+### What license applies?
+
+Skills you generate using these templates are yours to use as you see fit. The repository provides examples and templates only.
+
+### Where can I get help?
+
+| Resource | Link |
+|----------|------|
+| **Anthropic Skills Docs** | https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview |
+| **Skills Marketplace** | https://github.com/anthropics/skills |
+| **Engineering Blog** | https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills |
+| **API Documentation** | https://docs.claude.com/en/api/skills-guide |
+| **Claude Skills Library** | https://github.com/alirezarezvani/claude-skills |
+| **Claude Code Tresor** | https://github.com/alirezarezvani/claude-code-tresor |
+