claude-skills Documentation

345 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 330+ skills, customizable references, scripts)for Claude Code, Codex,...

RAW Doc

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.







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 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")
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 โ€” 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/
๐ŸŽฏ 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/
๐Ÿ“ฃ 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/
๐Ÿš€ 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/
๐ŸŽจ Marketing (top-level) 1 landing โ€” single-file HTML landing-page generator (4 design styles, GSAP patterns, brand palette validator) 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 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/
๐Ÿ“‹ Project Management 9 Senior PM, scrum master, Jira, Confluence, Atlassian admin, templates + bundled Atlassian Remote MCP 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/
๐Ÿ›ก๏ธ Compliance OS 9 Compliance operating system โ€” controls, evidence, audit-readiness workflows 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/
๐Ÿ“ˆ Business & Growth 5 Customer success, sales engineer, revenue ops, contracts & proposals, BizDev toolkit business-growth/
๐Ÿญ Business Operations 7 Orchestrator + process-mapper, vendor-management, capacity-planner, internal-comms, knowledge-ops, procurement-optimizer business-operations/
๐Ÿค Commercial 8 Orchestrator + pricing-strategist, deal-desk, partnerships-architect, channel-economics, commercial-policy, rfp-responder, commercial-forecaster commercial/
๐Ÿ’ฐ Finance 4 Financial analyst (DCF, budgeting, forecasting), SaaS metrics coach, business investment advisor 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) 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/

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 Engineering + Strategy Architecture decisions, tech stack selection, team building, technical due diligence
Growth Marketer Marketing + Growth Content-led growth, launch strategy, channel optimization, bootstrapped marketing
Solo Founder 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/ for details. Create your own with 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

text
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 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

text
Using the senior-architect skill, review our microservices architecture
and identify the top 3 scalability risks.

Content Creation

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

Compliance Audit

text
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

Project Description
Claude Code Skills & Agents Factory Methodology for building skills at scale
Claude Code Tresor Productivity toolkit with 60+ prompt templates
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 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 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 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 for a step-by-step guide.


Contributing

We welcome contributions! See 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 for details.


Star History

Star History Chart


Built by Alireza Rezvani ยท Medium ยท Twitter


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 ๐Ÿ—๏ธ Engineering + Strategy Technical co-founders, architecture decisions, team building
Growth Marketer ๐Ÿš€ Marketing + Growth Bootstrapped founders, content-led growth, launches
Solo Founder ๐Ÿฆ„ 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 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

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 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


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


๐Ÿš€ 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)

text
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)

text
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)

text
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)

text
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


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 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


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


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


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


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


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


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 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.


License

The GPT configurations are proprietary. The underlying Agent Skills library is MIT licensed.


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

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

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

Usage

text
/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

text
/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

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

Usage

text
/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

text
/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

  • /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

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:
text
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

text
NO FIXES WITHOUT COMPLETING SCOPE โ†’ TRACE โ†’ DIAGNOSE FIRST

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

  • 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

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

Usage

text
/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

text
/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

  • No direct dependencies (self-contained Google Workspace skill)