firefrost-gaming/claude-skills-reference
3
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Leo
2026-03-15 22:41:44 +01:00
parent 77c2dbcd97
commit 2b5260dbeb
5 changed files with 476 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
.autoresearch/seo/skill-descriptions/program.md Normal file
View File

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

123
docs/guides/agent-skills-for-codex.md Normal file
View File

@@ -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)*

120
docs/guides/best-claude-code-plugins.md Normal file
View File

@@ -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)*

81
docs/guides/cursor-skills-guide.md Normal file
View File

@@ -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)*

116
docs/guides/gemini-cli-skills-guide.md Normal file
View File

@@ -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)*