docs: overhaul homepage with tools bar, tabbed install, and professional polish

- Replace text-only platform list with styled color-coded tool badges - Each badge links to the relevant install section - Add tabbed Quick Install section (Claude Code / Codex / Gemini / Cursor) - Restructure 'What's Inside' grid: skills, agents, personas, orchestration, tools, plugins, commands, multi-tool - Rename 'POWERFUL' to 'Advanced' in domain cards - Add tools-bar CSS with per-tool brand colors and hover effects - Mobile-responsive tool badges - Broaden site_name: 'Agent Skills' (not just Claude Code) - Fix edit_uri: edit/main/docs/ (was missing docs/ prefix) - Build verified: 238 sitemap URLs, all new pages included
2026-03-12 18:47:42 +01:00
parent afba472528
commit bd70015f60
3 changed files with 182 additions and 42 deletions
--- 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, 3 personas, 17 commands, and an orchestration protocol for 11 AI coding tools."
+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,62 +12,106 @@ hide:

 <div class="hero" markdown>

-# Claude Code Skills
+# Agent Skills

-177 skills, 16 agents, 3 personas, and an orchestration protocol for 11 AI coding tools.
+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.

-   :material-account-group:{ .lg .middle } **3**
+    [:octicons-arrow-right-24: Getting started](getting-started.md)
+
+-   :material-puzzle-outline:{ .lg .middle } **19 Plugins**

    ---

-    [Persona agents](personas/)
+    One-command installable bundles for Claude Code, Codex CLI, Gemini CLI, and OpenClaw.

-   :material-sitemap:{ .lg .middle } **4**
+    [:octicons-arrow-right-24: Plugin marketplace](plugins/)
+
+-   :material-console:{ .lg .middle } **17 Commands**

    ---

-    [Orchestration patterns](orchestration.md)
+    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>

@@ -85,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**

    ---

@@ -97,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/)

@@ -105,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/)

@@ -145,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/)

@@ -153,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>

@@ -199,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/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, 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: