diff --git a/docs/index.md b/docs/index.md
index 1100322..44f4ee0 100644
--- 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:
-# 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 }
+
+
+---
+
+## What's Inside
+
-- :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)
@@ -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?
-- :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.
@@ -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 }
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
index 735b9ab..4885a2a 100644
--- 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;
}
diff --git a/mkdocs.yml b/mkdocs.yml
index daf3e9e..7947ab3 100644
--- 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: