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)
# 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)
# 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 skillOpenAI Codex
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex
# Or: git clone + ./scripts/codex-install.shOpenClaw
bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)Manual Installation
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:
# 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 346Each 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:
# Claude Code
cp agents/personas/startup-cto.md ~/.claude/agents/
# Any tool
./scripts/convert.sh --tool cursor # Converts personas tooSee 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
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 iterateSee 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:
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 scriptsengineering/mcp-server-builderโ OpenAPI -> MCP scaffold + manifest validatorengineering/changelog-generatorโ release note generator + conventional commit linterengineering/ci-cd-pipeline-builderโ stack detector + pipeline generatormarketing-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):
# 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 tsxRelated Projects
| 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
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
cp agents/personas/startup-cto.md ~/.claude/agents/
# Then: "Activate startup-cto mode"Cursor
./scripts/convert.sh --tool cursor
# Personas convert to .cursor/rules/*.mdcAny Supported Tool
./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:
---
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
Quick Install (Recommended)
Install all C-Level advisory skills with one command:
# 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 cursorInstall Individual Skills
# 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-advisorSupported 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 positioningfinancial_scenario_analyzer.py- Model financial scenarios and business outcomes
Core Workflows:
- Strategic planning and initiative evaluation
- Financial scenario modeling
- Board and investor communication
- 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 debtteam_scaling_calculator.py- Model engineering team growth and structure
Core Workflows:
- Technical debt assessment and management
- Engineering team scaling and structure
- Technology evaluation and selection
- 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
Install CEO Advisor:
bashnpx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor/skills/ceo-advisorEvaluate Strategic Initiative:
bashpython ceo-advisor/scripts/strategy_analyzer.py strategy-doc.mdModel Financial Scenarios:
bashpython ceo-advisor/scripts/financial_scenario_analyzer.py scenarios.yamlPrepare 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/
- Use frameworks in
For CTOs
Install CTO Advisor:
bashnpx ai-agent-skills install alirezarezvani/claude-skills/c-level-advisor/skills/cto-advisorAnalyze Technical Debt:
bashpython cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebasePlan Team Scaling:
bashpython cto-advisor/scripts/team_scaling_calculator.py --current-size 10 --target-size 50Document Architecture Decisions:
- Use ADR templates from
references/architecture_decision_records.md - Apply technology evaluation framework
- Track engineering metrics
- Use ADR templates from
๐ 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 announcementWorkflow 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 kickoffWorkflow 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 adjustmentWorkflow 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 Code specific guidance (if exists)
- Main Documentation: ../CLAUDE.md
- Installation Guide: ../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 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
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
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)
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
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
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
How to Use
- Click any "Open in ChatGPT" link above
- Start a conversation โ no setup needed
- 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:
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills && ./scripts/install.shThe 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
- Documentation: alirezarezvani.github.io/claude-skills
- Skills Browse: Full skill catalog
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
/code-to-prd # Analyze current project
/code-to-prd ./src # Analyze specific directory
/code-to-prd /path/to/project # Analyze external projectWhat It Does
- Scan โ Run
codebase_analyzer.pyto detect framework, routes, APIs, enums, and project structure - Scaffold โ Run
prd_scaffolder.pyto createprd/directory with README.md, per-page stubs, and appendix files - Analyze โ Walk through each page following the Phase 2 workflow: fields, interactions, API dependencies, page relationships
- 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:
python3 {skill_path}/scripts/codebase_analyzer.py {project_path} -o .code-to-prd-analysis.jsonDisplay a summary of findings: framework, page count, API count, enum count.
Step 2: Scaffold
Generate the PRD directory skeleton:
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 foundprd/appendix/api-inventory.mdโ consolidated API referenceprd/appendix/page-relationships.mdโ navigation and data coupling map
Clean up the temporary analysis file:
rm .code-to-prd-analysis.jsonOutput
A prd/ directory containing:
README.mdโ system overview, module map, page inventorypages/*.mdโ one file per page with fields, interactions, APIsappendix/*.mdโ enum dictionary, API inventory, page relationships
Skill Reference
product-team/code-to-prd/skills/code-to-prd/SKILL.mdproduct-team/code-to-prd/skills/code-to-prd/scripts/codebase_analyzer.pyproduct-team/code-to-prd/skills/code-to-prd/scripts/prd_scaffolder.pyproduct-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
/competitive-matrix analyze <competitors.json> Full analysis
/competitive-matrix analyze <competitors.json> --weights pricing=2,ux=1.5 Custom weightsInput Format
{
"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.jsonScripts
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
/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.jsonScripts
finance/skills/financial-analyst/scripts/ratio_calculator.pyโ Profitability, liquidity, leverage, efficiency, valuation ratiosfinance/skills/financial-analyst/scripts/dcf_valuation.pyโ DCF enterprise and equity valuation with sensitivity analysisfinance/skills/financial-analyst/scripts/budget_variance_analyzer.pyโ Actual vs budget vs prior year variance analysisfinance/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
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
- Identify the primary folder/files for the target feature
- Read EVERY file in that folder โ understand its purpose
- 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: NPhase 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:
- Dependencies โ broken imports, missing packages
- Types โ type mismatches at boundaries
- Logic โ business logic bugs
- Tests โ fix or create tests for each fix
- 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
- Run ALL tests in the feature folder
- Run ALL tests in files that import from this feature
- Run full test suite if available
- 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 FIRSTIf 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-patternssuperpowers: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
/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 tableScripts
engineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_doctor.pyโ Pre-flight diagnosticsengineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/auth_setup_guide.pyโ Auth setup guideengineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/gws_recipe_runner.pyโ Recipe catalog & runnerengineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/workspace_audit.pyโ Security auditengineering-team/google-workspace-cli/skills/google-workspace-cli/scripts/output_analyzer.pyโ JSON/NDJSON analyzer
Subcommands
setup
Run pre-flight diagnostics and auth validation.
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.
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.
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.
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 tableSkill Reference
-> engineering-team/google-workspace-cli/skills/google-workspace-cli/SKILL.md
Related Commands
- No direct dependencies (self-contained Google Workspace skill)