seo: add plugin/skill guides for Claude Code, Codex, Gemini CLI, Cursor + autoresearch program

2026-03-15 22:41:44 +01:00
parent 77c2dbcd97
commit 2b5260dbeb
5 changed files with 476 additions and 0 deletions
--- a/docs/guides/agent-skills-for-codex.md
+++ b/docs/guides/agent-skills-for-codex.md
@@ -0,0 +1,123 @@
+---
+title: "Agent Skills for OpenAI Codex CLI (2026)"
+description: "Install and use 192 agent skills with OpenAI Codex CLI. Engineering, marketing, product, and DevOps plugins for Codex."
+---
+
+# Agent Skills for OpenAI Codex CLI
+
+Use 192 production-ready agent skills with OpenAI Codex CLI. Every skill in this collection works natively with Codex via the `.codex/skills/` directory format.
+
+---
+
+## Quick Install
+
+```bash
+# Clone the repository
+git clone https://github.com/alirezarezvani/claude-skills.git
+cd claude-skills
+
+# Option 1: Install all skills for Codex
+./scripts/codex-install.sh
+
+# Option 2: Convert specific skills
+./scripts/convert.sh --skill frontend-design --tool codex
+./scripts/convert.sh --skill autoresearch-agent --tool codex
+
+# Option 3: Convert all skills at once
+./scripts/convert.sh --all --tool codex
+```
+
+### How It Works
+
+Codex reads agent skills from `.codex/skills/<skill-name>/SKILL.md` in your project or home directory. The `convert.sh` script transforms Claude Code's SKILL.md format into Codex-compatible instructions, preserving all workflows, slash commands, and references.
+
+---
+
+## Top Skills for Codex Users
+
+### Engineering
+
+| Skill | Codex Command | What It Does |
+|-------|--------------|-------------|
+| **autoresearch-agent** | `/ar:run` | Autonomous experiment loop — edit, evaluate, keep or revert. Karpathy-inspired. |
+| **pr-review-expert** | `/review:full` | Multi-pass code review catching logic bugs, security issues, missing tests. |
+| **frontend-design** | `/design:component` | Production-grade React/Tailwind UI with high design quality. |
+| **tdd-guide** | `/tdd:start` | Red-green-refactor TDD workflow with coverage tracking. |
+| **senior-devops** | `/devops:deploy` | IaC, CI/CD, monitoring, and incident response playbooks. |
+| **docker-development** | `/docker:optimize` | Dockerfile optimization, multi-stage builds, container security. |
+
+### Beyond Engineering
+
+| Skill | Codex Command | What It Does |
+|-------|--------------|-------------|
+| **content-creator** | `/content:write` | SEO-optimized content with brand voice analysis. |
+| **cto-advisor** | `/cto:assess` | Tech debt scoring, team scaling, architecture decisions. |
+| **agile-product-owner** | `/po:story` | User stories, acceptance criteria, sprint planning. |
+| **research-summarizer** | `/research:summarize` | Structured research → summary → citations workflow. |
+
+---
+
+## Codex-Specific Tips
+
+### AGENTS.md Fallback
+
+If your Codex setup uses `AGENTS.md` instead of the skills directory, you can use the generated agents file:
+
+```bash
+# Copy the bundled AGENTS.md to your project
+cp claude-skills/agents/AGENTS.md ~/.codex/AGENTS.md
+```
+
+### Using with `--full-auto`
+
+Skills work seamlessly with Codex's auto-approval mode:
+
+```bash
+# Run a skill in full-auto mode
+codex exec --full-auto "Use the frontend-design skill to build a dashboard component"
+
+# Run autoresearch overnight
+codex exec --full-auto "Use autoresearch-agent to optimize src/api/search.py for response time"
+```
+
+### Project-Level vs Global
+
+```bash
+# Project-level (only this repo)
+cp -r claude-skills/.codex/skills/ ./.codex/skills/
+
+# Global (available everywhere)
+cp -r claude-skills/.codex/skills/ ~/.codex/skills/
+```
+
+---
+
+## Full Skill Catalog
+
+All 192 skills organized by domain:
+
+| Domain | Skills | Highlights |
+|--------|--------|-----------|
+| **Engineering** | 28 | autoresearch-agent, pr-review-expert, database-designer, migration-architect |
+| **Engineering Team** | 15 | senior-frontend, senior-backend, senior-devops, senior-security, senior-qa |
+| **Marketing** | 22 | content-creator, copywriting, email-sequence, SEO audit, app-store-optimization |
+| **Product** | 12 | agile-product-owner, ux-researcher, research-summarizer, analytics-tracking |
+| **Business Growth** | 10 | launch-strategy, competitor-alternatives, free-tool-strategy |
+| **C-Level Advisory** | 8 | cto-advisor, ceo-advisor, cfo-advisor, marketing-strategy-pmm |
+| **Finance** | 6 | financial modeling, fundraising, unit economics |
+| **Compliance** | 8 | ISO 27001, ISO 13485, MDR, FDA, GDPR |
+| **Project Management** | 5 | Jira expert, sprint planning, retrospective facilitator |
+
+---
+
+## Cross-Platform
+
+These same skills work on 10 other coding agents:
+
+Claude Code · Gemini CLI · Cursor · OpenClaw · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity
+
+See the [full README](https://github.com/alirezarezvani/claude-skills) for platform-specific install guides.
+
+---
+
+*Last updated: March 2026 · [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)*
--- a/docs/guides/best-claude-code-plugins.md
+++ b/docs/guides/best-claude-code-plugins.md
@@ -0,0 +1,120 @@
+---
+title: "Best Claude Code Plugins & Skills (2026)"
+description: "The 20 best Claude Code plugins and agent skills for engineering, marketing, product, and DevOps. Install in one command."
+---
+
+# Best Claude Code Plugins & Skills (2026)
+
+Looking for the best Claude Code plugins to supercharge your workflow? This guide covers 20 production-ready plugins and agent skills — from engineering and DevOps to marketing, product management, and C-level advisory.
+
+All plugins listed here are open-source (MIT), tested in production, and installable in one command.
+
+---
+
+## What's the Difference Between Plugins and Skills?
+
+**Claude Code plugins** use the `.claude-plugin/plugin.json` format and install via `/plugin install`. **Agent skills** use `SKILL.md` files and work across Claude Code, Codex, Gemini CLI, Cursor, and 8 other coding agents.
+
+This repo provides **both formats** — every skill includes a `.claude-plugin` directory for native Claude Code plugin support, plus a `SKILL.md` for cross-platform compatibility.
+
+---
+
+## Quick Install
+
+```bash
+# Install the full marketplace (all 192 skills as Claude Code plugins)
+claude /plugin install https://github.com/alirezarezvani/claude-skills
+
+# Install by domain
+claude /plugin install engineering-skills
+claude /plugin install marketing-skills
+claude /plugin install devops-skills
+
+# Install individual plugins
+claude /plugin install frontend-design
+claude /plugin install pr-review-expert
+claude /plugin install autoresearch-agent
+```
+
+---
+
+## Top 20 Claude Code Plugins
+
+### Engineering & DevOps
+
+| Plugin | What It Does | Install |
+|--------|-------------|---------|
+| **frontend-design** | Production-grade UI with high design quality. React, Tailwind, shadcn/ui. | `/plugin install frontend-design` |
+| **pr-review-expert** | Multi-pass code review: logic bugs, security, test coverage, architecture. | `/plugin install pr-review-expert` |
+| **autoresearch-agent** | Autonomous experiment loop — optimizes any file by a measurable metric. | `/plugin install autoresearch-agent` |
+| **senior-devops** | Infrastructure as Code, CI/CD pipelines, monitoring, incident response. | `/plugin install senior-devops` |
+| **docker-development** | Dockerfile optimization, multi-stage builds, container security scanning. | `/plugin install docker-development` |
+| **aws-solution-architect** | AWS architecture design with serverless patterns and IaC templates. | `/plugin install aws-solution-architect` |
+| **tdd-guide** | Test-driven development workflows with red-green-refactor cycles. | `/plugin install tdd-guide` |
+| **database-designer** | Schema design, migrations, indexing strategies, query optimization. | `/plugin install database-designer` |
+
+### Marketing & Content
+
+| Plugin | What It Does | Install |
+|--------|-------------|---------|
+| **content-creator** | SEO-optimized content with consistent brand voice and frameworks. | `/plugin install content-creator` |
+| **copywriting** | Marketing copy for landing pages, pricing pages, CTAs. | `/plugin install copywriting` |
+| **email-sequence** | Drip campaigns, nurture sequences, lifecycle email programs. | `/plugin install email-sequence` |
+| **app-store-optimization** | ASO keyword research, metadata optimization, A/B testing. | `/plugin install app-store-optimization` |
+
+### Product & Business
+
+| Plugin | What It Does | Install |
+|--------|-------------|---------|
+| **research-summarizer** | Structured research → summary → citations for papers and reports. | `/plugin install research-summarizer` |
+| **agile-product-owner** | User stories, acceptance criteria, sprint planning, velocity tracking. | `/plugin install agile-product-owner` |
+| **ab-test-setup** | A/B test design, hypothesis creation, statistical significance. | `/plugin install ab-test-setup` |
+| **analytics-tracking** | GA4, GTM, conversion tracking, UTM parameters, tracking plans. | `/plugin install analytics-tracking` |
+
+### C-Level & Strategy
+
+| Plugin | What It Does | Install |
+|--------|-------------|---------|
+| **cto-advisor** | Tech debt analysis, team scaling, architecture decisions, DORA metrics. | `/plugin install cto-advisor` |
+| **ceo-advisor** | Strategy, board governance, investor relations, organizational development. | `/plugin install ceo-advisor` |
+| **cfo-advisor** | Financial modeling, fundraising, burn rate analysis, unit economics. | `/plugin install cfo-advisor` |
+| **marketing-strategy-pmm** | Positioning (April Dunford), GTM strategy, competitive intelligence. | `/plugin install marketing-strategy-pmm` |
+
+---
+
+## Why These Plugins?
+
+Unlike single-purpose plugins, these are **POWERFUL-tier** agent skills — each includes:
+
+- **Structured workflows** with slash commands (not just prompts)
+- **Python CLI tools** (254 total, zero pip dependencies)
+- **Reference documents** — templates, checklists, domain-specific knowledge
+- **Cross-platform support** — works on 11 coding agents, not just Claude Code
+
+---
+
+## Cross-Platform Compatibility
+
+Every plugin in this collection works across multiple AI coding agents:
+
+| Tool | Format | Install Method |
+|------|--------|---------------|
+| Claude Code | `.claude-plugin` | `/plugin install` |
+| OpenAI Codex | `.codex/skills/` | `./scripts/codex-install.sh` |
+| Gemini CLI | `.gemini/skills/` | `./scripts/gemini-install.sh` |
+| Cursor | `.cursor/skills/` | `./scripts/convert.sh --tool cursor` |
+| OpenClaw | `clawhub install` | Via ClawHub marketplace |
+| Aider, Windsurf, Kilo Code, OpenCode, Augment, Antigravity | Converted formats | `./scripts/convert.sh --tool <name>` |
+
+---
+
+## Related Resources
+
+- [Full Skill Catalog](https://github.com/alirezarezvani/claude-skills) — all 192 skills
+- [Agent Skills for Codex](./agent-skills-for-codex.md) — Codex-specific guide
+- [Gemini CLI Skills Guide](./gemini-cli-skills-guide.md) — Gemini CLI setup
+- [Cursor Skills Guide](./cursor-skills-guide.md) — Cursor integration
+
+---
+
+*Last updated: March 2026 · [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)*
--- a/docs/guides/cursor-skills-guide.md
+++ b/docs/guides/cursor-skills-guide.md
@@ -0,0 +1,81 @@
+---
+title: "Cursor Agent Skills & Rules Guide (2026)"
+description: "Install and use 192 agent skills with Cursor IDE. Engineering, marketing, and product plugins for Cursor's AI coding agent."
+---
+
+# Cursor Agent Skills Guide
+
+Use 192 production-ready agent skills with Cursor IDE. Every skill converts to Cursor's rules format and installs via the `.cursor/skills/` directory.
+
+---
+
+## Quick Install
+
+```bash
+# Clone the repository
+git clone https://github.com/alirezarezvani/claude-skills.git
+cd claude-skills
+
+# Convert all skills to Cursor format
+./scripts/convert.sh --all --tool cursor
+
+# Or convert individual skills
+./scripts/convert.sh --skill frontend-design --tool cursor
+./scripts/convert.sh --skill pr-review-expert --tool cursor
+```
+
+### How It Works
+
+Cursor reads agent rules from `.cursor/rules/` and `.cursorrules` files. The convert script transforms SKILL.md files into Cursor-compatible rule sets, preserving workflows, decision frameworks, and domain knowledge.
+
+---
+
+## Top Skills for Cursor Users
+
+| Skill | What It Does | Best For |
+|-------|-------------|----------|
+| **frontend-design** | Production-grade UI with React, Tailwind, shadcn/ui. | Building polished interfaces |
+| **pr-review-expert** | Multi-pass code review catching logic, security, and test gaps. | Code quality |
+| **senior-fullstack** | Full-stack patterns: API design, auth, state management. | Application architecture |
+| **tdd-guide** | Test-driven development with red-green-refactor. | Writing tests first |
+| **content-creator** | SEO-optimized content with brand voice frameworks. | Marketing content |
+| **agile-product-owner** | User stories, acceptance criteria, sprint planning. | Product work |
+| **cto-advisor** | Tech debt analysis, team scaling, architecture decisions. | Technical leadership |
+| **database-designer** | Schema design, migrations, indexing, query optimization. | Database work |
+
+---
+
+## Cursor-Specific Integration
+
+### Using with Cursor's Subagents
+
+Cursor's multi-model subagent system works well with skills:
+
+```
+# In Cursor's Composer, reference a skill:
+@skill frontend-design Build a dashboard with charts and data tables
+
+# Or use slash commands from the skill:
+/design:component Create a pricing card with toggle for monthly/annual
+```
+
+### Project Rules
+
+Add skills to your `.cursorrules` for project-wide availability:
+
+```bash
+# Append skill instructions to cursor rules
+cat .cursor/skills/frontend-design/SKILL.md >> .cursorrules
+```
+
+---
+
+## Full Catalog
+
+All 192 skills across 9 domains. See the [full README](https://github.com/alirezarezvani/claude-skills) for the complete list.
+
+**Also works with:** Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity
+
+---
+
+*Last updated: March 2026 · [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)*
--- a/docs/guides/gemini-cli-skills-guide.md
+++ b/docs/guides/gemini-cli-skills-guide.md
@@ -0,0 +1,116 @@
+---
+title: "Gemini CLI Skills & Plugins Guide (2026)"
+description: "Install and use 192 agent skills with Gemini CLI. Free evaluation calls, engineering, marketing, and DevOps skills for Google's coding agent."
+---
+
+# Gemini CLI Agent Skills Guide
+
+Use 192 production-ready agent skills with Gemini CLI. Every skill in this collection is compatible with Gemini's agent skills specification and installs via the `.gemini/skills/` directory.
+
+---
+
+## Quick Install
+
+```bash
+# Clone the repository
+git clone https://github.com/alirezarezvani/claude-skills.git
+cd claude-skills
+
+# Run the Gemini setup script (converts and installs all skills)
+./scripts/gemini-install.sh
+
+# Or convert individual skills
+./scripts/convert.sh --skill frontend-design --tool gemini
+./scripts/convert.sh --skill autoresearch-agent --tool gemini
+```
+
+### How It Works
+
+Gemini CLI reads agent skills from `.gemini/skills/<skill-name>/SKILL.md` in your project directory. The setup script converts all skills to Gemini-compatible format, including `gemini-extension.json` for the extension registry.
+
+---
+
+## Why Use Skills with Gemini CLI?
+
+Gemini CLI's free tier gives you **unlimited evaluation calls** — perfect for:
+
+- **Autoresearch loops** — run overnight experiments with zero API cost
+- **Content optimization** — LLM-judge evaluators for headlines, copy, prompts
+- **Code review** — systematic multi-pass reviews without burning tokens
+
+### Free Evaluators with Gemini
+
+The autoresearch-agent skill includes LLM judge evaluators that work with Gemini's free tier:
+
+```bash
+# Set up an autoresearch experiment using Gemini as the evaluator
+python scripts/setup_experiment.py \
+  --domain marketing \
+  --name headline-optimization \
+  --target content/headlines.md \
+  --eval "python evaluate.py" \
+  --metric ctr_score \
+  --direction higher \
+  --evaluator llm_judge_content
+
+# The evaluator calls gemini CLI for scoring — free!
+```
+
+---
+
+## Top Skills for Gemini CLI
+
+| Skill | What It Does |
+|-------|-------------|
+| **autoresearch-agent** | Autonomous experiment loop — edit, evaluate, keep or revert. Free with Gemini. |
+| **frontend-design** | Production-grade React/Tailwind UI with high design quality. |
+| **pr-review-expert** | Multi-pass code review: logic, security, tests, architecture. |
+| **content-creator** | SEO-optimized content with brand voice analysis and frameworks. |
+| **senior-devops** | IaC, CI/CD, monitoring, and incident response. |
+| **cto-advisor** | Tech debt analysis, team scaling, architecture decisions. |
+| **research-summarizer** | Structured research → summary → citations workflow. |
+| **docker-development** | Dockerfile optimization, multi-stage builds, security scanning. |
+
+---
+
+## Gemini Extension Integration
+
+This repo includes `gemini-extension.json` for Gemini's extension registry:
+
+```json
+{
+  "name": "claude-skills",
+  "version": "2.0.0",
+  "description": "192 agent skills for engineering, marketing, product, and more",
+  "skills": ["engineering/*", "marketing-skill/*", "product-team/*", "..."]
+}
+```
+
+See the [Gemini CLI extensions docs](https://geminicli.com/docs/cli/skills/) for integration details.
+
+---
+
+## Project-Level vs User-Level
+
+```bash
+# Project-level (scoped to one repo)
+cp -r claude-skills/.gemini/skills/ ./.gemini/skills/
+
+# User-level (available in all projects)
+mkdir -p ~/.gemini/skills/
+cp -r claude-skills/.gemini/skills/* ~/.gemini/skills/
+```
+
+---
+
+## Cross-Platform
+
+These skills work on 10 other coding agents too:
+
+Claude Code · OpenAI Codex · Cursor · OpenClaw · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity
+
+See the [full catalog](https://github.com/alirezarezvani/claude-skills) for all 192 skills.
+
+---
+
+*Last updated: March 2026 · [alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)*