## File: README.md

# Claude Code Skills & Plugins — Agent Skills for Every Coding Tool

**362 production-ready Claude Code skills, plugins, and agent skills for 13 AI coding tools.**

The most comprehensive open-source library of Claude Code skills and agent plugins — also works with OpenAI Codex, Gemini CLI, Cursor, and 9 more coding agents. Reusable expertise packages covering engineering, DevOps, marketing (incl. AEO — Answer Engine Optimization for LLM citation), security (PreToolUse hooks), compliance, C-level advisory (incl. founder-mode CFO/CMO/CRO/CPO/COO/CHRO/CISO/GC/CDO/CAIO/CCO/VPE personas + 21 /cs:* slash commands), productivity (capture/email/reflect/weekly-review/deep-work/meetings), an academic research stack (litreview/grants/dossier/patent/syllabus/pulse/notebooklm/deep-research + hybrid router), and enterprise Research Operations (clinical-research/research-finance/market-research/product-research, v2.9.0).

**Works with:** Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Hermes Agent[^hermes] · Mistral Vibe[^vibe] · Cursor · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity

[^hermes]: Hermes Agent is **BYO-sync tier**: the repo ships a pre-generated `.hermes/skills/claude-skills/` tree, but you run `python scripts/sync-hermes-skills.py` once locally to install into `~/.hermes/skills/`. Uses the same agentskills.io SKILL.md standard — no format conversion.
[^vibe]: Mistral Vibe is also **BYO-sync tier**: the repo ships a pre-generated `.vibe/skills/claude-skills/` tree, run `./scripts/vibe-install.sh` once locally to install into `~/.vibe/skills/`. Same agentskills.io SKILL.md standard — no format conversion. Docs: <https://docs.mistral.ai/mistral-vibe/agents-skills>.

[](https://opensource.org/licenses/MIT)
[](#skills-overview)
[](#agents)
[](#personas)
[](#commands)
[](https://github.com/alirezarezvani/claude-skills/stargazers)
[](https://getskillcheck.com)

> **5,200+ GitHub stars** — the most comprehensive open-source Claude Code skills & agent plugins library.

---

## What Are Claude Code Skills & Agent Plugins?

Claude Code skills (also called agent skills or coding agent plugins) are modular instruction packages that give AI coding agents domain expertise they don't have out of the box. Each skill includes:

- **SKILL.md** — structured instructions, workflows, and decision frameworks
- **Python tools** — 644 CLI scripts (all stdlib-only, zero pip installs)
- **Reference docs** — 741 templates, checklists, and domain-specific knowledge files

**One repo, thirteen platforms.** Works natively as Claude Code plugins, Codex agent skills, Gemini CLI skills, Hermes Agent skills, Mistral Vibe skills, and converts to more tools via `scripts/convert.sh`. All 644 Python tools run anywhere Python runs.

### Skills vs Agents vs Personas

| | Skills | Agents | Personas |
|---|---|---|---|
| **Purpose** | How to execute a task | What task to do | Who is thinking |
| **Scope** | Single domain | Single domain | Cross-domain |
| **Voice** | Neutral | Professional | Personality-driven |
| **Example** | "Follow these steps for SEO" | "Run a security audit" | "Think like a startup CTO" |

All three work together. See [Orchestration](#orchestration) for how to combine them.

---

## Quick Install

### Gemini CLI (New)

```bash
# Clone the repository
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills

# Run the setup script
./scripts/gemini-install.sh

# Start using skills
> activate_skill(name="senior-architect")
```

### Claude Code (Recommended)

```bash
# Add the marketplace
/plugin marketplace add alirezarezvani/claude-skills

# Install by domain
/plugin install engineering-skills@claude-code-skills          # 24 core engineering
/plugin install engineering-advanced-skills@claude-code-skills  # 25 POWERFUL-tier
/plugin install product-skills@claude-code-skills               # 12 product skills
/plugin install marketing-skills@claude-code-skills             # 43 marketing skills
/plugin install ra-qm-skills@claude-code-skills                 # 12 regulatory/quality
/plugin install pm-skills@claude-code-skills                    # 6 project management
/plugin install c-level-skills@claude-code-skills               # 28 C-level advisory (full C-suite)
/plugin install business-growth-skills@claude-code-skills       # 4 business & growth
/plugin install finance-skills@claude-code-skills               # 2 finance (analyst + SaaS metrics)

# Or install individual skills
/plugin install skill-security-auditor@claude-code-skills       # Security scanner
/plugin install playwright-pro@claude-code-skills                  # Playwright testing toolkit
/plugin install self-improving-agent@claude-code-skills         # Auto-memory curation
/plugin install content-creator@claude-code-skills              # Single skill
```

### OpenAI Codex

```bash
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex
# Or: git clone + ./scripts/codex-install.sh
```

### OpenClaw

```bash
bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)
```

### Manual Installation

```bash
git clone https://github.com/alirezarezvani/claude-skills.git
# Copy any skill folder to ~/.claude/skills/ (Claude Code) or ~/.codex/skills/ (Codex)
```

---

## Multi-Tool Support (New)

**Convert all 345 skills to 9 AI coding tools** with a single script:

| Tool | Format | Install |
|------|--------|---------|
| **Cursor** | `.mdc` rules | `./scripts/install.sh --tool cursor --target .` |
| **Aider** | `CONVENTIONS.md` | `./scripts/install.sh --tool aider --target .` |
| **Kilo Code** | `.kilocode/rules/` | `./scripts/install.sh --tool kilocode --target .` |
| **Windsurf** | `.windsurf/skills/` | `./scripts/install.sh --tool windsurf --target .` |
| **OpenCode** | `.opencode/skills/` | `./scripts/install.sh --tool opencode --target .` |
| **Augment** | `.augment/rules/` | `./scripts/install.sh --tool augment --target .` |
| **Antigravity** | `~/.gemini/antigravity/skills/` | `./scripts/install.sh --tool antigravity` |
| **Hermes Agent** | `~/.hermes/skills/` | `python scripts/sync-hermes-skills.py --verbose` |
| **Mistral Vibe** | `~/.vibe/skills/` | `./scripts/vibe-install.sh` |

**How it works:**

```bash
# 1. Convert all skills to all tools (takes ~15 seconds)
./scripts/convert.sh --tool all

# 2. Install into your project (with confirmation)
./scripts/install.sh --tool cursor --target /path/to/project

# Or use --force to skip confirmation:
./scripts/install.sh --tool aider --target . --force

# 3. Verify
find .cursor/rules -name "*.mdc" | wc -l  # Should show 346
```

**Each tool gets:**
- ✅ All 345 skills converted to native format
- ✅ Per-tool README with install/verify/update steps
- ✅ Support for scripts, references, templates where applicable
- ✅ Zero manual conversion work

Run `./scripts/convert.sh --tool all` to generate tool-specific outputs locally.

---

## Skills Overview

**362 skills across 18 domains:**

| Domain | Skills | Highlights | Details |
|--------|--------|------------|---------|
| **🔧 Engineering — Core** | 52 | Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright Pro (test gen, flaky fix, migrations), self-improving agent (auto-memory curation), security suite, a11y audit, **named-persona-adversarial-review** (review via named engineering philosophies) | [engineering-team/](engineering-team/) |
| **⚡ Engineering — POWERFUL** | 84 | Agent designer, RAG architect, database designer, CI/CD builder, security auditor, MCP builder, AgentHub, Helm charts, Terraform, self-eval, llm-wiki, tc-tracker, autoresearch-agent, **reliability portfolio** (feature-flags-architect, kubernetes-operator, chaos-engineering, slo-architect), ship-gate, security-guidance PreToolUse hook, **Matt Pocock skills** (write-a-skill, caveman, grill-me, handoff, grill-with-docs), **zero-hallucination-coder** (Discuss→Map→Decompose→Execute→Verify), **agent-harness** (goal→plan→execute→verify→close loops over any domain), **skillopt-sleep** (nightly gated self-evolution from real Claude Code sessions, vendored from microsoft/SkillOpt) | [engineering/](engineering/) |
| **🎯 Product** | 17 | Product manager, agile PO, strategist, UX researcher, UI design, landing pages, SaaS scaffolder, analytics, experiment designer, discovery, roadmap communicator, code-to-prd, apple-hig-expert | [product-team/](product-team/) |
| **📣 Marketing** | 48 | 8 pods: Content, SEO + AEO (`aeo` — E-E-A-T audit, citation tracking across 5 LLMs) + local (`local-seo-manager` — GBP/NAP/Map-Pack), CRO, Channels, Growth, Intelligence, Sales + context foundation + orchestration router | [marketing-skill/](marketing-skill/) |
| **🚀 Productivity** | 11 | `capture` (brain-dump-to-action), `email` pair (inbox-setup + inbox-triage), `reflect` (journal), `handoff` (Matt Pocock-inspired), `andreessen` (market-first decision mode), `roast` (5-angle idea panel → GO/RESHAPE/KILL), `fable-goal` (ramble → autonomous /goal prompt), `weekly-review` (GTD loop with refusal gate), `deep-work` (time-blocking + shallow-work budget), `meetings` (cost gate + agenda + action items) | [productivity/](productivity/) |
| **🎨 Marketing (top-level)** | 1 | `landing` — single-file HTML landing-page generator (4 design styles, GSAP patterns, brand palette validator) | [marketing/](marketing/) |
| **🔬 Research (academic)** | 9 | `research` orchestrator (hybrid router + fallback) + 8 specialists: `pulse`, `litreview`, `grants` (NIH), `dossier`, `patent`, `syllabus`, `notebooklm`, `deep-research` (rigor-first meta-research) | [research/](research/) |
| **🧪 Research Operations** ✨v2.9.0 | 5 | Enterprise/cross-functional research: orchestrator + `clinical-research` (study design), `research-finance` (R&D program finance), `market-research` (sizing/survey/segmentation), `product-research` (user research) — each with onboarding + customization + opt-in autoresearch bridge | [research-ops/](research-ops/) |
| **📋 Project Management** | 9 | Senior PM, scrum master, Jira, Confluence, Atlassian admin, templates + bundled Atlassian Remote MCP | [project-management/](project-management/) |
| **🏥 Regulatory & QM** | 19 | ISO 13505, MDR 2017/745, FDA, ISO 27001, GDPR, SOC 2, CAPA, risk management, agent-decision-receipts (PQ-signed action receipts) | [ra-qm-team/](ra-qm-team/) |
| **🛡️ Compliance OS** | 9 | Compliance operating system — controls, evidence, audit-readiness workflows | [compliance-os/](compliance-os/) |
| **💼 C-Level Advisory** | 68 | Full C-suite (CEO/CTO/CFO/CMO/CRO/CPO/COO/CHRO/CISO/GC/CDO/CAIO/CCO/VPE) + founder-mode agents + orchestration + board meetings + culture & collaboration | [c-level-advisor/](c-level-advisor/) |
| **📈 Business & Growth** | 5 | Customer success, sales engineer, revenue ops, contracts & proposals, BizDev toolkit | [business-growth/](business-growth/) |
| **🏭 Business Operations** | 7 | Orchestrator + process-mapper, vendor-management, capacity-planner, internal-comms, knowledge-ops, procurement-optimizer | [business-operations/](business-operations/) |
| **🤝 Commercial** | 8 | Orchestrator + pricing-strategist, deal-desk, partnerships-architect, channel-economics, commercial-policy, rfp-responder, commercial-forecaster | [commercial/](commercial/) |
| **💰 Finance** | 4 | Financial analyst (DCF, budgeting, forecasting), SaaS metrics coach, business investment advisor | [finance/](finance/) |
| **🔄 Loop Library** | 1 | `loop-library` — discover, find, audit/repair, adapt, and design bounded AI-agent loops; reads the live catalog from signals.forwardfuture.ai at runtime (vendored verbatim from [Forward-Future/loop-library](https://github.com/Forward-Future/loop-library)) | [loop-library/](loop-library/) |
| **📄 Markdown → HTML** | 5 | `markdown-html-orchestrator` (doctype router) + `design-system` (WCAG-AA brand tokens) + `md-document` (long-form) + `md-review` (2-col code review) + `md-slides` (single-file deck) — markdown-to-interactive-HTML converter | [markdown-html/](markdown-html/) |

---

## Personas

Pre-configured agent identities with curated skill loadouts, workflows, and distinct communication styles. Personas go beyond "use these skills" — they define how an agent thinks, prioritizes, and communicates.

| Persona | Domain | Best For |
|---------|--------|----------|
| [**Startup CTO**](agents/personas/startup-cto.md) | Engineering + Strategy | Architecture decisions, tech stack selection, team building, technical due diligence |
| [**Growth Marketer**](agents/personas/growth-marketer.md) | Marketing + Growth | Content-led growth, launch strategy, channel optimization, bootstrapped marketing |
| [**Solo Founder**](agents/personas/solo-founder.md) | Cross-domain | One-person startups, side projects, MVP building, wearing all hats |

**Usage:**
```bash
# Claude Code
cp agents/personas/startup-cto.md ~/.claude/agents/

# Any tool
./scripts/convert.sh --tool cursor  # Converts personas too
```

See [agents/personas/](agents/personas/) for details. Create your own with [TEMPLATE.md](agents/personas/TEMPLATE.md).

---

## Orchestration

A lightweight protocol for coordinating personas, skills, and agents on work that crosses domain boundaries. No framework required.

**Four patterns:**

| Pattern | What | When |
|---------|------|------|
| **Solo Sprint** | Switch personas across project phases | Side projects, MVPs, solo founders |
| **Domain Deep-Dive** | One persona + multiple stacked skills | Architecture reviews, compliance audits |
| **Multi-Agent Handoff** | Personas review each other's output | High-stakes decisions, launch readiness |
| **Skill Chain** | Sequential skills, no persona needed | Content pipelines, repeatable checklists |

**Example: 6-week product launch**
```
Week 1-2: startup-cto + aws-solution-architect + senior-frontend → Build
Week 3-4: growth-marketer + launch-strategy + copywriting + seo-audit → Prepare
Week 5-6: solo-founder + email-sequence + analytics-tracking → Ship and iterate
```

See [orchestration/ORCHESTRATION.md](orchestration/ORCHESTRATION.md) for the full protocol and examples.

---

## POWERFUL Tier

25 advanced skills with deep, production-grade capabilities:

| Skill | What It Does |
|-------|-------------|
| **agent-designer** | Multi-agent orchestration, tool schemas, performance evaluation |
| **agent-workflow-designer** | Sequential, parallel, router, orchestrator, and evaluator patterns |
| **rag-architect** | RAG pipeline builder, chunking optimizer, retrieval evaluator |
| **database-designer** | Schema analyzer, ERD generation, index optimizer, migration generator |
| **database-schema-designer** | Requirements → migrations, types, seed data, RLS policies |
| **migration-architect** | Migration planner, compatibility checker, rollback generator |
| **skill-security-auditor** | 🔒 Security gate — scan skills for malicious code before installation |
| **ci-cd-pipeline-builder** | Analyze stack → generate GitHub Actions / GitLab CI configs |
| **mcp-server-builder** | Build MCP servers from OpenAPI specs |
| **pr-review-expert** | Blast radius analysis, security scan, coverage delta |
| **api-design-reviewer** | REST API linter, breaking change detector, design scorecard |
| **api-test-suite-builder** | Scan API routes → generate complete test suites |
| **dependency-auditor** | Multi-language scanner, license compliance, upgrade planner |
| **observability-designer** | SLO designer, alert optimizer, dashboard generator |
| **performance-profiler** | Node/Python/Go profiling, bundle analysis, load testing |
| **monorepo-navigator** | Turborepo/Nx/pnpm workspace management & impact analysis |
| **changelog-generator** | Conventional commits → structured changelogs |
| **codebase-onboarding** | Auto-generate onboarding docs from codebase analysis |
| **runbook-generator** | Codebase → operational runbooks with commands |
| **git-worktree-manager** | Parallel dev with port isolation, env sync |
| **env-secrets-manager** | .env management, leak detection, rotation workflows |
| **incident-commander** | Incident response playbook, severity classifier, PIR generator |
| **tech-debt-tracker** | Codebase debt scanner, prioritizer, trend dashboard |
| **interview-system-designer** | Interview loop designer, question bank, calibrator |

---

## 🔒 Skill Security Auditor

New in v2.0.0 — audit any skill for security risks before installation:

```bash
python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py /path/to/skill/
```

Scans for: command injection, code execution, data exfiltration, prompt injection, dependency supply chain risks, privilege escalation. Returns **PASS / WARN / FAIL** with remediation guidance.

**Zero dependencies.** Works anywhere Python runs.

---

## Recently Enhanced Skills

Production-quality upgrades added for:

- `engineering/git-worktree-manager` — worktree lifecycle + cleanup automation scripts
- `engineering/mcp-server-builder` — OpenAPI -> MCP scaffold + manifest validator
- `engineering/changelog-generator` — release note generator + conventional commit linter
- `engineering/ci-cd-pipeline-builder` — stack detector + pipeline generator
- `marketing-skill/prompt-engineer-toolkit` — prompt A/B tester + prompt version/diff manager

Each now ships with `scripts/`, extracted `references/`, and a usage-focused `README.md`.

---

## Usage Examples

### Architecture Review
```
Using the senior-architect skill, review our microservices architecture
and identify the top 3 scalability risks.
```

### Content Creation
```
Using the content-creator skill, write a blog post about AI-augmented
development. Optimize for SEO targeting "Claude Code tutorial".
```

### Compliance Audit
```
Using the mdr-745-specialist skill, review our technical documentation
for MDR Annex II compliance gaps.
```

---

## Python Analysis Tools

580 CLI tools ship with the skills (all verified, stdlib-only):

```bash
# SaaS health check
python3 finance/saas-metrics-coach/scripts/metrics_calculator.py --mrr 80000 --customers 200 --churned 3 --json

# Brand voice analysis
python3 marketing-skill/content-production/scripts/brand_voice_analyzer.py article.txt

# Tech debt scoring
python3 c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebase

# RICE prioritization
python3 product-team/product-manager-toolkit/scripts/rice_prioritizer.py features.csv

# Security audit
python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py /path/to/skill/

# Landing page (TSX + Tailwind)
python3 product-team/landing-page-generator/scripts/landing_page_scaffolder.py config.json --format tsx
```

---

## Related Projects

| Project | Description |
|---------|-------------|
| [**Claude Code Skills & Agents Factory**](https://github.com/alirezarezvani/claude-code-skills-agents-factory) | Methodology for building skills at scale |
| [**Claude Code Tresor**](https://github.com/alirezarezvani/claude-code-tresor) | Productivity toolkit with 60+ prompt templates |
| [**Product Manager Skills**](https://github.com/Digidai/product-manager-skills) | Senior PM agent with 6 knowledge domains, 12 templates, 30+ frameworks — discovery, strategy, delivery, SaaS metrics, career coaching, AI product craft |
| [**toprank**](https://github.com/nowork-studio/toprank) | 9 SEO and Google Ads skills for Claude Code — connects Google Search Console, PageSpeed Insights, and Google Ads API; ships meta tag, schema markup, and keyword bid fixes to source or CMS. MIT, 107 stars |

---

## FAQ

**How do I install Claude Code plugins?**
Add the marketplace with `/plugin marketplace add alirezarezvani/claude-skills`, then install any skill bundle with `/plugin install <name>@claude-code-skills`.

**Do these skills work with OpenAI Codex / Cursor / Windsurf / Aider / Mistral Vibe?**
Yes. Skills work natively with 13 tools: Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Hermes Agent, Mistral Vibe, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. Hermes Agent and Mistral Vibe both use the same agentskills.io SKILL.md standard — run `python scripts/sync-hermes-skills.py` or `./scripts/vibe-install.sh` to install. For other tools run `./scripts/convert.sh --tool all` then `./scripts/install.sh --tool <name>`. See [Multi-Tool Integrations](https://alirezarezvani.github.io/claude-skills/integrations/) for details.

**Will updating break my installation?**
No. We follow semantic versioning and maintain backward compatibility within patch releases. Existing script arguments, plugin source paths, and SKILL.md structures are never changed in patch versions. See the [CHANGELOG](CHANGELOG.md) for details on each release.

**Are the Python tools dependency-free?**
Yes. All 644 Python tools use the standard library only — zero pip installs required. Every skill's CLI entry point is verified to run with `--help` (most skills ship one script per tool; a few, like the vendored `engineering/skillopt-sleep` engine, ship a multi-module package behind a single `python -m` entry point).

**How do I create my own Claude Code skill?**
Each skill is a folder with a `SKILL.md` (frontmatter + instructions), optional `scripts/`, `references/`, and `assets/`. See the [Skills & Agents Factory](https://github.com/alirezarezvani/claude-code-skills-agents-factory) for a step-by-step guide.

---

## Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

**Quick ideas:**
- Add new skills in underserved domains
- Improve existing Python tools
- Add test coverage for scripts
- Translate skills for non-English markets

---

## License

MIT — see [LICENSE](LICENSE) for details.

---

## Star History

[Star History Chart](https://www.star-history.com/?type=date&repos=alirezarezvani%2Fclaude-skills)

---

**Built by [Alireza Rezvani](https://alirezarezvani.com)** · [Medium](https://alirezarezvani.medium.com) · [Twitter](https://twitter.com/nginitycloud)

---

## File: agents/personas/README.md

# Persona-Based Agents

Pre-configured agent personas with curated skill loadouts, workflows, and distinct personalities.

## What's a Persona?

A **persona** is an agent definition that goes beyond "use these skills." Each persona includes:

- **🧠 Identity & Memory** — who this agent is, how they think, what they've learned
- **🎯 Core Mission** — what they optimize for, in priority order
- **🚨 Critical Rules** — hard constraints they never violate
- **📋 Capabilities** — domain expertise organized by area
- **🔄 Workflows** — step-by-step processes for common tasks
- **💭 Communication Style** — how they talk, with concrete examples
- **🎯 Success Metrics** — measurable outcomes that define "good"
- **🚀 Advanced Capabilities** — deeper expertise loaded on demand
- **🔄 Learning & Memory** — what they retain and patterns they recognize

## How to Use

### Claude Code
```bash
cp agents/personas/startup-cto.md ~/.claude/agents/
# Then: "Activate startup-cto mode"
```

### Cursor
```bash
./scripts/convert.sh --tool cursor
# Personas convert to .cursor/rules/*.mdc
```

### Any Supported Tool
```bash
./scripts/install.sh --tool <your-tool>
```

## Available Personas

| Persona | Emoji | Domain | Best For |
|---------|-------|--------|----------|
| [Startup CTO](startup-cto.md) | 🏗️ | Engineering + Strategy | Technical co-founders, architecture decisions, team building |
| [Growth Marketer](growth-marketer.md) | 🚀 | Marketing + Growth | Bootstrapped founders, content-led growth, launches |
| [Solo Founder](solo-founder.md) | 🦄 | Cross-domain | One-person startups, side projects, MVP building |

## Personas vs Task Agents

| | Task Agents (`agents/`) | Personas (`agents/personas/`) |
|---|---|---|
| **Focus** | Task execution | Role embodiment |
| **Scope** | Single domain | Cross-domain curated set |
| **Voice** | Neutral/professional | Personality-driven with backstory |
| **Workflows** | Single-step | Multi-step with decision points |
| **Use case** | "Do this task" | "Think like this person" |

Both coexist. Use task agents for focused work, personas for ongoing collaboration.

## Creating Your Own

See [TEMPLATE.md](template.md) for the format specification. Key elements:

```yaml
---
name: Agent Name
color: blue          # Agent color theme
emoji: 🎯           # Single emoji identifier
vibe: One sentence personality capture.
tools: Read, Write, Bash, Grep, Glob
---
```

Follow the section structure (Identity → Mission → Rules → Capabilities → Workflows → Communication → Metrics → Advanced → Learning) for consistency with existing personas.

---

## File: c-level-advisor/README.md

# C-Level Advisory Skills Collection

**Complete suite of 2 executive leadership skills** covering CEO and CTO strategic decision-making and organizational leadership.

---

## 📚 Table of Contents

- [Installation](#installation)
- [Overview](#overview)
- [Skills Catalog](#skills-catalog)
- [Quick Start Guide](#quick-start-guide)
- [Common Workflows](#common-workflows)
- [Success Metrics](#success-metrics)

---

## ⚡ Installation

### Quick Install (Recommended)

Install all C-Level advisory skills with one command:

```bash
# Install all C-Level skills to all supported agents
npx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor

# Install to Claude Code only
npx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor --agent claude

# Install to Cursor only
npx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor --agent cursor
```

### Install Individual Skills

```bash
# CEO Advisor
npx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor/skills/ceo-advisor

# CTO Advisor
npx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor/skills/cto-advisor
```

**Supported Agents:** Claude Code, Cursor, VS Code, Copilot, Goose, Amp, Codex

**Complete Installation Guide:** See [../INSTALLATION.md](../INSTALLATION.md) for detailed instructions, troubleshooting, and manual installation.

---

## 🎯 Overview

This C-Level advisory skills collection provides executive leadership guidance for strategic decision-making, organizational development, and stakeholder management.

**What's Included:**
- **2 executive-level skills** for CEO and CTO roles
- **6 Python analysis tools** for strategy, finance, tech debt, and team scaling
- **Comprehensive frameworks** for executive decision-making, board governance, and technology leadership
- **Ready-to-use templates** for board presentations, ADRs, and strategic planning

**Ideal For:**
- CEOs and founders at startups and scale-ups
- CTOs and VP Engineering roles
- Executive leadership teams
- Board members and advisors

**Key Benefits:**
- 🎯 **Strategic clarity** with structured decision-making frameworks
- 📊 **Data-driven decisions** with financial and technical analysis tools
- 🚀 **Faster execution** with proven templates and best practices
- 💡 **Risk mitigation** through systematic evaluation processes

---

## 📦 Skills Catalog

### 1. CEO Advisor
**Status:** ✅ Production Ready | **Version:** 1.0

**Purpose:** Executive leadership guidance for strategic decision-making, organizational development, and stakeholder management.

**Key Capabilities:**
- Strategic planning and initiative evaluation
- Financial scenario modeling and business outcomes
- Executive decision framework (structured methodology)
- Leadership and organizational culture development
- Board governance and investor relations
- Stakeholder communication best practices

**Python Tools:**
- `strategy_analyzer.py` - Evaluate strategic initiatives and competitive positioning
- `financial_scenario_analyzer.py` - Model financial scenarios and business outcomes

**Core Workflows:**
1. Strategic planning and initiative evaluation
2. Financial scenario modeling
3. Board and investor communication
4. Organizational culture development

**Use When:**
- Making strategic decisions (market expansion, product pivots, fundraising)
- Preparing board presentations
- Modeling business scenarios
- Building organizational culture
- Managing stakeholder relationships

**Learn More:** [ceo-advisor/SKILL.md](skills/ceo-advisor/SKILL.md)

---

### 2. CTO Advisor
**Status:** ✅ Production Ready | **Version:** 1.0

**Purpose:** Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

**Key Capabilities:**
- Technical debt assessment and management
- Engineering team scaling and structure planning
- Technology evaluation and selection frameworks
- Architecture decision documentation (ADRs)
- Engineering metrics (DORA metrics, velocity, quality)
- Build vs. buy analysis

**Python Tools:**
- `tech_debt_analyzer.py` - Quantify and prioritize technical debt
- `team_scaling_calculator.py` - Model engineering team growth and structure

**Core Workflows:**
1. Technical debt assessment and management
2. Engineering team scaling and structure
3. Technology evaluation and selection
4. Architecture decision documentation

**Use When:**
- Managing technical debt
- Scaling engineering teams
- Evaluating new technologies or frameworks
- Making architecture decisions
- Measuring engineering performance

**Learn More:** [cto-advisor/SKILL.md](skills/cto-advisor/SKILL.md)

---

## 🚀 Quick Start Guide

### For CEOs

1. **Install CEO Advisor:**
   ```bash
   npx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor/skills/ceo-advisor
   ```

2. **Evaluate Strategic Initiative:**
   ```bash
   python ceo-advisor/scripts/strategy_analyzer.py strategy-doc.md
   ```

3. **Model Financial Scenarios:**
   ```bash
   python ceo-advisor/scripts/financial_scenario_analyzer.py scenarios.yaml
   ```

4. **Prepare for Board Meeting:**
   - Use frameworks in `references/board_governance_investor_relations.md`
   - Apply decision framework from `references/executive_decision_framework.md`
   - Use templates from `assets/`

### For CTOs

1. **Install CTO Advisor:**
   ```bash
   npx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor/skills/cto-advisor
   ```

2. **Analyze Technical Debt:**
   ```bash
   python cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebase
   ```

3. **Plan Team Scaling:**
   ```bash
   python cto-advisor/scripts/team_scaling_calculator.py --current-size 10 --target-size 50
   ```

4. **Document Architecture Decisions:**
   - Use ADR templates from `references/architecture_decision_records.md`
   - Apply technology evaluation framework
   - Track engineering metrics

---

## 🔄 Common Workflows

### Workflow 1: Strategic Decision Making (CEO)

```
1. Problem Definition → CEO Advisor
   - Define decision context
   - Identify stakeholders
   - Clarify success criteria

2. Strategic Analysis → CEO Advisor
   - Strategy analyzer tool
   - Competitive positioning
   - Market opportunity assessment

3. Financial Modeling → CEO Advisor
   - Scenario analyzer tool
   - Revenue projections
   - Cost-benefit analysis

4. Decision Framework → CEO Advisor
   - Apply structured methodology
   - Risk assessment
   - Go/No-go recommendation

5. Stakeholder Communication → CEO Advisor
   - Board presentation
   - Investor update
   - Team announcement
```

### Workflow 2: Technology Evaluation (CTO)

```
1. Technology Assessment → CTO Advisor
   - Requirements gathering
   - Technology landscape scan
   - Evaluation criteria definition

2. Build vs. Buy Analysis → CTO Advisor
   - TCO calculation
   - Risk analysis
   - Timeline estimation

3. Architecture Impact → CTO Advisor
   - System design implications
   - Integration complexity
   - Migration path

4. Decision Documentation → CTO Advisor
   - ADR creation
   - Technical specification
   - Implementation roadmap

5. Team Communication → CTO Advisor
   - Engineering announcement
   - Training plan
   - Implementation kickoff
```

### Workflow 3: Engineering Team Scaling (CTO)

```
1. Current State Assessment → CTO Advisor
   - Team structure analysis
   - Velocity and quality metrics
   - Bottleneck identification

2. Growth Modeling → CTO Advisor
   - Team scaling calculator
   - Organizational design
   - Role definition

3. Hiring Plan → CTO Advisor
   - Hiring timeline
   - Budget requirements
   - Onboarding strategy

4. Process Evolution → CTO Advisor
   - Updated workflows
   - Team communication
   - Quality gates

5. Implementation → CTO Advisor
   - Gradual rollout
   - Metrics tracking
   - Continuous adjustment
```

### Workflow 4: Board Preparation (CEO)

```
1. Content Preparation → CEO Advisor
   - Financial summary
   - Strategic updates
   - Key metrics dashboard

2. Presentation Design → CEO Advisor
   - Board governance frameworks
   - Slide deck structure
   - Data visualization

3. Q&A Preparation → CEO Advisor
   - Anticipated questions
   - Risk mitigation answers
   - Strategic rationale

4. Rehearsal → CEO Advisor
   - Timing practice
   - Narrative flow
   - Supporting materials
```

---

## 📊 Success Metrics

### CEO Advisor Impact

**Strategic Clarity:**
- 40% improvement in decision-making speed
- 50% reduction in strategic initiative failures
- 60% improvement in stakeholder alignment

**Financial Performance:**
- 30% better accuracy in financial projections
- 45% improvement in scenario planning effectiveness
- 25% reduction in unexpected costs

**Board & Investor Relations:**
- 50% reduction in board presentation preparation time
- 70% improvement in board feedback quality
- 40% better investor communication clarity

### CTO Advisor Impact

**Technical Debt Management:**
- 60% improvement in tech debt visibility
- 40% reduction in critical tech debt items
- 50% better resource allocation for debt reduction

**Team Scaling:**
- 45% faster time-to-productivity for new hires
- 35% reduction in team scaling mistakes
- 50% improvement in organizational design clarity

**Technology Decisions:**
- 70% reduction in technology evaluation time
- 55% improvement in build vs. buy accuracy
- 40% better architecture decision documentation

---

## 🔗 Integration with Other Teams

**CEO ↔ Product:**
- Strategic vision → Product roadmap
- Market insights → Product strategy
- Customer feedback → Product prioritization

**CEO ↔ CTO:**
- Technology strategy → Business strategy
- Engineering capacity → Business planning
- Technical decisions → Strategic initiatives

**CTO ↔ Engineering:**
- Architecture decisions → Implementation
- Tech debt priorities → Sprint planning
- Team structure → Engineering delivery

**CTO ↔ Product:**
- Technical feasibility → Product planning
- Platform capabilities → Product features
- Engineering metrics → Product velocity

---

## 📚 Additional Resources

- **CLAUDE.md:** [c-level-advisor/CLAUDE.md](CLAUDE.md) - Claude Code specific guidance (if exists)
- **Main Documentation:** [../CLAUDE.md](../CLAUDE.md)
- **Installation Guide:** [../INSTALLATION.md](../INSTALLATION.md)

---

**Last Updated:** January 2026
**Skills Deployed:** 66/66 C-Level advisory skills production-ready
**Total Tools:** 6 Python analysis tools (strategy, finance, tech debt, team scaling)

---

## File: custom-gpt/README.md

# Custom GPTs — Agent Skills for ChatGPT

> **6 Custom GPTs** built on the Agent Skills library. Free to use in ChatGPT — no setup, no API keys, no installation.

These GPTs bring production-grade expertise from the [Agent Skills](https://github.com/alirezarezvani/claude-skills) repository directly into ChatGPT. Each one packages domain-specific workflows, frameworks, and decision tools into a conversational interface.

---

## Available GPTs

### Solo Founder

**Best for:** Technical founders building products alone. Covers architecture decisions, go-to-market, hiring, fundraising, and time management — all through the lens of a solo operator.

**What it does:**
- Product roadmap prioritization for one-person teams
- Technical architecture decisions with build-vs-buy analysis
- Go-to-market planning with limited budget and time
- Fundraising prep and pitch deck review

[**→ Open in ChatGPT**](https://chatgpt.com/g/g-69b3157947e8819180c8e4ac609d5041-solo-founder)

---

### SEO Audit Expert

**Best for:** Developers, marketers, and founders who want actionable SEO improvements. Not generic advice — structured audit workflows with specific fixes.

**What it does:**
- Full technical SEO audit (Core Web Vitals, crawlability, indexing)
- On-page optimization with keyword placement strategy
- Content gap analysis against competitors
- Site architecture and internal linking review

[**→ Open in ChatGPT**](https://chatgpt.com/g/g-69b3b0a690ac819189c127be7d1deb03-seo-audit-expert)

---

### Content Strategist

**Best for:** Content teams, solo creators, and marketers planning what to write and how to distribute it. Strategy first, writing second.

**What it does:**
- Topic cluster planning with pillar and spoke content
- Content calendar with publishing cadence
- Audience research and persona mapping
- Distribution strategy across channels (SEO, social, email, community)

[**→ Open in ChatGPT**](https://chatgpt.com/g/g-69b3afc41c608191a6ee30941c5bdddb-content-strategist)

---

### Product Manager Toolkit

**Best for:** Product managers and founders who need structured frameworks for product decisions, user research, and sprint planning.

**What it does:**
- User story writing with acceptance criteria
- PRD generation with clear scope and success metrics
- Sprint planning and backlog prioritization
- Feature impact scoring (RICE, ICE, weighted scoring)
- Competitive analysis with positioning framework

[**→ Open in ChatGPT**](https://chatgpt.com/g/g-69b32caad22c81919522ca21062adec8-product-manager-toolkit)

---

### Conversion Copywriter

**Best for:** Anyone writing copy that needs to convert — landing pages, pricing pages, email sequences, CTAs, headlines. Not generic writing — conversion-focused frameworks.

**What it does:**
- Landing page copy with headline variants and CTA optimization
- Email sequence design (welcome, nurture, re-engagement)
- Pricing page copy with objection handling
- A/B test copy variants with rationale for each

[**→ Open in ChatGPT**](https://chatgpt.com/g/g-69b327d9545c8191b3711b75b4a88a94-conversion-copywriter)

---

### CTO Advisor

**Best for:** CTOs, VP Engineering, and technical leaders making architecture, team, and technology decisions. Frameworks for the hard calls.

**What it does:**
- Tech debt assessment with prioritization matrix
- Team scaling models (when to hire, what roles, how to structure)
- Architecture Decision Records (ADRs) with trade-off analysis
- Technology evaluation frameworks (build vs buy, vendor selection)
- Engineering metrics and DORA benchmarks

[**→ Open in ChatGPT**](https://chatgpt.com/g/g-69b32673238c8191ba3a0d1627f0e8a7-cto-advisor)

---

## How to Use

1. Click any **"Open in ChatGPT"** link above
2. Start a conversation — no setup needed
3. The GPT uses structured workflows from the Agent Skills library

**Works with:** ChatGPT Plus, Pro, and Team plans.

## Want More?

These GPTs are built from the [Agent Skills](https://github.com/alirezarezvani/claude-skills) open-source library — **177 skills, 16 agents, 3 personas** for AI coding tools.

If you use Claude Code, Codex, Gemini CLI, Cursor, or other AI coding tools, you can install the full skill library directly:

```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills && ./scripts/install.sh
```

The GPTs above are a small sample. The full library covers engineering, product, marketing, compliance, finance, healthcare, and more.

---

## Links

- **Repository:** [github.com/alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)
- **Documentation:** [alirezarezvani.github.io/claude-skills](https://alirezarezvani.github.io/claude-skills/)
- **Skills Browse:** [Full skill catalog](https://alirezarezvani.github.io/claude-skills/skills/)

## License

The GPT configurations are proprietary. The underlying Agent Skills library is [MIT licensed](https://github.com/alirezarezvani/claude-skills/blob/main/LICENSE).

---

## File: docs/commands/code-to-prd.md

---
title: "/code-to-prd — Slash Command for AI Coding Agents"
---

# /code-to-prd


:material-console: Slash Command
:material-github: [Source](https://github.com/alirezarezvani/claude-skills/tree/main/commands/code-to-prd.md)



Reverse-engineer a frontend codebase into a complete Product Requirements Document.

## Usage

```bash
/code-to-prd                    # Analyze current project
/code-to-prd ./src              # Analyze specific directory
/code-to-prd /path/to/project   # Analyze external project
```

## What It Does

1. **Scan** — Run `codebase_analyzer.py` to detect framework, routes, APIs, enums, and project structure
2. **Scaffold** — Run `prd_scaffolder.py` to create `prd/` directory with README.md, per-page stubs, and appendix files
3. **Analyze** — Walk through each page following the Phase 2 workflow: fields, interactions, API dependencies, page relationships
4. **Generate** — Produce the final PRD with all pages, enum dictionary, API inventory, and page relationship map

## Steps

### Step 1: Analyze

Determine the project path (default: current directory). Run the frontend analyzer:

```bash
python3 {skill_path}/scripts/codebase_analyzer.py {project_path} -o .code-to-prd-analysis.json
```

Display a summary of findings: framework, page count, API count, enum count.

### Step 2: Scaffold

Generate the PRD directory skeleton:

```bash
python3 {skill_path}/scripts/prd_scaffolder.py .code-to-prd-analysis.json -o prd/
```

### Step 3: Fill

For each page in the inventory, follow the SKILL.md Phase 2 workflow:
- Read the page's component files
- Document fields, interactions, API dependencies, page relationships
- Fill in the corresponding `prd/pages/` stub

Work in batches of 3-5 pages for large projects (>15 pages). Ask the user to confirm after each batch.

### Step 4: Finalize

Complete the appendix files:
- `prd/appendix/enum-dictionary.md` — all enums and status codes found
- `prd/appendix/api-inventory.md` — consolidated API reference
- `prd/appendix/page-relationships.md` — navigation and data coupling map

Clean up the temporary analysis file:
```bash
rm .code-to-prd-analysis.json
```

## Output

A `prd/` directory containing:
- `README.md` — system overview, module map, page inventory
- `pages/*.md` — one file per page with fields, interactions, APIs
- `appendix/*.md` — enum dictionary, API inventory, page relationships

## Skill Reference

- `product-team/code-to-prd/skills/code-to-prd/SKILL.md`
- `product-team/code-to-prd/skills/code-to-prd/scripts/codebase_analyzer.py`
- `product-team/code-to-prd/skills/code-to-prd/scripts/prd_scaffolder.py`
- `product-team/code-to-prd/skills/code-to-prd/references/prd-quality-checklist.md`

---

## File: docs/commands/competitive-matrix.md

---
title: "/competitive-matrix — Slash Command for AI Coding Agents"
---

# /competitive-matrix


:material-console: Slash Command
:material-github: [Source](https://github.com/alirezarezvani/claude-skills/tree/main/commands/competitive-matrix.md)



Build competitive matrices with weighted scoring, gap analysis, and market positioning insights.

## Usage

```
/competitive-matrix analyze <competitors.json>                    Full analysis
/competitive-matrix analyze <competitors.json> --weights pricing=2,ux=1.5    Custom weights
```

## Input Format

```json
{
  "your_product": { "name": "MyApp", "scores": {"ux": 8, "pricing": 7, "features": 9} },
  "competitors": [
    { "name": "Competitor A", "scores": {"ux": 7, "pricing": 9, "features": 6} }
  ],
  "dimensions": ["ux", "pricing", "features"]
}
```

## Examples

```
/competitive-matrix analyze competitors.json
/competitive-matrix analyze competitors.json --format json --output matrix.json
```

## Scripts
- `product-team/skills/competitive-teardown/scripts/competitive_matrix_builder.py` — Matrix builder

## Skill Reference
→ `product-team/skills/competitive-teardown/SKILL.md`

---

## File: docs/commands/financial-health.md

---
title: "/financial-health — Slash Command for AI Coding Agents"
---

# /financial-health


:material-console: Slash Command
:material-github: [Source](https://github.com/alirezarezvani/claude-skills/tree/main/commands/financial-health.md)



Analyze financial statements, build valuation models, assess budget variances, and construct forecasts.

## Usage

```
/financial-health ratios <financial_data.json> [--format json|text]
/financial-health dcf <valuation_data.json> [--format json|text]
/financial-health budget  [--format json|text]
/financial-health forecast <forecast_data.json> [--format json|text]
```

## Examples

```
/financial-health ratios quarterly_financials.json --format json
/financial-health dcf acme_valuation.json
/financial-health budget q1_budget.json --format json
/financial-health forecast revenue_history.json
```

## Scripts
- `finance/skills/financial-analyst/scripts/ratio_calculator.py` — Profitability, liquidity, leverage, efficiency, valuation ratios
- `finance/skills/financial-analyst/scripts/dcf_valuation.py` — DCF enterprise and equity valuation with sensitivity analysis
- `finance/skills/financial-analyst/scripts/budget_variance_analyzer.py` — Actual vs budget vs prior year variance analysis
- `finance/skills/financial-analyst/scripts/forecast_builder.py` — Driver-based revenue forecasting with scenario modeling

## Skill Reference
→ `finance/skills/financial-analyst/SKILL.md`

## Related Commands
- `/saas-health` — SaaS-specific metrics (ARR, MRR, churn, CAC, LTV, Quick Ratio)

---

## File: docs/commands/focused-fix.md

---
title: "/focused-fix — Slash Command for AI Coding Agents"
---

# /focused-fix


:material-console: Slash Command
:material-github: [Source](https://github.com/alirezarezvani/claude-skills/tree/main/commands/focused-fix.md)



Systematically repair an entire feature or module using the 5-phase protocol. Target: `$ARGUMENTS` (a feature path or module name).

If `$ARGUMENTS` is empty, ask the user which feature/module to fix.

## Protocol — Execute ALL 5 Phases IN ORDER

### Phase 1: SCOPE — Map the Feature Boundary

1. Identify the primary folder/files for the target feature
2. Read EVERY file in that folder — understand its purpose
3. Create a feature manifest:

```
FEATURE SCOPE:
  Primary path: 
  Entry points: [files imported by other parts of the app]
  Internal files: [files only used within this feature]
  Total files: N
```

### Phase 2: TRACE — Map All Dependencies

**INBOUND** (what this feature imports):
- For every import statement, trace to source, verify it exists and is exported
- Check env vars, config files, DB models, API endpoints, third-party packages

**OUTBOUND** (what imports this feature):
- Search entire codebase for imports from this feature
- Verify consumers use correct API/interface

Output a dependency map with inbound, outbound, env vars, and config files.

### Phase 3: DIAGNOSE — Find Every Issue

Run ALL diagnostic checks:

- **Code**: imports resolve, no circular deps, types consistent, error handling, TODO/FIXME
- **Runtime**: env vars set, migrations current, API shapes correct
- **Tests**: run ALL related tests, record failures, check coverage
- **Logs**: check git log for recent changes, search error logs
- **Config**: validate config files, check dev/prod mismatches

For each issue found:
- Confirm root cause with evidence before adding to fix list
- Assign risk: HIGH (public API, auth, >3 callers) / MED (internal with tests) / LOW (leaf module)

Output a diagnosis report with issues grouped by severity.

### Phase 4: FIX — Repair Systematically

Fix in this EXACT order:
1. **Dependencies** — broken imports, missing packages
2. **Types** — type mismatches at boundaries
3. **Logic** — business logic bugs
4. **Tests** — fix or create tests for each fix
5. **Integration** — verify end-to-end with consumers

Rules:
- Fix ONE issue at a time, run related test after each
- If a fix breaks something else → go back to DIAGNOSE
- Fix HIGH before MED before LOW
- **3-Strike Rule**: If 3+ fixes create NEW issues, STOP. Tell the user the architecture may need rethinking, not patching.

### Phase 5: VERIFY — Confirm Everything Works

1. Run ALL tests in the feature folder
2. Run ALL tests in files that import from this feature
3. Run full test suite if available
4. Summarize all changes made

Output a completion report with files changed, fixes applied, test results, and consumers verified.

## Iron Law

```
NO FIXES WITHOUT COMPLETING SCOPE → TRACE → DIAGNOSE FIRST
```

If you haven't finished Phase 3, you cannot propose fixes.

## Related Skills

- `engineering/focused-fix` — Full SKILL.md with detailed checklists, output templates, and anti-patterns
- `superpowers:systematic-debugging` — For individual complex bugs found during Phase 3

---

## File: docs/commands/google-workspace.md

---
title: "/google-workspace — Slash Command for AI Coding Agents"
---

# /google-workspace


:material-console: Slash Command
:material-github: [Source](https://github.com/alirezarezvani/claude-skills/tree/main/commands/google-workspace.md)



Google Workspace CLI administration via the `gws` CLI. Run setup diagnostics, security audits, browse and execute recipes, and analyze command output.

## Usage

```
/google-workspace setup [--json]
/google-workspace audit [--services gmail,drive,calendar] [--json]
/google-workspace recipe list [--persona <role>] [--json]
/google-workspace recipe search <keyword> [--json]
/google-workspace recipe run <name> [--dry-run]
/google-workspace recipe describe <name>
/google-workspace analyze [--filter <field=value>] [--group-by <field>] [--stats <field>] [--format table|csv|json]
```

## Examples

```
/google-workspace setup
/google-workspace audit --services gmail,drive --json
/google-workspace recipe list --persona pm
/google-workspace recipe search "email"
/google-workspace recipe run standup-report --dry-run
/google-workspace recipe describe morning-briefing
/google-workspace analyze --filter "mimeType=pdf" --select "name,size" --format table
```

## Scripts

- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py` — Pre-flight diagnostics
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py` — Auth setup guide
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py` — Recipe catalog & runner
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py` — Security audit
- `engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py` — JSON/NDJSON analyzer

## Subcommands

### setup
Run pre-flight diagnostics and auth validation.
```bash
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.py [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.py --validate [--json]
```

### audit
Run security and configuration audit.
```bash
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.py [--services gmail,drive,calendar] [--json]
```

### recipe
Browse, search, and execute the 43 built-in gws recipes.
```bash
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --list [--persona <role>] [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --search <keyword> [--json]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --describe <name>
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.py --run <name> [--dry-run]
```

### analyze
Parse, filter, and aggregate JSON output from any gws command.
```bash
gws <command> --json | python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py [options]
python3 engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.py --demo --format table
```

## Skill Reference
-> `engineering-team/google-workspace-cli/skills/google-workspace-cli/SKILL.md`

## Related Commands
- No direct dependencies (self-contained Google Workspace skill)