From 2b5260dbebf712bfaea5464afca1670b40aaf275 Mon Sep 17 00:00:00 2001 From: Leo Date: Sun, 15 Mar 2026 22:41:44 +0100 Subject: [PATCH] seo: add plugin/skill guides for Claude Code, Codex, Gemini CLI, Cursor + autoresearch program --- .../seo/skill-descriptions/program.md | 36 +++++ docs/guides/agent-skills-for-codex.md | 123 ++++++++++++++++++ docs/guides/best-claude-code-plugins.md | 120 +++++++++++++++++ docs/guides/cursor-skills-guide.md | 81 ++++++++++++ docs/guides/gemini-cli-skills-guide.md | 116 +++++++++++++++++ 5 files changed, 476 insertions(+) create mode 100644 .autoresearch/seo/skill-descriptions/program.md create mode 100644 docs/guides/agent-skills-for-codex.md create mode 100644 docs/guides/best-claude-code-plugins.md create mode 100644 docs/guides/cursor-skills-guide.md create mode 100644 docs/guides/gemini-cli-skills-guide.md diff --git a/.autoresearch/seo/skill-descriptions/program.md b/.autoresearch/seo/skill-descriptions/program.md new file mode 100644 index 0000000..eabf1ed --- /dev/null +++ b/.autoresearch/seo/skill-descriptions/program.md @@ -0,0 +1,36 @@ +# Experiment: Skill Description SEO Optimization + +## Objective +Optimize the `description` field in each skill's SKILL.md frontmatter to maximize: +1. **SEO discoverability** — include high-volume keywords: "agent skill", "plugin", "Claude Code", "Codex", "Gemini CLI", "Cursor" +2. **Trigger accuracy** — the description must accurately describe when the skill activates +3. **Clarity** — one read should convey what the skill does and who it's for +4. **Cross-platform appeal** — mention multi-tool compatibility where natural + +## Constraints +- Description must be under 200 characters (plugin.json limit) +- Must NOT be spammy or keyword-stuffed — natural language only +- Must preserve the skill's actual purpose and capabilities +- Do NOT modify anything outside the `description:` field in frontmatter +- One skill per experiment iteration + +## Strategy +- Start with the top 10 most-viewed skills (from GitHub traffic) +- For each: read current description → rewrite with SEO keywords → evaluate +- Terms to naturally incorporate: "agent skill", "plugin", "coding agent", tool names +- Avoid: generic filler, "AI-powered", "comprehensive solution" + +## Target Skills (in priority order) +1. marketing-skill/SKILL.md (all sub-skills) +2. engineering-team/SKILL.md (all sub-skills) +3. engineering/SKILL.md (all sub-skills) +4. c-level-advisor/SKILL.md (all sub-skills) +5. finance/SKILL.md (all sub-skills) +6. business-growth/SKILL.md (all sub-skills) +7. product-team/SKILL.md (all sub-skills) +8. project-management/SKILL.md (all sub-skills) + +## Evaluation +Use llm_judge_content evaluator customized for SEO scoring. +Metric: seo_quality_score (0-100) +Direction: higher is better diff --git a/docs/guides/agent-skills-for-codex.md b/docs/guides/agent-skills-for-codex.md new file mode 100644 index 0000000..7fd199d --- /dev/null +++ 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.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)* diff --git a/docs/guides/best-claude-code-plugins.md b/docs/guides/best-claude-code-plugins.md new file mode 100644 index 0000000..9b009e5 --- /dev/null +++ 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 ` | + +--- + +## 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)* diff --git a/docs/guides/cursor-skills-guide.md b/docs/guides/cursor-skills-guide.md new file mode 100644 index 0000000..786712c --- /dev/null +++ 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)* diff --git a/docs/guides/gemini-cli-skills-guide.md b/docs/guides/gemini-cli-skills-guide.md new file mode 100644 index 0000000..faa0655 --- /dev/null +++ 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.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)*