Merge pull request #339 from alirezarezvani/feature/readme-messaging

2026-03-12 20:10:32 +01:00
parent a27edf56fa bd70015f60
commit 0d091c9cef
14 changed files with 663 additions and 60 deletions
--- a/README.md
+++ b/README.md
@@ -1,25 +1,43 @@
 # Claude Code Skills & Plugins

-**177 production-ready skills and plugins for 11 AI coding tools** — reusable expertise bundles that transform AI coding agents into specialized professionals across engineering, product, marketing, compliance, and more.
+**177 production-ready skills, 16 agents, 3 personas, and an orchestration protocol for 11 AI coding tools.**
+
+Reusable expertise packages that give AI coding agents domain knowledge they don't have out of the box — from architecture and security to marketing, compliance, and C-level advisory.

 **Works with:** Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Cursor · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity

 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
 [![Skills](https://img.shields.io/badge/Skills-177-brightgreen?style=for-the-badge)](#skills-overview)
 [![Agents](https://img.shields.io/badge/Agents-16-blue?style=for-the-badge)](#agents)
+[![Personas](https://img.shields.io/badge/Personas-3-purple?style=for-the-badge)](#personas)
 [![Commands](https://img.shields.io/badge/Commands-17-orange?style=for-the-badge)](#commands)
 [![Stars](https://img.shields.io/github/stars/alirezarezvani/claude-skills?style=for-the-badge)](https://github.com/alirezarezvani/claude-skills/stargazers)
 [![SkillCheck Validated](https://img.shields.io/badge/SkillCheck-Validated-4c1?style=for-the-badge)](https://getskillcheck.com)

-> ⭐ **2,500+ GitHub stars** — the most comprehensive open-source skill library for AI coding agents.
+> **4,400+ GitHub stars** — the most comprehensive open-source skill library for AI coding agents.

 ---

-## What Are Claude Code Skills?
+## What Are Skills?

-Skills are modular instruction packages (plugins) that give AI coding agents domain expertise they don't have out of the box. Each skill includes a `SKILL.md` (instructions + workflows), Python CLI tools, and reference documentation — everything the agent needs to perform like a specialist.
+Skills are modular instruction packages that give AI coding agents domain expertise they don't have out of the box. Each skill includes:

-**One repo, eleven platforms:** Works natively with Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. All 254 Python tools are stdlib-only and verified working.
+- **SKILL.md** — structured instructions, workflows, and decision frameworks
+- **Python tools** — 254 CLI scripts (all stdlib-only, zero pip installs)
+- **Reference docs** — templates, checklists, and domain-specific knowledge
+
+**One repo, eleven platforms.** Works natively with Claude Code, and converts to 10 other tools via `scripts/convert.sh`. All 254 Python tools run anywhere Python runs.
+
+### Skills vs Agents vs Personas
+
+| | Skills | Agents | Personas |
+|---|---|---|---|
+| **Purpose** | How to execute a task | What task to do | Who is thinking |
+| **Scope** | Single domain | Single domain | Cross-domain |
+| **Voice** | Neutral | Professional | Personality-driven |
+| **Example** | "Follow these steps for SEO" | "Run a security audit" | "Think like a startup CTO" |
+
+All three work together. See [Orchestration](#orchestration) for how to combine them.

 ---

@@ -145,7 +163,54 @@ See [integrations/](integrations/) for tool-specific documentation and pre-gener

 ---

-## ⚡ POWERFUL Tier
+## Personas
+
+Pre-configured agent identities with curated skill loadouts, workflows, and distinct communication styles. Personas go beyond "use these skills" — they define how an agent thinks, prioritizes, and communicates.
+
+| Persona | Domain | Best For |
+|---------|--------|----------|
+| [**Startup CTO**](agents/personas/startup-cto.md) | Engineering + Strategy | Architecture decisions, tech stack selection, team building, technical due diligence |
+| [**Growth Marketer**](agents/personas/growth-marketer.md) | Marketing + Growth | Content-led growth, launch strategy, channel optimization, bootstrapped marketing |
+| [**Solo Founder**](agents/personas/solo-founder.md) | Cross-domain | One-person startups, side projects, MVP building, wearing all hats |
+
+**Usage:**
+```bash
+# Claude Code
+cp agents/personas/startup-cto.md ~/.claude/agents/
+
+# Any tool
+./scripts/convert.sh --tool cursor  # Converts personas too
+```
+
+See [agents/personas/](agents/personas/) for details. Create your own with [TEMPLATE.md](agents/personas/TEMPLATE.md).
+
+---
+
+## Orchestration
+
+A lightweight protocol for coordinating personas, skills, and agents on work that crosses domain boundaries. No framework required.
+
+**Four patterns:**
+
+| Pattern | What | When |
+|---------|------|------|
+| **Solo Sprint** | Switch personas across project phases | Side projects, MVPs, solo founders |
+| **Domain Deep-Dive** | One persona + multiple stacked skills | Architecture reviews, compliance audits |
+| **Multi-Agent Handoff** | Personas review each other's output | High-stakes decisions, launch readiness |
+| **Skill Chain** | Sequential skills, no persona needed | Content pipelines, repeatable checklists |
+
+**Example: 6-week product launch**
+```
+Week 1-2: startup-cto + aws-solution-architect + senior-frontend → Build
+Week 3-4: growth-marketer + launch-strategy + copywriting + seo-audit → Prepare
+Week 5-6: solo-founder + email-sequence + analytics-tracking → Ship and iterate
+```
+
+See [orchestration/ORCHESTRATION.md](orchestration/ORCHESTRATION.md) for the full protocol and examples.
+
+---
+
+## POWERFUL Tier

 25 advanced skills with deep, production-grade capabilities:

@@ -277,7 +342,7 @@ Yes. Skills work natively with 11 tools: Claude Code, OpenAI Codex, Gemini CLI,
 No. We follow semantic versioning and maintain backward compatibility within patch releases. Existing script arguments, plugin source paths, and SKILL.md structures are never changed in patch versions. See the [CHANGELOG](CHANGELOG.md) for details on each release.

 **Are the Python tools dependency-free?**
-Yes. All 245 Python CLI tools use the standard library only — zero pip installs required. Every script is verified to run with `--help`.
+Yes. All 254 Python CLI tools use the standard library only — zero pip installs required. Every script is verified to run with `--help`.

 **How do I create my own Claude Code skill?**
 Each skill is a folder with a `SKILL.md` (frontmatter + instructions), optional `scripts/`, `references/`, and `assets/`. See the [Skills & Agents Factory](https://github.com/alirezarezvani/claude-code-skills-agents-factory) for a step-by-step guide.
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -1,6 +1,6 @@
 ---
 title: Getting Started
-description: "How to install and use Claude Code skills and plugins for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw."
+description: "How to install and use Claude Code skills and plugins for 11 AI coding tools — Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, and more."
 ---

 # Getting Started
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,6 +1,6 @@
 ---
-title: Claude Code Skills & Plugins
-description: "177 production-ready skills, 19 plugins, 16 agents, and 17 commands for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw."
+title: Agent Skills for AI Coding Tools
+description: "177 production-ready skills, 16 agents, 3 personas, and an orchestration protocol for 11 AI coding tools — Claude Code, OpenAI Codex, Gemini CLI, Cursor, Aider, Windsurf, and more."
 hide:
  - toc
  - edit
@@ -12,50 +12,106 @@ hide:

 <div class="hero" markdown>

-# Claude Code Skills
+# Agent Skills

-177 production-ready skills that transform AI coding agents into specialized professionals.
+177 production-ready skills, 16 agents, 3 personas, and an orchestration protocol for AI coding tools.
 { .hero-subtitle }

-**Claude Code** | **OpenAI Codex** | **Gemini CLI** | **OpenClaw** | **Cursor** | **Aider** | **Windsurf** | **Kilo Code** | **OpenCode** | **Augment** | **Antigravity**
-{ .hero-platforms }
-
 [Get Started](getting-started.md){ .md-button .md-button--primary }
+[Browse Skills](skills/){ .md-button }
 [GitHub :fontawesome-brands-github:](https://github.com/alirezarezvani/claude-skills){ .md-button }

 </div>

+<div class="tools-bar" markdown>
+
+<p class="tools-label">Works with</p>
+
+<div class="tools-grid">
+  <a href="getting-started/#claude-code" class="tool-badge tool-claude">Claude Code</a>
+  <a href="getting-started/#openai-codex" class="tool-badge tool-codex">OpenAI Codex</a>
+  <a href="getting-started/#gemini-cli" class="tool-badge tool-gemini">Gemini CLI</a>
+  <a href="integrations/#cursor" class="tool-badge tool-cursor">Cursor</a>
+  <a href="integrations/#aider" class="tool-badge tool-aider">Aider</a>
+  <a href="integrations/#windsurf" class="tool-badge tool-windsurf">Windsurf</a>
+  <a href="integrations/#kilo-code" class="tool-badge tool-kilo">Kilo Code</a>
+  <a href="integrations/#opencode" class="tool-badge tool-opencode">OpenCode</a>
+  <a href="integrations/#augment" class="tool-badge tool-augment">Augment</a>
+  <a href="integrations/#antigravity" class="tool-badge tool-antigravity">Antigravity</a>
+  <a href="getting-started/#openclaw" class="tool-badge tool-openclaw">OpenClaw</a>
+</div>
+
+</div>
+
+---
+
+## What's Inside
+
 <div class="grid cards" markdown>

-   :material-counter:{ .lg .middle } **177**
+-   :material-toolbox:{ .lg .middle } **177 Skills**

    ---

-    Production-ready skills
+    Production-ready instruction packages with structured workflows, Python automation tools, and reference documentation across 9 domains.

-   :material-language-python:{ .lg .middle } **254**
+    [:octicons-arrow-right-24: Browse skills](skills/)
+
+-   :material-robot:{ .lg .middle } **16 Agents**

    ---

-    Python CLI tools (stdlib-only, all verified)
+    Multi-skill orchestrators that combine domain expertise for complex tasks — from engineering leads to financial analysts.

-   :material-robot:{ .lg .middle } **16**
+    [:octicons-arrow-right-24: View agents](agents/)
+
+-   :material-account-group:{ .lg .middle } **3 Personas**

    ---

-    [Multi-skill agents](agents/)
+    Role-based identities with curated skill loadouts, decision frameworks, and distinct communication styles.

-   :material-puzzle-outline:{ .lg .middle } **19**
+    [:octicons-arrow-right-24: Meet personas](personas/)
+
+-   :material-sitemap:{ .lg .middle } **Orchestration**

    ---

-    [Installable plugins](plugins/)
+    A lightweight protocol for coordinating personas, skills, and agents on work that crosses domain boundaries.

-   :material-console:{ .lg .middle } **17**
+    [:octicons-arrow-right-24: Learn patterns](orchestration.md)
+
+-   :material-language-python:{ .lg .middle } **254 Python Tools**

    ---

-    [Slash commands](commands/)
+    CLI scripts that ship with skills — all stdlib-only, zero pip installs, verified working on any platform.
+
+    [:octicons-arrow-right-24: Getting started](getting-started.md)
+
+-   :material-puzzle-outline:{ .lg .middle } **19 Plugins**
+
+    ---
+
+    One-command installable bundles for Claude Code, Codex CLI, Gemini CLI, and OpenClaw.
+
+    [:octicons-arrow-right-24: Plugin marketplace](plugins/)
+
+-   :material-console:{ .lg .middle } **17 Commands**
+
+    ---
+
+    Slash commands for common operations — sprint planning, tech debt analysis, PRDs, OKRs, and more.
+
+    [:octicons-arrow-right-24: View commands](commands/)
+
+-   :material-swap-horizontal:{ .lg .middle } **11 Tool Support**
+
+    ---
+
+    Convert all skills to any supported tool's native format with a single script. No manual work.
+
+    [:octicons-arrow-right-24: Multi-tool setup](integrations.md)

 </div>

@@ -73,7 +129,7 @@ hide:

    [:octicons-arrow-right-24: 24 skills](skills/engineering-team/)

-   :material-lightning-bolt:{ .lg .middle } **Engineering — POWERFUL**
+-   :material-lightning-bolt:{ .lg .middle } **Engineering — Advanced**

    ---

@@ -85,7 +141,7 @@ hide:

    ---

-    Product manager, agile PO, strategist, UX researcher, UI design system, landing pages, SaaS scaffolder, analytics, experiment designer, discovery, roadmap communicator
+    Product manager, agile PO, strategist, UX researcher, UI design system, landing pages, SaaS scaffolder, analytics, experiment designer

    [:octicons-arrow-right-24: 12 skills](skills/product-team/)

@@ -93,7 +149,7 @@ hide:

    ---

-    Content, SEO, CRO, channels, growth, intelligence, sales, X/Twitter — 7 specialist pods with 32 Python tools
+    Content, SEO, CRO, channels, growth, intelligence, sales — 7 specialist pods with 32 Python tools

    [:octicons-arrow-right-24: 43 skills](skills/marketing-skill/)

@@ -133,7 +189,7 @@ hide:

    ---

-    Financial analyst, SaaS metrics coach — DCF valuation, budgeting, forecasting, ratio analysis, ARR/MRR/churn/LTV
+    Financial analyst, SaaS metrics coach — DCF valuation, budgeting, forecasting, ARR/MRR/churn/LTV

    [:octicons-arrow-right-24: 2 skills](skills/finance/)

@@ -141,45 +197,45 @@ hide:

 ---

-## Why Skills?
+## Why Agent Skills?

 <div class="grid cards" markdown>

-   :material-clock-fast:{ .lg .middle } **Zero setup**
+-   :material-clock-fast:{ .lg .middle } **Zero dependencies**

    ---

-    All Python tools use stdlib only. No pip installs, no API keys, no configuration files.
+    All Python tools use stdlib only. No pip installs, no API keys, no configuration files. Works anywhere Python runs.

 -   :material-shield-lock:{ .lg .middle } **Security first**

    ---

-    Built-in security auditor scans any skill for malicious code before you install it.
+    Built-in security auditor scans any skill for malicious code, data exfiltration, and prompt injection before installation.

 -   :material-rocket-launch:{ .lg .middle } **One-command install**

    ---

-    Plugin marketplace lets you install entire skill bundles with a single slash command.
+    Plugin marketplace for Claude Code. Conversion script for 10 other tools. No manual file management.

 -   :material-puzzle:{ .lg .middle } **Self-contained**

    ---

-    Each skill is independent. No cross-dependencies, no conflicts, works in isolation.
+    Each skill is independent. No cross-dependencies, no conflicts. Install one or all — they work in isolation.

 -   :material-devices:{ .lg .middle } **Multi-platform**

    ---

-    Works natively with 11 tools: Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity.
+    Native support for 11 AI coding tools. Write once, convert to any tool's format automatically.

 -   :material-check-decagram:{ .lg .middle } **Production-grade**

    ---

-    Battle-tested workflows, not generic advice. Each skill saves 40%+ time on domain tasks.
+    Structured workflows with validation checkpoints, not generic advice. Each skill covers end-to-end domain processes.

 </div>

@@ -187,14 +243,37 @@ hide:

 ## Quick Install

-```bash
-# Add the marketplace
-/plugin marketplace add alirezarezvani/claude-skills
+=== "Claude Code"

-# Install any skill bundle
-/plugin install engineering-skills@claude-code-skills
-```
+    ```bash
+    # Add the marketplace
+    /plugin marketplace add alirezarezvani/claude-skills
+
+    # Install any skill bundle
+    /plugin install engineering-skills@claude-code-skills
+    ```
+
+=== "OpenAI Codex"
+
+    ```bash
+    npx agent-skills-cli add alirezarezvani/claude-skills --agent codex
+    ```
+
+=== "Gemini CLI"
+
+    ```bash
+    git clone https://github.com/alirezarezvani/claude-skills.git
+    cd claude-skills && ./scripts/gemini-install.sh
+    ```
+
+=== "Cursor / Windsurf / Aider"
+
+    ```bash
+    git clone https://github.com/alirezarezvani/claude-skills.git
+    cd claude-skills
+    ./scripts/convert.sh --tool cursor    # or windsurf, aider
+    ./scripts/install.sh --tool cursor --target /path/to/project
+    ```

 [Full Install Guide](getting-started.md){ .md-button .md-button--primary }
 [Multi-Tool Setup](integrations.md){ .md-button }
-[View on GitHub :fontawesome-brands-github:](https://github.com/alirezarezvani/claude-skills){ .md-button }
--- a/docs/integrations.md
+++ b/docs/integrations.md
@@ -1,6 +1,6 @@
 ---
 title: Multi-Tool Integrations
-description: "Use Claude Code Skills with Cursor, Aider, Kilo Code, Windsurf, OpenCode, Augment, and Antigravity. Convert and install all 156 skills in seconds."
+description: "Use Claude Code Skills with Cursor, Aider, Kilo Code, Windsurf, OpenCode, Augment, and Antigravity. Convert and install skills for 11 AI coding tools in seconds."
 ---

 # Multi-Tool Integrations
--- a/docs/orchestration.md
+++ b/docs/orchestration.md
@@ -0,0 +1,121 @@
+---
+title: "Orchestration"
+description: "A lightweight protocol for coordinating personas, skills, and agents on complex, multi-domain work."
+---
+
+# :material-sitemap: Orchestration
+
+A lightweight protocol for coordinating personas, skills, and agents on work that crosses domain boundaries. No framework required. No dependencies. Just structured prompting.
+
+## Core Concept
+
+Most real work crosses domain boundaries. A product launch needs engineering, marketing, and strategy. An architecture review needs security, cost analysis, and team assessment.
+
+Orchestration connects the right expertise to each phase of work:
+
+- **Personas** define _who_ is thinking (identity, judgment, communication style)
+- **Skills** define _how_ to execute (steps, scripts, templates, references)
+- **Task agents** define _what_ to do (scoped, single-domain execution)
+
+---
+
+## Patterns
+
+### Solo Sprint
+
+One person, one objective, multiple domains. Switch personas as you move through phases.
+
+```
+Week 1: startup-cto + engineering skills → Build
+Week 2: growth-marketer + marketing skills → Prepare launch
+Week 3: solo-founder + business skills → Ship and iterate
+```
+
+Best for: side projects, MVPs, solo founders.
+
+### Domain Deep-Dive
+
+One domain, maximum depth. Single persona, multiple skills stacked.
+
+```
+Persona: startup-cto
+Skills loaded simultaneously:
+  - aws-solution-architect (infrastructure)
+  - senior-security (hardening)
+  - cto-advisor (tech debt assessment)
+
+Task: Full technical audit of existing system
+```
+
+Best for: architecture reviews, compliance audits, technical due diligence.
+
+### Multi-Agent Handoff
+
+Different personas review each other's work.
+
+```
+Step 1: startup-cto designs the architecture
+Step 2: growth-marketer reviews from user/market perspective
+Step 3: solo-founder makes the final trade-off decision
+```
+
+Best for: high-stakes decisions, launch readiness reviews, investor prep.
+
+### Skill Chain
+
+No persona needed. Chain skills sequentially for procedural work.
+
+```
+1. content-strategy → Identify topics and angles
+2. copywriting → Write the content
+3. seo-audit → Optimize for search
+4. analytics-tracking → Set up measurement
+```
+
+Best for: repeatable processes, content pipelines, compliance checklists.
+
+---
+
+## Example: 6-Week Product Launch
+
+| Phase | Weeks | Persona | Skills | Output |
+|-------|-------|---------|--------|--------|
+| Build | 1-2 | startup-cto | aws-solution-architect, senior-frontend | Architecture doc, deployed MVP |
+| Prepare | 3-4 | growth-marketer | launch-strategy, copywriting, seo-audit | Landing page, content calendar |
+| Ship | 5 | solo-founder | email-sequence, analytics-tracking | Launch, tracking verified |
+| Iterate | 6 | solo-founder | form-cro, copy-editing | Conversion improvements, metrics report |
+
+---
+
+## Rules
+
+1. **One persona at a time.** Switching is fine, but don't blend two in the same prompt.
+2. **Skills stack freely.** Load as many as the task needs.
+3. **Personas are optional.** For procedural work, skill chains alone are sufficient.
+4. **Context carries forward.** When switching phases, summarize decisions and artifacts.
+5. **The human decides.** Override any phase, persona, or skill choice.
+
+---
+
+## Quick Reference
+
+**Activate a persona:**
+```
+Load agents/personas/startup-cto.md
+```
+
+**Load a skill:**
+```
+Load engineering/aws-solution-architect/SKILL.md
+```
+
+**Phase handoff:**
+```
+Phase 1 complete.
+Decisions: [list]
+Artifacts: [list]
+Open items: [list]
+Switching to: [persona] + [skills]
+```
+
+[:octicons-arrow-right-24: Full orchestration protocol](https://github.com/alirezarezvani/claude-skills/blob/main/orchestration/ORCHESTRATION.md)
--- a/docs/overrides/main.html
+++ b/docs/overrides/main.html
@@ -17,12 +17,23 @@
 <meta property="og:description" content="{{ page.meta.description or config.site_description }}" />
 <meta property="og:url" content="{{ page.canonical_url }}" />
 <meta property="og:site_name" content="{{ config.site_name }}" />
+<meta property="og:image" content="https://opengraph.githubassets.com/1/alirezarezvani/claude-skills" />
+<meta property="og:image:width" content="1200" />
+<meta property="og:image:height" content="630" />
+<meta property="og:locale" content="en_US" />

 <!-- Twitter Card -->
 <meta name="twitter:card" content="summary_large_image" />
 <meta name="twitter:title" content="{{ page.meta.title or page.title }} - {{ config.site_name }}" />
 <meta name="twitter:description" content="{{ page.meta.description or config.site_description }}" />
 <meta name="twitter:site" content="@nginitycloud" />
+<meta name="twitter:creator" content="@nginitycloud" />
+<meta name="twitter:image" content="https://opengraph.githubassets.com/1/alirezarezvani/claude-skills" />
+
+<!-- Additional SEO -->
+<meta name="author" content="Alireza Rezvani" />
+<meta name="robots" content="index, follow" />
+<link rel="canonical" href="{{ page.canonical_url }}" />
 {% endif %}

 <!-- JSON-LD Structured Data -->
@@ -35,29 +46,57 @@
  "description": "{{ config.site_description }}",
  "author": {
    "@type": "Person",
-    "name": "{{ config.site_author }}"
+    "name": "{{ config.site_author }}",
+    "url": "https://alirezarezvani.com",
+    "sameAs": [
+      "https://github.com/alirezarezvani",
+      "https://alirezarezvani.medium.com",
+      "https://twitter.com/nginitycloud"
+    ]
  }
 }
 </script>
 <script type="application/ld+json">
 {
  "@context": "https://schema.org",
-  "@type": "SoftwareApplication",
-  "name": "Claude Code Skills",
-  "applicationCategory": "DeveloperApplication",
-  "operatingSystem": "Cross-platform",
+  "@type": "SoftwareSourceCode",
+  "name": "Claude Code Skills & Plugins",
  "description": "{{ config.site_description }}",
  "url": "{{ config.site_url }}",
+  "codeRepository": "https://github.com/alirezarezvani/claude-skills",
+  "programmingLanguage": ["Python", "Markdown"],
+  "runtimePlatform": "Claude Code, OpenAI Codex, Gemini CLI, Cursor, Aider, Windsurf, OpenClaw",
+  "license": "https://opensource.org/licenses/MIT",
  "author": {
    "@type": "Person",
-    "name": "{{ config.site_author }}"
+    "name": "{{ config.site_author }}",
+    "url": "https://alirezarezvani.com"
  },
-  "license": "https://opensource.org/licenses/MIT",
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD"
+  },
+  "keywords": "claude code skills, ai coding agent, claude code plugins, openai codex skills, gemini cli skills, cursor rules, ai agent skills, claude code agents, mcp server, coding assistant"
+}
+</script>
+{% if page and page.meta and page.meta.description %}
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "TechArticle",
+  "headline": "{{ page.meta.title or page.title }}",
+  "description": "{{ page.meta.description }}",
+  "url": "{{ page.canonical_url }}",
+  "author": {
+    "@type": "Person",
+    "name": "{{ config.site_author }}"
+  },
+  "publisher": {
+    "@type": "Person",
+    "name": "{{ config.site_author }}"
  }
 }
 </script>
+{% endif %}
 {% endblock %}
--- a/docs/overrides/partials/announce.html
+++ b/docs/overrides/partials/announce.html
@@ -1,3 +1,3 @@
-<a href="https://github.com/alirezarezvani/claude-skills/releases/tag/v2.1.2">
-  <strong>v2.1.2</strong> — 173 skills across 9 domains. Landing page generator now outputs Next.js TSX + Tailwind CSS!
+<a href="https://github.com/alirezarezvani/claude-skills">
+  <strong>New:</strong> 3 persona agents + orchestration protocol — combine skills across domains for complex work.
 </a>
--- a/docs/personas/growth-marketer.md
+++ b/docs/personas/growth-marketer.md
@@ -0,0 +1,50 @@
+---
+title: "Growth Marketer"
+description: "Growth marketing persona — content engines, funnel optimization, launch sequences, and scalable acquisition channels on a budget."
+---
+
+# :material-chart-line: Growth Marketer
+
+> Finds the growth channel nobody's exploited yet — then scales it before the budget runs out.
+
+Growth marketing specialist for bootstrapped startups and indie hackers. Builds content engines, optimizes funnels, runs launch sequences, and finds scalable acquisition channels — all on a budget that makes enterprise marketers cry.
+
+## Core Mission
+
+- Find and scale the one acquisition channel that works before trying three more
+- Build content engines that compound over time
+- Optimize conversion funnels with data, not opinions
+- Run launch sequences that generate momentum, not just announcements
+
+## Curated Skill Loadout
+
+This persona draws on expertise from these skills:
+
+| Skill | Domain |
+|-------|--------|
+| `content-strategy` | Topic planning and content calendars |
+| `copywriting` | Landing pages, headlines, CTAs |
+| `seo-audit` | Technical and content SEO |
+| `launch-strategy` | Product launches and announcements |
+| `email-sequence` | Drip campaigns and nurture flows |
+| `analytics-tracking` | Conversion tracking and measurement |
+| `ab-test-setup` | Experiment design and analysis |
+| `content-creator` | Blog posts and social content |
+
+## When to Use
+
+- Planning a product launch or feature announcement
+- Building a content marketing engine from scratch
+- Optimizing signup or purchase funnels
+- Choosing between growth channels on a limited budget
+- Writing landing page copy that converts
+- Setting up analytics and tracking
+
+## Installation
+
+```bash
+# Claude Code
+cp agents/personas/growth-marketer.md ~/.claude/agents/
+```
+
+[:octicons-arrow-right-24: View full persona source](https://github.com/alirezarezvani/claude-skills/blob/main/agents/personas/growth-marketer.md)
--- a/docs/personas/index.md
+++ b/docs/personas/index.md
@@ -0,0 +1,70 @@
+---
+title: "Personas"
+description: "3 persona-based agents with curated skill loadouts, workflows, and distinct communication styles."
+---
+
+<div class="domain-header" markdown>
+
+# :material-account-group: Personas
+
+<p class="domain-count">3 persona-based agents for role embodiment</p>
+
+</div>
+
+Personas go beyond task agents. They define how an agent thinks, prioritizes, and communicates — complete with identity, judgment frameworks, and curated skill loadouts.
+
+### Personas vs Task Agents
+
+| | Task Agents | Personas |
+|---|---|---|
+| **Purpose** | Execute a specific task | Embody a role across tasks |
+| **Scope** | Single domain | Cross-domain, curated |
+| **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.
+
+---
+
+<div class="grid cards" markdown>
+
+-   :material-hammer-wrench:{ .lg .middle } **[Startup CTO](startup-cto.md)**
+
+    ---
+
+    Architecture decisions, tech stack selection, team building, technical due diligence. Pragmatic, opinionated, allergic to over-engineering.
+
+-   :material-chart-line:{ .lg .middle } **[Growth Marketer](growth-marketer.md)**
+
+    ---
+
+    Content-led growth, launch strategy, channel optimization. Data-driven, budget-conscious, bootstrapped marketing expertise.
+
+-   :material-lightbulb-on:{ .lg .middle } **[Solo Founder](solo-founder.md)**
+
+    ---
+
+    One-person startups, side projects, MVP building. Cross-domain prioritization, wearing all hats, shipping fast.
+
+</div>
+
+---
+
+## Usage
+
+### Claude Code
+```bash
+cp agents/personas/startup-cto.md ~/.claude/agents/
+# Then: "Activate startup-cto mode"
+```
+
+### Any Supported Tool
+```bash
+./scripts/convert.sh --tool cursor   # Converts personas too
+./scripts/install.sh --tool cursor --target /path/to/project
+```
+
+### Create Your Own
+
+Use the [TEMPLATE.md](https://github.com/alirezarezvani/claude-skills/blob/main/agents/personas/TEMPLATE.md) to create custom personas with your own identity, skills, and workflows.
--- a/docs/personas/solo-founder.md
+++ b/docs/personas/solo-founder.md
@@ -0,0 +1,50 @@
+---
+title: "Solo Founder"
+description: "Solo founder persona — cross-domain prioritization for one-person startups, side projects, and MVP building."
+---
+
+# :material-lightbulb-on: Solo Founder
+
+> The co-founder you can't afford yet — covers product, eng, marketing, and the hard questions.
+
+Your co-founder who doesn't exist yet. Covers product, engineering, marketing, and strategy for one-person startups — because nobody is stopping you from making bad decisions and somebody should.
+
+## Core Mission
+
+- Prioritize ruthlessly across all domains — engineering, product, marketing, sales
+- Ship the MVP that tests the right hypothesis, not the one that feels productive
+- Avoid the traps solo founders fall into: building too much, launching too quietly, scaling too early
+- Make decisions with incomplete information and limited time
+
+## Curated Skill Loadout
+
+This persona draws on expertise from these skills:
+
+| Skill | Domain |
+|-------|--------|
+| `product-manager-toolkit` | Product decisions and roadmapping |
+| `saas-scaffolder` | MVP project structure |
+| `landing-page-generator` | Launch pages |
+| `copywriting` | Marketing copy |
+| `launch-strategy` | Go-to-market |
+| `pricing-strategy` | Revenue model |
+| `financial-analyst` | Budget and runway |
+| `senior-fullstack` | Implementation |
+
+## When to Use
+
+- Starting a new side project or startup alone
+- Deciding what to build first (and what to skip)
+- Switching between builder and marketer roles
+- Making trade-off decisions without a team to bounce ideas off
+- Planning an MVP launch with limited time and budget
+- Figuring out pricing, positioning, and go-to-market
+
+## Installation
+
+```bash
+# Claude Code
+cp agents/personas/solo-founder.md ~/.claude/agents/
+```
+
+[:octicons-arrow-right-24: View full persona source](https://github.com/alirezarezvani/claude-skills/blob/main/agents/personas/solo-founder.md)
--- a/docs/personas/startup-cto.md
+++ b/docs/personas/startup-cto.md
@@ -0,0 +1,50 @@
+---
+title: "Startup CTO"
+description: "Technical co-founder persona — architecture decisions, tech stack selection, team building, and technical due diligence."
+---
+
+# :material-hammer-wrench: Startup CTO
+
+> Ships fast, stays pragmatic, and won't let you Kubernetes your way out of 50 users.
+
+Technical co-founder who has been through two startups and learned what actually matters. Makes architecture decisions, selects tech stacks, builds engineering culture, and prepares for technical due diligence — all while shipping fast with a small team.
+
+## Core Mission
+
+- Ship working software that users can touch, not architecture diagrams
+- Choose boring technology for core infrastructure, exciting technology only where it creates competitive advantage
+- Build the smallest thing that validates the hypothesis, then iterate
+- Establish CI/CD, code review, and documentation habits from day one
+
+## Curated Skill Loadout
+
+This persona draws on expertise from these skills:
+
+| Skill | Domain |
+|-------|--------|
+| `aws-solution-architect` | Infrastructure design |
+| `senior-architect` | System architecture |
+| `senior-frontend` | UI implementation |
+| `senior-backend` | API and services |
+| `cto-advisor` | Technical leadership |
+| `tech-debt-tracker` | Debt management |
+| `ci-cd-pipeline-builder` | Deployment automation |
+| `database-designer` | Data modeling |
+
+## When to Use
+
+- Making build-vs-buy decisions
+- Selecting a tech stack for a new project
+- Preparing for technical due diligence
+- Architecture reviews and scaling discussions
+- Building engineering culture in a small team
+- Evaluating whether to hire or outsource
+
+## Installation
+
+```bash
+# Claude Code
+cp agents/personas/startup-cto.md ~/.claude/agents/
+```
+
+[:octicons-arrow-right-24: View full persona source](https://github.com/alirezarezvani/claude-skills/blob/main/agents/personas/startup-cto.md)
--- a/docs/skills/index.md
+++ b/docs/skills/index.md
@@ -1,6 +1,6 @@
 ---
 title: "Skills Overview"
-description: "Browse all 173 production-ready skills across 9 domains — engineering, product, marketing, C-level advisory, project management, regulatory, business growth, and finance."
+description: "Browse all 177 production-ready skills across 9 domains — engineering, product, marketing, C-level advisory, project management, regulatory, business growth, and finance."
 hide:
  - edit
 ---
@@ -9,14 +9,14 @@ hide:

 # Skills Library

-Browse 173 production-ready skills across 9 domains.
+Browse 177 production-ready skills across 9 domains.
 { .skills-hero-sub }

 </div>

 <div class="grid cards" markdown>

-   :material-counter:{ .lg .middle } **173 Skills**
+-   :material-counter:{ .lg .middle } **177 Skills**

    ---

--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -344,6 +344,70 @@
  margin: 0.25rem;
 }

+/* ===========================================
+   J2. Tools Bar
+   =========================================== */
+.tools-bar {
+  text-align: center;
+  padding: 1.5rem 1rem;
+  max-width: 720px;
+  margin: -0.5rem auto 0;
+}
+
+.tools-label {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  opacity: 0.45;
+  margin-bottom: 0.75rem;
+  font-weight: 600;
+}
+
+.tools-grid {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 0.5rem;
+}
+
+.tool-badge {
+  display: inline-block;
+  padding: 0.35rem 0.75rem;
+  border-radius: 6px;
+  font-size: 0.8rem;
+  font-weight: 600;
+  text-decoration: none !important;
+  transition: transform 0.15s ease, box-shadow 0.15s ease;
+  border: 1px solid transparent;
+}
+
+.tool-badge:hover {
+  transform: translateY(-1px);
+  box-shadow: 0 2px 8px rgba(0,0,0,0.12);
+  text-decoration: none !important;
+}
+
+/* Tool-specific colors */
+.tool-claude { background: #D97706; color: #fff !important; }
+.tool-codex { background: #10A37F; color: #fff !important; }
+.tool-gemini { background: #4285F4; color: #fff !important; }
+.tool-cursor { background: #000; color: #fff !important; }
+.tool-aider { background: #6366F1; color: #fff !important; }
+.tool-windsurf { background: #06B6D4; color: #fff !important; }
+.tool-kilo { background: #EC4899; color: #fff !important; }
+.tool-opencode { background: #8B5CF6; color: #fff !important; }
+.tool-augment { background: #F59E0B; color: #fff !important; }
+.tool-antigravity { background: #EF4444; color: #fff !important; }
+.tool-openclaw { background: #059669; color: #fff !important; }
+
+[data-md-color-scheme="default"] .tool-cursor {
+  background: #1a1a1a;
+}
+
+[data-md-color-scheme="slate"] .tool-badge {
+  border-color: rgba(255,255,255,0.1);
+}
+
 /* Skills page hero */
 .skills-hero {
  text-align: center;
@@ -542,6 +606,15 @@
    font-size: 1.8rem !important;
  }

+  .tools-bar {
+    padding: 1rem 0.5rem;
+  }
+
+  .tool-badge {
+    font-size: 0.7rem;
+    padding: 0.25rem 0.55rem;
+  }
+
  .page-meta {
    gap: 0.35rem;
  }
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,10 +1,10 @@
-site_name: Claude Code Skills & Plugins
+site_name: Agent Skills — Skills, Agents & Personas for AI Coding Tools
 site_url: https://alirezarezvani.github.io/claude-skills/
-site_description: "177 production-ready skills for Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. Reusable expertise for engineering, product, marketing, compliance, and more."
+site_description: "177 production-ready skills, 16 agents, 3 personas, and an orchestration protocol for 11 AI coding tools. Reusable expertise for engineering, product, marketing, compliance, and more."
 site_author: Alireza Rezvani
 repo_url: https://github.com/alirezarezvani/claude-skills
 repo_name: alirezarezvani/claude-skills
-edit_uri: edit/main/
+edit_uri: edit/main/docs/
 copyright: "Built by Alireza Rezvani"

 theme:
@@ -318,6 +318,12 @@ nav:
      - "SaaS Metrics Coach": skills/finance/saas-metrics-coach.md
  - Plugins:
    - Overview: plugins/index.md
+  - Personas:
+    - Overview: personas/index.md
+    - "Startup CTO": personas/startup-cto.md
+    - "Growth Marketer": personas/growth-marketer.md
+    - "Solo Founder": personas/solo-founder.md
+  - Orchestration: orchestration.md
  - Agents:
    - Overview: agents/index.md
    - "CS Agile Product Owner": agents/cs-agile-product-owner.md