mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-08-28 04:24:58 +00:00
chore(v2.7.3): release prep — docs sync + audit fixes + CHANGELOG
Post-merge sync of v2.7.3 (#679 already in dev). Three things in one commit: ## 1. /update-docs pipeline (Steps 1-7) Cross-platform sync verified clean across 3 platforms (.codex 305 / .gemini 355 / .hermes 305 — aeo + security-guidance present in all three indexes). 401 → 403 MkDocs pages generated. **Files refreshed to v2.7.3 / 313 / 46+ / 60+ counts:** - `.claude-plugin/marketplace.json` — top-level description + metadata description + metadata.version (was 2.7.0). - `CLAUDE.md` — Current Scope line, new v2.7.3 Highlights section, footer (Last Updated + Version + Status). - `README.md` — tagline, badges, Skills Overview row counts (Engineering POWERFUL 44 → 45, Marketing 44 → 45 w/ 8 pods), Python Tools count, FAQ counts. Hermes footnote ticked v2.7.2 → v2.7.3. - `docs/index.md` — title, meta description, hero subtitle, grid card. - `docs/getting-started.md` — meta description, FAQ count. - `mkdocs.yml` — site_description + 3 nav entries (skill + agent + cmd). - `marketing-skill/.claude-plugin/plugin.json` — 44 → 45 skills, 7 → 8 pods, v2.2.3 → v2.7.3. - `marketing-skill/CLAUDE.md` — 43 → 45 skill count, 32 → 58 Python tools, 7 → 8 pods. Added AEO skill to skill map. ## 2. /plugin-audit on both new skills (full 8-phase pipeline) **aeo (marketing-skill/skills/aeo/)** — PASS WITH WARNINGS: - Phase 2 Structure: 86.4/GOOD (after auto-fix of YAML frontmatter parse error — colon in description value needed quote-wrapping) - Phase 3 Quality: 52.4/D (validator expects legacy fields v2.7 skills don't use — repo-wide pattern, not a defect) - Phase 4 Scripts: 3/3 PASS - Phase 5 Security: 2 HIGH NET-EXFIL findings on urllib.request — same known false-positive as sister seo-audit skill (URL fetch is core functionality for content-audit-by-URL tools, not exfiltration) - Phase 6 Marketplace: plugin.json valid (v2.7.3, all required fields) - Phase 7 Ecosystem: indexed in all 3 platforms - Phase 8 Code Review: 22 workflow sections, refs cite 8/17/37 sources (≥7 floor met), 0 broken links, attribution present **security-guidance (engineering/security-guidance/)** — PASS WITH WARNINGS: - Phase 2/3/4: low scores due to hook-plugin layout mismatch with script-plugin validators (hook plugins use `hooks/` not `scripts/` per Claude Code spec — fundamental structural mismatch, not a defect) - Phase 5: 6 CRITICAL + 4 HIGH findings are all recursive false- positives — auditor detects the hook's OWN pattern-detection strings (`"exec("`, `"eval("`, `"yaml.load("` are substring literals used as detection rules, NOT actual calls). Verified zero real exec/eval calls in the file. - Phase 6/7: clean (plugin.json valid, hooks.json valid, indexed in all 3 platforms, mkdocs nav entry added) - Phase 8: 291 LOC, syntax valid, clear exit-code contract (0=clean, 2=block per Claude Code hook spec), session-state caching @ lines 158-191, 30-day cleanup @ line 163, attribution full, live smoke test (`eval(input())` in Write → exit 2 + warning) PASS - **Real defects: 0.** ## 3. Layout fix (Phase 7 audit catch) The /plugin-audit Phase 7 caught a real layout bug: cs-aeo.md placed at `marketing-skill/agents/cs-aeo.md` and `marketing-skill/commands/ cs-aeo.md` was unreachable by `scripts/generate-docs.py` (which only walks root `agents/<domain>/` and root `commands/`). Result: docs/ pages for cs-aeo agent + /cs:aeo command were never generated. **Moved to repo-canonical locations:** - `marketing-skill/agents/cs-aeo.md` → `agents/marketing/cs-aeo.md` - `marketing-skill/commands/cs-aeo.md` → `commands/cs-aeo.md` Cleaned empty `marketing-skill/agents/` + `marketing-skill/commands/` directories. Re-ran `scripts/generate-docs.py`: 401 → 403 pages (73 agents + 34 commands — both new entries present). ## CHANGELOG.md Added [2.7.3] - 2026-05-17 entry with full Added / Changed / Layout fix / Cross-platform sync / Honest audit results / PRs / Verification sections. Audit results documented verbatim including the known false-positives — no claims of clean security where the auditor flagged patterns it can't disambiguate. https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
This commit is contained in:
Claude
parent
a9f36f191e
commit
7c54a72d94
24 changed files with 849 additions and 66 deletions
|
|
@ -4,12 +4,12 @@
|
|||
"name": "Alireza Rezvani",
|
||||
"url": "https://alirezarezvani.com"
|
||||
},
|
||||
"description": "311 production-ready skill packages for Claude AI across 12 domains: engineering advanced (75 \u2014 incl. 4 Matt Pocock-derived productivity skills), engineering core (51), marketing (46), c-level advisory (66), product (17), regulatory/QMS (18), project management (9), business growth (5), finance (4), productivity (4, v2.7.0), marketing top-level (2, v2.7.0), and research (8, v2.7.0). Includes ~398 Python tools, ~538 reference documents, 45+ agents, 59+ slash commands.",
|
||||
"description": "313 production-ready skill packages for Claude AI across 12 domains: engineering advanced (76 \u2014 incl. 4 Matt Pocock-derived productivity skills + v2.7.3 security-guidance PreToolUse hook), engineering core (51), marketing (47 \u2014 incl. v2.7.3 AEO/Answer Engine Optimization), c-level advisory (66), product (17), regulatory/QMS (18), project management (9), business growth (5), finance (4), productivity (4, v2.7.0), marketing top-level (2, v2.7.0), and research (8, v2.7.0). Includes ~402 Python tools, ~542 reference documents, 46+ agents, 60+ slash commands.",
|
||||
"homepage": "https://github.com/alirezarezvani/claude-skills",
|
||||
"repository": "https://github.com/alirezarezvani/claude-skills",
|
||||
"metadata": {
|
||||
"description": "313 production-ready skill packages across 12 domains (engineering, marketing, product, c-level, project management, RA/QM, business growth, finance, productivity, marketing (top-level), research, plus standards). ~398 Python tools, ~538 reference guides, 45+ agents (cs-* + personas), 59+ slash commands. Compatible with Claude Code, Codex CLI, Gemini CLI, Cursor, OpenClaw, Hermes Agent, and 6 more coding agents.",
|
||||
"version": "2.7.0"
|
||||
"description": "313 production-ready skill packages across 12 domains (engineering, marketing, product, c-level, project management, RA/QM, business growth, finance, productivity, marketing (top-level), research, plus standards). ~402 Python tools, ~542 reference guides, 46+ agents (cs-* + personas), 60+ slash commands. v2.7.3 adds AEO (Answer Engine Optimization for LLM citation) + security-guidance PreToolUse hook. Compatible with Claude Code, Codex CLI, Gemini CLI, Cursor, OpenClaw, Hermes Agent, and 6 more coding agents.",
|
||||
"version": "2.7.3"
|
||||
},
|
||||
"plugins": [
|
||||
{
|
||||
|
|
|
|||
|
|
@ -593,18 +593,18 @@
|
|||
"category": "engineering",
|
||||
"description": ">-"
|
||||
},
|
||||
{
|
||||
"name": "review",
|
||||
"source": "../../engineering-team/playwright-pro/skills/review",
|
||||
"category": "engineering",
|
||||
"description": ">-"
|
||||
},
|
||||
{
|
||||
"name": "review",
|
||||
"source": "../../engineering-team/self-improving-agent/skills/review",
|
||||
"category": "engineering",
|
||||
"description": "Analyze auto-memory for promotion candidates, stale entries, consolidation opportunities, and health metrics."
|
||||
},
|
||||
{
|
||||
"name": "review",
|
||||
"source": "../../engineering-team/playwright-pro/skills/review",
|
||||
"category": "engineering",
|
||||
"description": ">-"
|
||||
},
|
||||
{
|
||||
"name": "security-pen-testing",
|
||||
"source": "../../engineering-team/skills/security-pen-testing",
|
||||
|
|
@ -1061,18 +1061,18 @@
|
|||
"category": "engineering-advanced",
|
||||
"description": "Resume a paused experiment. Checkout the experiment branch, read results history, continue iterating."
|
||||
},
|
||||
{
|
||||
"name": "run",
|
||||
"source": "../../engineering/agenthub/skills/run",
|
||||
"category": "engineering-advanced",
|
||||
"description": "One-shot lifecycle command that chains init \u2192 baseline \u2192 spawn \u2192 eval \u2192 merge in a single invocation."
|
||||
},
|
||||
{
|
||||
"name": "run",
|
||||
"source": "../../engineering/autoresearch-agent/skills/run",
|
||||
"category": "engineering-advanced",
|
||||
"description": "Run a single experiment iteration. Edit the target file, evaluate, keep or discard."
|
||||
},
|
||||
{
|
||||
"name": "run",
|
||||
"source": "../../engineering/agenthub/skills/run",
|
||||
"category": "engineering-advanced",
|
||||
"description": "One-shot lifecycle command that chains init \u2192 baseline \u2192 spawn \u2192 eval \u2192 merge in a single invocation."
|
||||
},
|
||||
{
|
||||
"name": "runbook-generator",
|
||||
"source": "../../engineering/skills/runbook-generator",
|
||||
|
|
@ -1157,18 +1157,18 @@
|
|||
"category": "engineering-advanced",
|
||||
"description": "Run hypothesis tests, analyze A/B experiment results, calculate sample sizes, and interpret statistical significance with effect sizes. Use when you need to validate whether observed differences are real, size an experiment correctly before launch, or interpret test results with confidence."
|
||||
},
|
||||
{
|
||||
"name": "status",
|
||||
"source": "../../engineering/agenthub/skills/status",
|
||||
"category": "engineering-advanced",
|
||||
"description": "Show DAG state, agent progress, and branch status for an AgentHub session."
|
||||
},
|
||||
{
|
||||
"name": "status",
|
||||
"source": "../../engineering/autoresearch-agent/skills/status",
|
||||
"category": "engineering-advanced",
|
||||
"description": "Show experiment dashboard with results, active loops, and progress."
|
||||
},
|
||||
{
|
||||
"name": "status",
|
||||
"source": "../../engineering/agenthub/skills/status",
|
||||
"category": "engineering-advanced",
|
||||
"description": "Show DAG state, agent progress, and branch status for an AgentHub session."
|
||||
},
|
||||
{
|
||||
"name": "tc-tracker",
|
||||
"source": "../../engineering/skills/tc-tracker",
|
||||
|
|
|
|||
|
|
@ -1 +1 @@
|
|||
../../engineering-team/self-improving-agent/skills/review
|
||||
../../engineering-team/playwright-pro/skills/review
|
||||
|
|
@ -1 +1 @@
|
|||
../../engineering/autoresearch-agent/skills/run
|
||||
../../engineering/agenthub/skills/run
|
||||
|
|
@ -1 +1 @@
|
|||
../../engineering/autoresearch-agent/skills/status
|
||||
../../engineering/agenthub/skills/status
|
||||
86
CHANGELOG.md
86
CHANGELOG.md
|
|
@ -5,6 +5,92 @@ All notable changes to the Claude Skills Library will be documented in this file
|
|||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [2.7.3] - 2026-05-17 — aeo-box port: AEO skill + security-guidance PreToolUse hook
|
||||
|
||||
### Added
|
||||
|
||||
**Ported `alirezarezvani/aeo-box` after a full component audit.** Two new skills, one preserved megaprompt, and a Hermes Agent install/configure walkthrough.
|
||||
|
||||
#### `marketing-skill/skills/aeo/` — Answer Engine Optimization
|
||||
|
||||
A discipline distinct from SEO. AEO optimizes content for **citation** in LLM-generated responses (ChatGPT, Perplexity, Claude, Gemini, Mistral); SEO optimizes for search rankings. New 8th pod in marketing-skill.
|
||||
|
||||
- `aeo_audit.py` — E-E-A-T + structure scoring, 0-100 composite with letter grade. 8 industries with calibrated thresholds (YMYL industries 85+, SaaS/b2b/media 70, ecommerce 65).
|
||||
- `aeo_optimizer.py` — Content rewriting in 3 modes (conservative/balanced/aggressive). Auto-injects schema.org Article + FAQPage JSON-LD.
|
||||
- `citation_tracker.py` — Local-first citation ledger at `~/.aeo-data/citations.json`. Stats: count, LLM coverage, velocity, top queries, verdict (EARLY / EMERGING / STRONG).
|
||||
- 3 references each citing 8 sources: E-E-A-T canon (Google QRG adapted for LLM citation), per-LLM citation patterns (with 73% cross-LLM correlation analysis), AEO-vs-SEO strategic choice.
|
||||
- `cs-aeo` agent (pragmatic content strategist; refuses fake authority signals) + `/cs:aeo` slash command.
|
||||
|
||||
#### `engineering/security-guidance/` — PreToolUse security hook
|
||||
|
||||
Ported from David Dworken (@dworken) at Anthropic (MIT). PreToolUse hook that catches 12 security anti-patterns in Edit/Write/MultiEdit operations **before** they're written:
|
||||
|
||||
| Pattern | Upstream | Added in this port |
|
||||
|---|:-:|:-:|
|
||||
| `child_process.exec` / `execSync` | ✓ | |
|
||||
| `new Function` | ✓ | |
|
||||
| `eval(` | ✓ | |
|
||||
| `dangerouslySetInnerHTML` | ✓ | |
|
||||
| `document.write` | ✓ | |
|
||||
| `.innerHTML =` | ✓ | |
|
||||
| `pickle` | ✓ | |
|
||||
| `os.system` | ✓ | |
|
||||
| GitHub Actions workflow injection | ✓ | |
|
||||
| `subprocess shell=True` | | ✓ |
|
||||
| SQL via f-string or `.format` | | ✓ |
|
||||
| `yaml.unsafe_load` | | ✓ |
|
||||
|
||||
Session-state caching prevents nagging (warn once per file+rule combo); 30-day auto-cleanup; disable per-session with `ENABLE_SECURITY_REMINDER=0`. Full `attribution` block in plugin.json credits the upstream.
|
||||
|
||||
#### `megaprompts/14-aeo-agentic-megaprompt.md`
|
||||
|
||||
1,579-line multi-agent AEO application spec preserved verbatim. Keeps Path-B option open for future "build the full agentic AEO app" work.
|
||||
|
||||
#### `docs/integrations.md` — Hermes Agent install/configure walkthrough
|
||||
|
||||
Earlier user-flagged docs gap: nowhere did the repo tell users HOW to install Hermes Agent itself (only how to install our skills INTO Hermes). Added macOS/Linux/Windows install paths, complete first-run walkthrough, sample `~/.hermes/config.yaml`, and a 6 Q&A troubleshooting section.
|
||||
|
||||
### Changed
|
||||
|
||||
- **Marketplace**: 55 → 57 plugins. Top-level + metadata descriptions updated to v2.7.3 / 313 skills.
|
||||
- **Domain plugin.json**: `marketing-skill/.claude-plugin/plugin.json` description updated from "44 skills across 7 pods" → "45 skills across 8 pods" (adds AEO pod). Version bumped 2.2.3 → 2.7.3.
|
||||
- **CLAUDE.md**: root + marketing-skill CLAUDE.md refreshed to 313/402/542 counts.
|
||||
- **README.md**: badges (313 / 46+ / 60+), Skills Overview table row counts, FAQ counts.
|
||||
- **docs/index.md + getting-started.md + mkdocs.yml**: title, meta description, hero subtitle, grid cards, nav entries.
|
||||
- **MkDocs**: 401 → 403 generated pages (296 skill + 73 agent + 34 command).
|
||||
|
||||
### Layout fix (during /plugin-audit Phase 7)
|
||||
|
||||
- Moved `marketing-skill/agents/cs-aeo.md` → `agents/marketing/cs-aeo.md` (repo convention: agents live at root `agents/<domain>/`).
|
||||
- Moved `marketing-skill/commands/cs-aeo.md` → `commands/cs-aeo.md` (repo convention: commands live at root `commands/`).
|
||||
- Cleaned empty `marketing-skill/agents/` and `marketing-skill/commands/` directories.
|
||||
- Without this fix, `scripts/generate-docs.py` wouldn't have generated docs/agents/cs-aeo.md or docs/commands/cs-aeo.md.
|
||||
|
||||
### Cross-platform sync
|
||||
|
||||
- `.codex/skills-index.json`: 303 → 305 skills.
|
||||
- `.gemini/skills-index.json`: 353 → 355 items.
|
||||
- `.hermes/skills/claude-skills/skills-index.json`: 305 skills across 12 domains.
|
||||
|
||||
### Honest assessments from /plugin-audit (both skills)
|
||||
|
||||
**aeo**: PASS WITH WARNINGS — structure 86.4/GOOD, quality 52.4/D (validator expects legacy frontmatter fields v2.7 skills don't use), 3/3 scripts PASS, 2 HIGH security findings (NET-EXFIL from `urllib.request` — same known false-positive as sister `seo-audit` skill; URL fetch is core functionality for content-audit-by-URL tools).
|
||||
|
||||
**security-guidance**: PASS WITH WARNINGS — structural mismatch (validators assume `scripts/` layout, hook plugins use `hooks/` per Claude Code spec), 6 CRITICAL + 4 HIGH security findings are all recursive false-positives (the auditor detects the hook's own pattern-strings like `"exec("`, `"eval("`, `"yaml.load("` as actual calls — verified zero real exec/eval calls). Live smoke test: `eval(input())` in Write tool → exit 2 + warning. **Real defects: 0.**
|
||||
|
||||
### PRs
|
||||
|
||||
#678 (Hermes first-class integration) → #679 (aeo-box port + Hermes install guide) → this PR (v2.7.3 release: docs sync + layout fix + CHANGELOG + audit).
|
||||
|
||||
### Verification
|
||||
|
||||
- All 4 new Python tools pass `--help` and `--sample`.
|
||||
- Security hook smoke-tested: exit 2 on detection, exit 0 on cached/clean.
|
||||
- All 3 cross-platform syncs ran clean.
|
||||
- MkDocs build: exit 0, 450 HTML pages generated.
|
||||
|
||||
---
|
||||
|
||||
## [2.7.0] - 2026-05-16 — v2 megaprompt-to-skill conversion sweep: 13 new skills (productivity + marketing + research)
|
||||
|
||||
### Added — 13 Path-B Skills From `megaprompts/`
|
||||
|
|
|
|||
27
CLAUDE.md
27
CLAUDE.md
|
|
@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|||
|
||||
This is a **comprehensive skills library** for Claude AI and Claude Code - reusable, production-ready skill packages that bundle domain expertise, best practices, analysis tools, and strategic frameworks. The repository provides modular skills that teams can download and use directly in their workflows.
|
||||
|
||||
**Current Scope:** 311 production-ready skills across 12 domains with ~398 Python automation tools, ~538 reference guides, 45+ agents (cs-* + 7 personas), and 59+ slash commands. v2.7.0 adds 13 Path-B skills across 3 new top-level domains (productivity, marketing, research). v2.6.0 added 4 Matt Pocock-derived productivity skills (write-a-skill, caveman, grill-me, handoff) under MIT.
|
||||
**Current Scope:** 313 production-ready skills across 12 domains with ~402 Python automation tools, ~542 reference guides, 46+ agents (cs-* + 7 personas), and 60+ slash commands. v2.7.3 ports `alirezarezvani/aeo-box` — AEO (Answer Engine Optimization) skill into marketing-skill/ + security-guidance PreToolUse hook into engineering/, both built fresh on top of upstream MIT-licensed sources. v2.7.0 added 13 Path-B skills across 3 new top-level domains (productivity, marketing, research). v2.6.0 added 4 Matt Pocock-derived productivity skills (write-a-skill, caveman, grill-me, handoff) under MIT.
|
||||
|
||||
**Key Distinction**: This is NOT a traditional application. It's a library of skill packages meant to be extracted and deployed by users into their own Claude workflows.
|
||||
|
||||
|
|
@ -124,7 +124,22 @@ See [standards/git/git-workflow-standards.md](standards/git/git-workflow-standar
|
|||
|
||||
## Current Version
|
||||
|
||||
**Version:** v2.7.0 (latest)
|
||||
**Version:** v2.7.3 (latest)
|
||||
|
||||
**v2.7.3 Highlights — aeo-box port: AEO skill + security-guidance PreToolUse hook + master prompt preserved:**
|
||||
|
||||
Ported `alirezarezvani/aeo-box` after a full component audit. Distilled the valuable parts into our conventions; skipped repo-specific infra (generic agents, GH workflows, TS scripts).
|
||||
|
||||
- **`marketing-skill/skills/aeo/`** (new, 8 files, ~3,200 LOC) — Answer Engine Optimization skill, a discipline distinct from SEO. 3 stdlib Python tools: `aeo_audit.py` (E-E-A-T + structure scoring, 0-100 composite, 8 industries with calibrated thresholds where YMYL industries hit 85+, SaaS/b2b/media 70, ecommerce 65), `aeo_optimizer.py` (conservative/balanced/aggressive rewrites + schema.org JSON-LD injection), `citation_tracker.py` (local-first citation ledger at `~/.aeo-data/citations.json` with verdict EARLY/EMERGING/STRONG). 3 references each citing 8 sources: E-E-A-T canon, per-LLM citation patterns (Perplexity / ChatGPT / Claude / Gemini / Mistral with 73% cross-LLM correlation analysis), AEO vs. SEO strategic choice. New `cs-aeo` agent + `/cs:aeo` slash command. New 8th pod ("AEO") added to marketing-skill.
|
||||
- **`engineering/security-guidance/`** (new, 5 files) — PreToolUse security reminder hook ported from David Dworken @ Anthropic (MIT). Preserves 9 upstream patterns verbatim (eval, pickle, dangerouslySetInnerHTML, innerHTML, document.write, new Function, child_process.exec, os.system, GH Actions workflow injection) + adds 3 new patterns (subprocess shell=True, SQL f-string injection, yaml.unsafe_load). Session-state caching prevents nagging (warn once per file+rule combo), 30-day auto-cleanup, disable via `ENABLE_SECURITY_REMINDER=0`. `attribution` block in plugin.json credits upstream. Reference doc `pretooluse_hook_canon.md` cites 8 sources on hook design discipline.
|
||||
- **`megaprompts/14-aeo-agentic-megaprompt.md`** — 1,579-line multi-agent AEO application spec preserved verbatim. Keeps Path-B option open for future "build the full agentic AEO app" work.
|
||||
- **Marketplace + Codex registry:** 55 → 57 plugins; 303 → 305 indexed skills; `marketing-skill/.claude-plugin/plugin.json` description updated from 7 → 8 pods.
|
||||
- **Verification:** all 4 new Python tools pass `--help` and `--sample`; security hook smoke-tested (exits 2 on detection, 0 on cached/clean); all 3 cross-platform syncs (.codex / .gemini / .hermes) re-ran clean.
|
||||
- **PRs:** #678 (Hermes first-class integration, merged) → #679 (aeo-box port + Hermes install guide, merged).
|
||||
|
||||
**Total scope after v2.7.3:** 313 skills across 12 domain folders, ~402 Python automation tools, ~542 reference guides, 46+ agents, 60+ slash commands.
|
||||
|
||||
**Version:** v2.7.0
|
||||
|
||||
**v2.7.0 Highlights — v2 megaprompt-to-skill conversion sweep: 13 new skills across productivity + marketing + research:**
|
||||
|
||||
|
|
@ -139,7 +154,7 @@ This release ships the complete v2 megaprompt collection (`megaprompts/01-13`) a
|
|||
- **Verification:** 39/39 scripts pass `--help`; 8-phase plugin audit on orchestrator → PASS WITH WARNINGS (structure 84.1/GOOD, scripts 3/3, 0 critical/high security findings); bulk audit on 12 siblings → all 79.5-86.4 structure, 0 critical/high findings.
|
||||
- **PRs:** #659 (capture) → #660 (pulse) → #661 (email pair) → #662 (landing) → #663 (litreview) → #664 (grants+dossier) → #666 (patent+syllabus) → #667 (domain-folder cleanup) → #668 (reflect) → #669 (notebooklm) → #671 (research orchestrator) → #672 (v2.7.0 release prep).
|
||||
|
||||
**Total scope after v2.7.0:** 311 skills across 12 domain folders, ~398 Python automation tools, ~538 reference guides, 45+ agents, 59+ slash commands.
|
||||
**Total scope after v2.7.0:** 311 skills across 12 domain folders, ~398 Python automation tools, ~538 reference guides, 45+ agents, 59+ slash commands. (Superseded by v2.7.3 totals above.)
|
||||
|
||||
**Version:** v2.6.1
|
||||
|
||||
|
|
@ -316,6 +331,6 @@ This repository publishes skills to **ClawHub** (clawhub.com) as the distributio
|
|||
|
||||
---
|
||||
|
||||
**Last Updated:** May 11, 2026
|
||||
**Version:** v2.4.5
|
||||
**Status:** 246 skills deployed across 9 domains, 33 marketplace plugins, docs site live
|
||||
**Last Updated:** May 17, 2026
|
||||
**Version:** v2.7.3
|
||||
**Status:** 313 skills deployed across 12 domains, 57 marketplace plugins, docs site live
|
||||
|
|
|
|||
26
README.md
26
README.md
|
|
@ -1,18 +1,18 @@
|
|||
# Claude Code Skills & Plugins — Agent Skills for Every Coding Tool
|
||||
|
||||
**311 production-ready Claude Code skills, plugins, and agent skills for 12 AI coding tools.**
|
||||
**313 production-ready Claude Code skills, plugins, and agent skills for 12 AI coding tools.**
|
||||
|
||||
The most comprehensive open-source library of Claude Code skills and agent plugins — also works with OpenAI Codex, Gemini CLI, Cursor, and 7 more coding agents. Reusable expertise packages covering engineering, DevOps, marketing, compliance, C-level advisory (incl. founder-mode CFO/CMO/CRO/CPO/COO/CHRO/CISO/GC/CDO/CAIO/CCO/VPE personas + 21 /cs:* slash commands), productivity (capture/email/reflect), and a complete research stack (litreview/grants/dossier/patent/syllabus/pulse/notebooklm + hybrid router).
|
||||
The most comprehensive open-source library of Claude Code skills and agent plugins — also works with OpenAI Codex, Gemini CLI, Cursor, and 7 more coding agents. Reusable expertise packages covering engineering, DevOps, marketing (incl. v2.7.3 AEO — Answer Engine Optimization for LLM citation), security (PreToolUse hooks), compliance, C-level advisory (incl. founder-mode CFO/CMO/CRO/CPO/COO/CHRO/CISO/GC/CDO/CAIO/CCO/VPE personas + 21 /cs:* slash commands), productivity (capture/email/reflect), and a complete research stack (litreview/grants/dossier/patent/syllabus/pulse/notebooklm + hybrid router).
|
||||
|
||||
**Works with:** Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Hermes Agent[^hermes] · Cursor · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity
|
||||
|
||||
[^hermes]: Hermes Agent is **BYO-sync tier**: the repo ships a pre-generated `.hermes/skills/claude-skills/` tree (303 skills across 12 domains as of v2.7.2), but you run `python scripts/sync-hermes-skills.py` once locally to install into `~/.hermes/skills/`. Uses the same agentskills.io SKILL.md standard — no format conversion.
|
||||
[^hermes]: Hermes Agent is **BYO-sync tier**: the repo ships a pre-generated `.hermes/skills/claude-skills/` tree (305 skills across 12 domains as of v2.7.3), but you run `python scripts/sync-hermes-skills.py` once locally to install into `~/.hermes/skills/`. Uses the same agentskills.io SKILL.md standard — no format conversion.
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](#skills-overview)
|
||||
[](#agents)
|
||||
[](#skills-overview)
|
||||
[](#agents)
|
||||
[](#personas)
|
||||
[](#commands)
|
||||
[](#commands)
|
||||
[](https://github.com/alirezarezvani/claude-skills/stargazers)
|
||||
[](https://getskillcheck.com)
|
||||
|
||||
|
|
@ -25,10 +25,10 @@ The most comprehensive open-source library of Claude Code skills and agent plugi
|
|||
Claude Code skills (also called agent skills or coding agent plugins) are modular instruction packages that give AI coding agents domain expertise they don't have out of the box. Each skill includes:
|
||||
|
||||
- **SKILL.md** — structured instructions, workflows, and decision frameworks
|
||||
- **Python tools** — ~398 CLI scripts (all stdlib-only, zero pip installs)
|
||||
- **Python tools** — ~402 CLI scripts (all stdlib-only, zero pip installs)
|
||||
- **Reference docs** — templates, checklists, and domain-specific knowledge
|
||||
|
||||
**One repo, eleven platforms.** Works natively as Claude Code plugins, Codex agent skills, Gemini CLI skills, and converts to 8 more tools via `scripts/convert.sh`. All ~398 Python tools run anywhere Python runs.
|
||||
**One repo, eleven platforms.** Works natively as Claude Code plugins, Codex agent skills, Gemini CLI skills, and converts to 8 more tools via `scripts/convert.sh`. All ~402 Python tools run anywhere Python runs.
|
||||
|
||||
### Skills vs Agents vs Personas
|
||||
|
||||
|
|
@ -148,16 +148,16 @@ Run `./scripts/convert.sh --tool all` to generate tool-specific outputs locally.
|
|||
|
||||
## Skills Overview
|
||||
|
||||
**311 skills across 12 domains:**
|
||||
**313 skills across 12 domains:**
|
||||
|
||||
| Domain | Skills | Highlights | Details |
|
||||
|--------|--------|------------|---------|
|
||||
| **🔧 Engineering — Core** | 32 | Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright, self-improving agent, security suite (6), a11y audit | [engineering-team/](engineering-team/) |
|
||||
| **🎭 Playwright Pro** | 9+3 | Test generation, flaky fix, Cypress/Selenium migration, TestRail, BrowserStack, 55 templates | [engineering-team/playwright-pro](engineering-team/playwright-pro/) |
|
||||
| **🧠 Self-Improving Agent** | 5+2 | Auto-memory curation, pattern promotion, skill extraction, memory health | [engineering-team/self-improving-agent](engineering-team/self-improving-agent/) |
|
||||
| **⚡ Engineering — POWERFUL** | 44 | Agent designer, RAG architect, database designer, CI/CD builder, security auditor, MCP builder, AgentHub, Helm charts, Terraform, self-eval, llm-wiki, tc-tracker, **reliability portfolio** (feature-flags-architect, kubernetes-operator, chaos-engineering, slo-architect), ship-gate, **Matt Pocock skills** (write-a-skill, caveman, grill-me, handoff, grill-with-docs) | [engineering/](engineering/) |
|
||||
| **⚡ Engineering — POWERFUL** | 45 | Agent designer, RAG architect, database designer, CI/CD builder, security auditor, MCP builder, AgentHub, Helm charts, Terraform, self-eval, llm-wiki, tc-tracker, **reliability portfolio** (feature-flags-architect, kubernetes-operator, chaos-engineering, slo-architect), ship-gate, **security-guidance** (✨v2.7.3 — PreToolUse hook catching 12 anti-patterns), **Matt Pocock skills** (write-a-skill, caveman, grill-me, handoff, grill-with-docs) | [engineering/](engineering/) |
|
||||
| **🎯 Product** | 13 | Product manager, agile PO, strategist, UX researcher, UI design, landing pages, SaaS scaffolder, analytics, experiment designer, discovery, roadmap communicator, code-to-prd, apple-hig-expert | [product-team/](product-team/) |
|
||||
| **📣 Marketing** | 44 | 7 pods: Content (8), SEO (5), CRO (6), Channels (6), Growth (4), Intelligence (4), Sales (2) + context foundation + orchestration router. 32 Python tools. | [marketing-skill/](marketing-skill/) |
|
||||
| **📣 Marketing** | 45 | 8 pods: Content (8), SEO + AEO (6 incl. ✨v2.7.3 `aeo` — E-E-A-T audit, citation tracking across 5 LLMs), CRO (6), Channels (6), Growth (4), Intelligence (4), Sales (2) + context foundation + orchestration router. 58 Python tools. | [marketing-skill/](marketing-skill/) |
|
||||
| **🚀 Productivity** ✨v2.7.0 | 4 | `capture` (brain-dump-to-action), `email` pair (inbox-setup + inbox-triage with 7-file KB contract), `reflect` (light-prompt journal). Path-B from megaprompts 05-08. | [productivity/](productivity/) |
|
||||
| **🎨 Marketing (top-level)** ✨v2.7.0 | 1 | `landing` — single-file HTML landing-page generator (4 design styles, GSAP patterns, brand palette validator). Path-B from megaprompt 04. | [marketing/](marketing/) |
|
||||
| **🔬 Research** ✨v2.7.0 | 8 | `research` orchestrator (hybrid router + fallback, megaprompt 13) + 7 specialists: `pulse` (recency), `litreview` (academic), `grants` (NIH), `dossier` (entity), `patent` (prior-art), `syllabus` (course reading), `notebooklm` (browser-automation). | [research/](research/) |
|
||||
|
|
@ -302,7 +302,7 @@ for MDR Annex II compliance gaps.
|
|||
|
||||
## Python Analysis Tools
|
||||
|
||||
305 CLI tools ship with the skills (all verified, stdlib-only):
|
||||
~402 CLI tools ship with the skills (all verified, stdlib-only):
|
||||
|
||||
```bash
|
||||
# SaaS health check
|
||||
|
|
@ -349,7 +349,7 @@ Yes. Skills work natively with 12 tools: Claude Code, OpenAI Codex, Gemini CLI,
|
|||
No. We follow semantic versioning and maintain backward compatibility within patch releases. Existing script arguments, plugin source paths, and SKILL.md structures are never changed in patch versions. See the [CHANGELOG](CHANGELOG.md) for details on each release.
|
||||
|
||||
**Are the Python tools dependency-free?**
|
||||
Yes. All 305 Python CLI tools use the standard library only — zero pip installs required. Every script is verified to run with `--help`.
|
||||
Yes. All ~402 Python CLI tools use the standard library only — zero pip installs required. Every script is verified to run with `--help`.
|
||||
|
||||
**How do I create my own Claude Code skill?**
|
||||
Each skill is a folder with a `SKILL.md` (frontmatter + instructions), optional `scripts/`, `references/`, and `assets/`. See the [Skills & Agents Factory](https://github.com/alirezarezvani/claude-code-skills-agents-factory) for a step-by-step guide.
|
||||
|
|
|
|||
92
docs/agents/cs-aeo.md
Normal file
92
docs/agents/cs-aeo.md
Normal file
|
|
@ -0,0 +1,92 @@
|
|||
---
|
||||
title: "AEO Agent — Answer Engine Optimization Specialist — AI Coding Agent & Codex Skill"
|
||||
description: "Answer Engine Optimization (AEO) specialist agent. Use when content needs to be optimized for citation by AI language models (ChatGPT, Perplexity. Agent-native orchestrator for Claude Code, Codex, Gemini CLI."
|
||||
---
|
||||
|
||||
# AEO Agent — Answer Engine Optimization Specialist
|
||||
|
||||
<div class="page-meta" markdown>
|
||||
<span class="meta-badge">:material-robot: Agent</span>
|
||||
<span class="meta-badge">:material-bullhorn-outline: Marketing</span>
|
||||
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/agents/marketing/cs-aeo.md">Source</a></span>
|
||||
</div>
|
||||
|
||||
|
||||
## Voice
|
||||
|
||||
**Opening (no AEO context yet):**
|
||||
> "Let's get your content cited by LLMs. First — is this a page you want optimized, a list of pages to audit, or a strategy question (AEO vs SEO, which channel to prioritize)?"
|
||||
|
||||
**Refusing fake authority:**
|
||||
> "Adding 'PhD' to your byline without the degree is a fabrication LLMs detect via LinkedIn / academic database cross-reference. It downranks faster than the missing credential ever did. Find your actual expertise + lead with that."
|
||||
|
||||
**Refusing AI-generated AEO content:**
|
||||
> "Pure LLM-generated content is detectable through low semantic distinctiveness. RAG retrieval algorithms specifically deprioritize it. Human-author + LLM-edit beats LLM-author + human-edit. What's your actual angle on this topic?"
|
||||
|
||||
**Distinguishing AEO from SEO when user is confused:**
|
||||
> "SEO is for rankings + clicks. AEO is for getting cited as the authority. Same E-E-A-T foundation but different tactical investments. Tell me which conversion event you care about — clicks or citations — and I'll route accordingly."
|
||||
|
||||
**Audit interpretation:**
|
||||
> "Composite 43/100 (F). The three biggest fixes are: (1) add an author bio with credentials (Expertise dimension is your weakest at 23/100), (2) schema.org Article + FAQPage markup, (3) move your first verifiable fact into the lede. Run the optimizer in `balanced` mode to apply 1+2 automatically; (3) needs your judgment."
|
||||
|
||||
**Citation tracking discipline:**
|
||||
> "Tracking only what you observe. Don't fabricate citations to inflate the report — the velocity metric becomes meaningless. Add real citations you see in LLM responses, with the query that triggered them. After 4-6 weeks you'll have signal on which content gets cited where."
|
||||
|
||||
**Anti-pattern refusal:**
|
||||
> "Optimizing for ChatGPT specifically by gaming Bing's index is a short-term play. The 73% cross-LLM citation correlation means generic E-E-A-T investments pay off across all 5 major LLMs. Pick the shared signals, not the per-LLM hacks."
|
||||
|
||||
Pragmatic-strategist, evidence-first, refuses-fake-authority.
|
||||
|
||||
## Purpose
|
||||
|
||||
The cs-aeo agent orchestrates the `aeo` skill as the **AEO specialist** for the marketing domain:
|
||||
|
||||
1. **Minimal intake** — Q1 (page or strategy?) + Q2 (industry) + Q3 (mode for optimization runs)
|
||||
2. **Audit-first workflow** — never optimize before auditing; the audit informs the priority order of fixes
|
||||
3. **Citation tracking ledger** — establishes baseline + tracks velocity over 4-12 weeks
|
||||
4. **Cross-LLM strategy** — explicitly handles per-LLM tradeoffs (Perplexity / ChatGPT / Claude / Gemini / Mistral)
|
||||
5. **SEO compatibility** — refuses to optimize at expense of existing SEO investments
|
||||
6. **Industry-aware** — calibrates thresholds to YMYL constraints (healthcare, finance, legal stricter)
|
||||
|
||||
Differentiates from siblings:
|
||||
|
||||
- **vs `marketing-skill/skills/seo-audit`**: SEO audit optimizes for ranking + click-through; AEO audits for LLM citation. Both can run on the same content.
|
||||
- **vs `marketing-skill/skills/content-strategy`**: content-strategy plans WHAT to write; cs-aeo optimizes WHAT'S BEEN WRITTEN for AI citation.
|
||||
- **vs `marketing-skill/skills/schema-markup`**: schema-markup implements; cs-aeo prescribes which schema to add based on content type.
|
||||
|
||||
**Hard rules:**
|
||||
|
||||
1. **Audit before optimize.** Always run `aeo_audit.py` before running `aeo_optimizer.py`. The optimizer's recommendations come from the audit's gap analysis.
|
||||
2. **Industry-aware.** Healthcare / finance / legal content uses 85+ composite threshold (vs 70 default). Refuse to optimize YMYL content below threshold without flagging.
|
||||
3. **No fabricated signals.** Refuse to add credentials, schema, or citations that aren't verifiably real.
|
||||
4. **No per-LLM optimization tunnel-vision.** Track cross-LLM signals (E-E-A-T, schema) over per-LLM hacks.
|
||||
5. **One question per turn.** Never bundle intake.
|
||||
6. **Local-first.** All data (citations, audits, patterns) stays in `~/.aeo-data/` — no telemetry.
|
||||
|
||||
## Skill Integration
|
||||
|
||||
**Skill location:** `marketing-skill/skills/aeo/`
|
||||
|
||||
### Python Tools (stdlib only)
|
||||
|
||||
1. **`aeo_audit.py`** — E-E-A-T + structure auditor. Returns composite 0-100 with per-dimension breakdown + top fixes
|
||||
2. **`aeo_optimizer.py`** — Generates optimized variants in conservative/balanced/aggressive modes
|
||||
3. **`citation_tracker.py`** — Local-first citation ledger; add/list/report/export actions
|
||||
|
||||
### Reference docs (each cites 7+ sources)
|
||||
|
||||
- `references/aeo_eeat_canon.md` — E-E-A-T methodology for AI citation (8 sources)
|
||||
- `references/llm_citation_patterns.md` — How each major LLM chooses sources (8 sources)
|
||||
- `references/aeo_vs_seo.md` — The two disciplines, overlap, and strategic choice (8 sources)
|
||||
|
||||
## Related Agents
|
||||
|
||||
- [cs-content-creator](cs-content-creator.md) — marketing-domain content writer
|
||||
- [cs-seo-audit](cs-seo-audit.md) — companion SEO audit (often run together)
|
||||
- DIFFERENT use case: `engineering/autoresearch-agent` (Karpathy's file-optimization loop — orthogonal)
|
||||
|
||||
---
|
||||
|
||||
**Version:** 2.7.3
|
||||
**Source:** Ported from [`alirezarezvani/aeo-box`](https://github.com/alirezarezvani/aeo-box) `answer-engine-optimization/` skill
|
||||
**License:** MIT
|
||||
|
|
@ -1,13 +1,13 @@
|
|||
---
|
||||
title: "AI Coding Agents — Agent-Native Orchestrators & Codex Skills"
|
||||
description: "72 agent-native orchestrators for Claude Code, Codex CLI, and Gemini CLI — multi-skill AI agents across engineering, product, marketing, and more."
|
||||
description: "73 agent-native orchestrators for Claude Code, Codex CLI, and Gemini CLI — multi-skill AI agents across engineering, product, marketing, and more."
|
||||
---
|
||||
|
||||
<div class="domain-header" markdown>
|
||||
|
||||
# :material-robot: Agents
|
||||
|
||||
<p class="domain-count">72 agents that orchestrate skills across domains</p>
|
||||
<p class="domain-count">73 agents that orchestrate skills across domains</p>
|
||||
|
||||
</div>
|
||||
|
||||
|
|
@ -79,6 +79,12 @@ description: "72 agent-native orchestrators for Claude Code, Codex CLI, and Gemi
|
|||
|
||||
Finance
|
||||
|
||||
- :material-bullhorn-outline:{ .lg .middle } **[AEO Agent — Answer Engine Optimization Specialist](cs-aeo.md)**
|
||||
|
||||
---
|
||||
|
||||
Marketing
|
||||
|
||||
- :material-bullhorn-outline:{ .lg .middle } **[Content Creator Agent](cs-content-creator.md)**
|
||||
|
||||
---
|
||||
|
|
|
|||
171
docs/commands/cs-aeo.md
Normal file
171
docs/commands/cs-aeo.md
Normal file
|
|
@ -0,0 +1,171 @@
|
|||
---
|
||||
title: "/cs-aeo — Slash Command for AI Coding Agents"
|
||||
description: "/cs:aeo — Answer Engine Optimization workflow. Audit content for E-E-A-T + structure signals that drive LLM citation (ChatGPT, Perplexity, Claude. Slash command for Claude Code, Codex CLI, Gemini CLI."
|
||||
---
|
||||
|
||||
# /cs-aeo
|
||||
|
||||
<div class="page-meta" markdown>
|
||||
<span class="meta-badge">:material-console: Slash Command</span>
|
||||
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/commands/cs-aeo.md">Source</a></span>
|
||||
</div>
|
||||
|
||||
|
||||
**Command:** `/cs:aeo [action] [args]`
|
||||
|
||||
The `cs-aeo` command is the **entry point for AEO workflows**: audit → optimize → publish → track citations.
|
||||
|
||||
## Distinct From `/cs:seo-audit`
|
||||
|
||||
These share a foundation (E-E-A-T) but optimize for different conversion events:
|
||||
|
||||
- **`/cs:seo-audit`** — optimizes for ranking + click-through in Google/Bing search results
|
||||
- **`/cs:aeo`** (this command) — optimizes for being cited as authoritative source by LLMs
|
||||
|
||||
They can run on the same content. The cs-aeo agent will surface this and recommend running both for high-leverage pages.
|
||||
|
||||
## When To Run
|
||||
|
||||
- Auditing existing content for AI-search readiness (E-E-A-T + structure signals)
|
||||
- Optimizing a page for LLM citation before publishing
|
||||
- Tracking which LLMs cite which pages over time (citation ledger)
|
||||
- Researching whether AEO investment is worth it for a given content piece
|
||||
- Benchmarking against competitor citation rates
|
||||
|
||||
## When NOT To Run
|
||||
|
||||
- Pure click-through SEO without AI-citation intent → use `/cs:seo-audit`
|
||||
- Brand-voice content with no factual claims (citations require facts)
|
||||
- Time-sensitive news (LLM training lag means citation comes months later)
|
||||
- Topics where LLMs already have strong training (e.g., elementary math)
|
||||
|
||||
## Actions
|
||||
|
||||
### `audit` — Score content for AEO readiness
|
||||
|
||||
```bash
|
||||
/cs:aeo audit --input post.md --industry saas
|
||||
/cs:aeo audit --url https://example.com/blog/post --industry healthcare
|
||||
/cs:aeo audit --sample
|
||||
```
|
||||
|
||||
Returns composite 0-100 with per-dimension breakdown (E-E-A-T + Structure) and top 5 fixes in priority order.
|
||||
|
||||
### `optimize` — Generate AEO-improved variant
|
||||
|
||||
```bash
|
||||
/cs:aeo optimize --input post.md --mode balanced --output post-aeo.md
|
||||
/cs:aeo optimize --input post.md --mode aggressive --industry finance
|
||||
```
|
||||
|
||||
Three modes:
|
||||
- `conservative` — touch <10% of words (schema + corrections footer only)
|
||||
- `balanced` — touch <30% (citation markers + heading restructure + schema + footer)
|
||||
- `aggressive` — full restructure + fact-first lede + maximum citation density
|
||||
|
||||
### `track` — Log a citation you observed in an LLM response
|
||||
|
||||
```bash
|
||||
/cs:aeo track --url https://example.com/post --llm perplexity --query "what is AEO" --date 2026-05-17
|
||||
```
|
||||
|
||||
Maintains a local ledger at `~/.aeo-data/citations.json`. No telemetry.
|
||||
|
||||
### `report` — Aggregate citation report for a URL
|
||||
|
||||
```bash
|
||||
/cs:aeo report --url https://example.com/post
|
||||
```
|
||||
|
||||
Returns total citations, LLM coverage, velocity, top queries, verdict (EARLY / EMERGING / STRONG).
|
||||
|
||||
### `export` — Emit citation ledger as CSV
|
||||
|
||||
```bash
|
||||
/cs:aeo export --output citations.csv
|
||||
```
|
||||
|
||||
For reporting to clients / stakeholders.
|
||||
|
||||
## Minimal Intake (3 Questions)
|
||||
|
||||
| Q | Asks | When |
|
||||
|---|---|---|
|
||||
| Q1 | What action — audit / optimize / track / report? | Always |
|
||||
| Q2 | Industry (saas / healthcare / finance / legal / ecommerce / b2b / media / education) | Always (calibrates thresholds) |
|
||||
| Q3 | For `optimize`: mode (conservative / balanced / aggressive)? | Only when action=optimize |
|
||||
|
||||
Most invocations exit intake after Q2.
|
||||
|
||||
## Workflow
|
||||
|
||||
```bash
|
||||
# Phase 1: Audit
|
||||
python3 marketing-skill/skills/aeo/scripts/aeo_audit.py --input <file> --industry <industry>
|
||||
# → composite score 0-100 + top fixes
|
||||
|
||||
# Phase 2: Optimize (if audit < industry threshold)
|
||||
python3 marketing-skill/skills/aeo/scripts/aeo_optimizer.py \
|
||||
--input <file> --mode <mode> --industry <industry> --output <file>-aeo.md
|
||||
# → optimized variant + changelog
|
||||
|
||||
# Phase 3: Publish (manual step — review the optimized variant, then deploy)
|
||||
|
||||
# Phase 4: Track (over 4-12 weeks)
|
||||
python3 marketing-skill/skills/aeo/scripts/citation_tracker.py \
|
||||
--action add --url <url> --llm <llm> --query <query> --date <YYYY-MM-DD>
|
||||
# → ledger updated
|
||||
|
||||
# Phase 5: Report (monthly)
|
||||
python3 marketing-skill/skills/aeo/scripts/citation_tracker.py \
|
||||
--action report --url <url>
|
||||
# → per-URL citation report
|
||||
```
|
||||
|
||||
## Industry-Specific Thresholds
|
||||
|
||||
The auditor calibrates per-industry. YMYL ("Your Money or Your Life") topics use stricter thresholds:
|
||||
|
||||
| Industry | Min Composite | Why |
|
||||
|---|---|---|
|
||||
| Healthcare | 85 | Direct health implications |
|
||||
| Finance | 85 | Real financial decisions |
|
||||
| Legal | 85 | Legal jeopardy if misapplied |
|
||||
| Education | 75 | Learning outcomes |
|
||||
| SaaS, B2B, Media | 70 | Business decisions, moderate stakes |
|
||||
| E-commerce | 65 | Product reviews, lower individual risk |
|
||||
|
||||
Content for YMYL topics scoring below threshold is unlikely to be cited regardless of other signals — the cs-aeo agent will flag this and refuse aggressive optimization until the foundational dimensions improve.
|
||||
|
||||
## Anti-Patterns Rejected
|
||||
|
||||
- LLM-generated AEO content with no human review (RAG retrieval deprioritizes generic LLM output)
|
||||
- Fabricated credentials in author bylines (LLMs cross-reference via LinkedIn/Wikipedia)
|
||||
- Schema spam (false structured-data markup gets filtered)
|
||||
- Authority laundering (linking out doesn't confer authority)
|
||||
- Per-LLM optimization tunnel-vision (73% cross-LLM citation correlation — optimize for shared signals)
|
||||
- Optimizing AEO at expense of SEO (and vice versa) — they complement, don't substitute
|
||||
|
||||
## Trigger Phrases
|
||||
|
||||
- "AEO audit"
|
||||
- "optimize for ChatGPT / Perplexity / Claude / Gemini"
|
||||
- "get cited by [LLM]"
|
||||
- "LLM citation strategy"
|
||||
- "answer engine optimization"
|
||||
- "E-E-A-T audit"
|
||||
- "content for AI search"
|
||||
- "track AI citations"
|
||||
- "schema for AI"
|
||||
|
||||
## Related
|
||||
|
||||
- Agent: [`cs-aeo`](cs-aeo.md)
|
||||
- Skill: [`aeo`](https://github.com/alirezarezvani/claude-skills/tree/main/skills/aeo/SKILL.md)
|
||||
- Companion: `/cs:seo-audit` (SEO + AEO often run together)
|
||||
- Source: ported from [`alirezarezvani/aeo-box`](https://github.com/alirezarezvani/aeo-box)
|
||||
|
||||
---
|
||||
|
||||
**Version:** 2.7.3
|
||||
**License:** MIT
|
||||
|
|
@ -1,13 +1,13 @@
|
|||
---
|
||||
title: "Slash Commands — AI Coding Agent Commands & Codex Shortcuts"
|
||||
description: "33 slash commands for Claude Code, Codex CLI, and Gemini CLI — sprint planning, tech debt analysis, PRDs, OKRs, and more."
|
||||
description: "34 slash commands for Claude Code, Codex CLI, and Gemini CLI — sprint planning, tech debt analysis, PRDs, OKRs, and more."
|
||||
---
|
||||
|
||||
<div class="domain-header" markdown>
|
||||
|
||||
# :material-console: Slash Commands
|
||||
|
||||
<p class="domain-count">33 commands for quick access to common operations</p>
|
||||
<p class="domain-count">34 commands for quick access to common operations</p>
|
||||
|
||||
</div>
|
||||
|
||||
|
|
@ -43,6 +43,12 @@ description: "33 slash commands for Claude Code, Codex CLI, and Gemini CLI — s
|
|||
|
||||
Build competitive matrices with weighted scoring, gap analysis, and market positioning insights.
|
||||
|
||||
- :material-console:{ .lg .middle } **[`/cs-aeo`](cs-aeo.md)**
|
||||
|
||||
---
|
||||
|
||||
Command: /cs:aeo action args
|
||||
|
||||
- :material-console:{ .lg .middle } **[`/financial-health`](financial-health.md)**
|
||||
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Install Agent Skills — Codex, Gemini CLI, OpenClaw Setup
|
||||
description: "How to install 311 Claude Code skills and agent plugins for 12 AI coding tools. Step-by-step setup for Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, and more. v2.7.0 includes 13 new megaprompt-derived productivity, marketing, and research skills."
|
||||
description: "How to install 313 Claude Code skills and agent plugins for 12 AI coding tools. Step-by-step setup for Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Cursor, Aider, Windsurf, and more. v2.7.3 adds AEO (Answer Engine Optimization) + security-guidance PreToolUse hook."
|
||||
---
|
||||
|
||||
# Getting Started
|
||||
|
|
@ -274,7 +274,7 @@ See the [Skills & Agents Factory](https://github.com/alirezarezvani/claude-code-
|
|||
Yes. Run `./scripts/gemini-install.sh` to set up skills for Gemini CLI. A sync script (`scripts/sync-gemini-skills.py`) generates the skills index automatically.
|
||||
|
||||
??? question "Does this work with Cursor, Windsurf, Aider, or other tools?"
|
||||
Yes. All 311 skills can be converted to native formats for Cursor, Aider, Kilo Code, Windsurf, OpenCode, Augment, and Antigravity. Run `./scripts/convert.sh --tool all` and then install with `./scripts/install.sh --tool <name>`. See [Multi-Tool Integrations](integrations.md) for details.
|
||||
Yes. All 313 skills can be converted to native formats for Cursor, Aider, Kilo Code, Windsurf, OpenCode, Augment, and Antigravity. Run `./scripts/convert.sh --tool all` and then install with `./scripts/install.sh --tool <name>`. See [Multi-Tool Integrations](integrations.md) for details.
|
||||
|
||||
??? question "Can I use Agent Skills in ChatGPT?"
|
||||
Yes. We have [6 Custom GPTs](custom-gpts.md) that bring Agent Skills directly into ChatGPT — no installation needed. Just click and start chatting.
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: 311 Agent Skills for Codex, Gemini CLI & OpenClaw
|
||||
description: "311 production-ready Claude Code skills and agent plugins for 12 AI coding tools — including the v2.7.0 megaprompt-derived productivity, marketing, and research stacks (capture, email-pair, reflect, landing, pulse, litreview, grants, dossier, patent, syllabus, notebooklm, research orchestrator) and the v2.6.0 Matt Pocock productivity quartet (write-a-skill, caveman, grill-me, handoff). Engineering, product, marketing, compliance, and finance agent skills for Claude Code, OpenAI Codex, Gemini CLI, Hermes Agent, Cursor, and OpenClaw."
|
||||
title: 313 Agent Skills for Codex, Gemini CLI & OpenClaw
|
||||
description: "313 production-ready Claude Code skills and agent plugins for 12 AI coding tools — including v2.7.3 AEO (Answer Engine Optimization for ChatGPT / Perplexity / Claude / Gemini / Mistral citation) + security-guidance PreToolUse hook, the v2.7.0 megaprompt-derived productivity / marketing / research stacks (capture, email-pair, reflect, landing, pulse, litreview, grants, dossier, patent, syllabus, notebooklm, research orchestrator), and the v2.6.0 Matt Pocock productivity quartet (write-a-skill, caveman, grill-me, handoff). Engineering, product, marketing, compliance, and finance agent skills for Claude Code, OpenAI Codex, Gemini CLI, Hermes Agent, Cursor, and OpenClaw."
|
||||
hide:
|
||||
- toc
|
||||
- edit
|
||||
|
|
@ -14,7 +14,7 @@ hide:
|
|||
|
||||
# Agent Skills
|
||||
|
||||
311 production-ready skills, 45+ cs-* agents (incl. founder-mode C-suite, Matt Pocock productivity quartet, and v2.7.0 megaprompt-derived research stack), 7 personas, and an orchestration protocol for AI coding tools.
|
||||
313 production-ready skills, 46+ cs-* agents (incl. founder-mode C-suite, Matt Pocock productivity quartet, v2.7.0 megaprompt-derived research stack, and v2.7.3 cs-aeo), 7 personas, and an orchestration protocol for AI coding tools.
|
||||
{ .hero-subtitle }
|
||||
|
||||
[Get Started](getting-started.md){ .md-button .md-button--primary }
|
||||
|
|
@ -49,15 +49,15 @@ hide:
|
|||
|
||||
<div class="grid cards" markdown>
|
||||
|
||||
- :material-toolbox:{ .lg .middle } **311 Skills**
|
||||
- :material-toolbox:{ .lg .middle } **313 Skills**
|
||||
|
||||
---
|
||||
|
||||
Production-ready instruction packages with structured workflows, Python automation tools, and reference documentation across 12 domains. v2.7.0 adds 13 Path-B skills (productivity, marketing, research). v2.6.0 added the Matt Pocock productivity quartet under MIT.
|
||||
Production-ready instruction packages with structured workflows, Python automation tools, and reference documentation across 12 domains. v2.7.3 adds AEO (Answer Engine Optimization for LLM citation) and a security-guidance PreToolUse hook. v2.7.0 added 13 Path-B skills (productivity, marketing, research). v2.6.0 added the Matt Pocock productivity quartet under MIT.
|
||||
|
||||
[:octicons-arrow-right-24: Browse skills](skills/index.md)
|
||||
|
||||
- :material-robot:{ .lg .middle } **45+ Agents**
|
||||
- :material-robot:{ .lg .middle } **46+ Agents**
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -1,13 +1,13 @@
|
|||
---
|
||||
title: "Engineering - POWERFUL Skills — Agent Skills & Codex Plugins"
|
||||
description: "71 engineering - powerful skills — advanced agent-native skill and Claude Code plugin for AI agent design, infrastructure, and automation. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw."
|
||||
description: "72 engineering - powerful skills — advanced agent-native skill and Claude Code plugin for AI agent design, infrastructure, and automation. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw."
|
||||
---
|
||||
|
||||
<div class="domain-header" markdown>
|
||||
|
||||
# :material-rocket-launch: Engineering - POWERFUL
|
||||
|
||||
<p class="domain-count">71 skills in this domain</p>
|
||||
<p class="domain-count">72 skills in this domain</p>
|
||||
|
||||
</div>
|
||||
|
||||
|
|
|
|||
171
docs/skills/engineering/security-guidance.md
Normal file
171
docs/skills/engineering/security-guidance.md
Normal file
|
|
@ -0,0 +1,171 @@
|
|||
---
|
||||
title: "Security Guidance Hook — Agent Skill for Codex & OpenClaw"
|
||||
description: "PreToolUse security-anti-pattern hook for Claude Code. Catches 12 common security risks (command injection, XSS, SQL injection, unsafe."
|
||||
---
|
||||
|
||||
# Security Guidance Hook
|
||||
|
||||
<div class="page-meta" markdown>
|
||||
<span class="meta-badge">:material-rocket-launch: Engineering - POWERFUL</span>
|
||||
<span class="meta-badge">:material-identifier: `security-guidance`</span>
|
||||
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/engineering/security-guidance/skills/security-guidance/SKILL.md">Source</a></span>
|
||||
</div>
|
||||
|
||||
<div class="install-banner" markdown>
|
||||
<span class="install-label">Install:</span> <code>claude /plugin install engineering-advanced-skills</code>
|
||||
</div>
|
||||
|
||||
|
||||
**A PreToolUse hook that blocks 12 common security anti-patterns before Claude Code writes them.**
|
||||
|
||||
This skill is a **hook**, not a slash command. Once installed, it runs automatically before every `Edit`, `Write`, or `MultiEdit` operation and warns + blocks if it detects a known dangerous pattern.
|
||||
|
||||
## What It Catches
|
||||
|
||||
The hook scans both:
|
||||
|
||||
- **The file path being edited** — flags GitHub Actions workflow files with risky `${{ }}` patterns
|
||||
- **The content being written** — substring matches against 11 anti-patterns
|
||||
|
||||
| Pattern | Category | Risk |
|
||||
|---|---|---|
|
||||
| GitHub Actions workflow expressions | Path-based | Workflow command injection via untrusted inputs |
|
||||
| `child_process.exec`, `exec(`, `execSync(` | Substring | Node.js command injection |
|
||||
| `new Function` | Substring | JS code injection |
|
||||
| `eval(` | Substring | JS code injection |
|
||||
| `dangerouslySetInnerHTML` | Substring | React XSS |
|
||||
| `document.write` | Substring | DOM XSS |
|
||||
| `.innerHTML =` | Substring | DOM XSS |
|
||||
| `pickle` | Substring | Python deserialization RCE |
|
||||
| `os.system`, `from os import system` | Substring | Python command injection |
|
||||
| `shell=True` (subprocess) | Substring | Python command injection |
|
||||
| f-string SQL or `.format` SQL | Substring | SQL injection |
|
||||
| `yaml.load(`, `yaml.unsafe_load` | Substring | YAML deserialization RCE |
|
||||
|
||||
## How It Works
|
||||
|
||||
1. Claude Code is about to run `Edit`, `Write`, or `MultiEdit`
|
||||
2. PreToolUse hook fires → invokes `security_reminder_hook.py` with the tool input as JSON on stdin
|
||||
3. The hook extracts file_path + content + checks against the pattern table
|
||||
4. If a pattern matches AND this warning hasn't been shown for this file+rule in this session:
|
||||
- Print the warning to stderr (Claude sees it)
|
||||
- Exit code 2 → blocks the tool call
|
||||
- Save the warning key to `~/.claude/security_warnings_state_<session>.json`
|
||||
5. If a pattern matches BUT the warning was already shown this session:
|
||||
- Allow the tool call (exit code 0) — Claude already saw the warning once
|
||||
6. If no pattern matches:
|
||||
- Allow the tool call (exit code 0)
|
||||
|
||||
## Installation
|
||||
|
||||
This plugin ships as a Claude Code plugin with `hooks.json` wiring:
|
||||
|
||||
```bash
|
||||
# In Claude Code:
|
||||
/plugin marketplace add alirezarezvani/claude-skills
|
||||
/plugin install security-guidance@claude-code-skills
|
||||
```
|
||||
|
||||
Once installed, no further configuration needed — the hook runs automatically.
|
||||
|
||||
## Configuration
|
||||
|
||||
Disable per-session via environment variable:
|
||||
|
||||
```bash
|
||||
ENABLE_SECURITY_REMINDER=0 claude
|
||||
# Hook is bypassed for this session
|
||||
```
|
||||
|
||||
Use sparingly — the hook is most useful exactly when you're tempted to disable it (because you're under deadline pressure to ship something you know is sketchy).
|
||||
|
||||
## Per-File Override Pattern
|
||||
|
||||
If a specific file legitimately needs `eval()` or `pickle` (e.g., a sandboxed REPL, a deliberately unsafe parser for a fuzzer), document it in the file with a comment:
|
||||
|
||||
```python
|
||||
# SAFETY: pickle is the required serialization format for this internal tool.
|
||||
# This file does NOT accept untrusted input. See SECURITY.md for boundary analysis.
|
||||
import pickle
|
||||
```
|
||||
|
||||
The hook will still warn on first edit per session. After acknowledging, subsequent edits in the same session are allowed (session-state caching).
|
||||
|
||||
## Why The Patterns Are Substring-Based (Not AST-Based)
|
||||
|
||||
Trade-off: AST-based detection would be more precise (no false positives on string literals containing "eval("). Substring-based is:
|
||||
|
||||
- **Faster** — runs in ms, doesn't parse the file
|
||||
- **Cross-language** — same hook works for JS/TS/Python/YAML/etc.
|
||||
- **Conservative** — false positives are easy to dismiss (one keystroke); false negatives are dangerous
|
||||
|
||||
For 90%+ of cases, substring detection is sufficient. If you need stricter detection, layer in a proper SAST tool (semgrep, CodeQL) as a CI step.
|
||||
|
||||
## State Files
|
||||
|
||||
The hook caches "warning shown" state in `~/.claude/security_warnings_state_<session_id>.json`. These files:
|
||||
|
||||
- Are auto-cleaned after 30 days (10% chance per hook invocation)
|
||||
- Are session-scoped (each Claude session gets its own)
|
||||
- Contain a JSON list of `<file_path>-<rule_name>` keys
|
||||
|
||||
You can safely delete `~/.claude/security_warnings_state_*.json` files at any time — the hook regenerates them on next run.
|
||||
|
||||
## Debug Log
|
||||
|
||||
The hook writes to `~/.claude/security-warnings-log.txt` for debugging hook misfires:
|
||||
|
||||
```bash
|
||||
tail -f ~/.claude/security-warnings-log.txt
|
||||
# Shows JSON decode errors, state-file save failures, etc.
|
||||
```
|
||||
|
||||
(Upstream version wrote to `/tmp/security-warnings-log.txt` — we moved it to `~/.claude/` for persistence across reboots.)
|
||||
|
||||
## Source + Attribution
|
||||
|
||||
This plugin is ported from David Dworken's MIT-licensed implementation in [`alirezarezvani/aeo-box`](https://github.com/alirezarezvani/aeo-box/tree/main/.claude/plugins/security-guidance).
|
||||
|
||||
**Verbatim:** the original 9 patterns (GitHub Actions, child_process.exec, new Function, eval, dangerouslySetInnerHTML, document.write, innerHTML, pickle, os.system) are preserved with their exact warning text.
|
||||
|
||||
**Modifications:**
|
||||
- Added 3 patterns: `subprocess shell=True`, SQL injection via f-string or `.format`, `yaml.unsafe_load`
|
||||
- Debug log moved from `/tmp/security-warnings-log.txt` → `~/.claude/security-warnings-log.txt`
|
||||
- Restructured as a claude-skills plugin with `attribution` block in `plugin.json`
|
||||
|
||||
## Anti-Patterns
|
||||
|
||||
### Disabling the hook by default
|
||||
|
||||
Defeats the purpose. If `ENABLE_SECURITY_REMINDER=0` becomes your default, you've trained yourself to ignore the safety net. Use it only for specific verified-safe operations.
|
||||
|
||||
### Modifying the pattern list without security review
|
||||
|
||||
Anyone can add a pattern. Removing one requires a security review — patterns exist because they map to real CVE classes.
|
||||
|
||||
### Treating session-state as immutable security policy
|
||||
|
||||
The cache prevents nag-spam but is per-session. Don't rely on "I dismissed this once" as long-term policy — use the per-file documentation pattern instead (comment justifying the use).
|
||||
|
||||
## Related Skills
|
||||
|
||||
- `engineering-team/skills/red-team` — adversarial pen-testing
|
||||
- `engineering-team/skills/threat-detection` — threat modeling + detection design
|
||||
- `engineering-team/skills/ai-security` — AI-specific security (prompt injection, etc.)
|
||||
- `engineering/ship-gate` — pre-production audit (8-category, ~89 checks)
|
||||
- `engineering/skill-security-auditor` — security scan for skill packages
|
||||
|
||||
## Trigger Phrases
|
||||
|
||||
- "add security hook"
|
||||
- "block unsafe code before write"
|
||||
- "detect command injection"
|
||||
- "prevent SQL injection patterns"
|
||||
- "warn on eval / pickle / os.system"
|
||||
- "GitHub Actions security hook"
|
||||
|
||||
---
|
||||
|
||||
**Version:** 2.7.3
|
||||
**Source:** Ported from [`alirezarezvani/aeo-box`](https://github.com/alirezarezvani/aeo-box) `.claude/plugins/security-guidance/` (originally by David Dworken at Anthropic, MIT)
|
||||
**License:** MIT
|
||||
225
docs/skills/marketing-skill/aeo.md
Normal file
225
docs/skills/marketing-skill/aeo.md
Normal file
|
|
@ -0,0 +1,225 @@
|
|||
---
|
||||
title: "Answer Engine Optimization (AEO) — Agent Skill for Marketing"
|
||||
description: "Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as."
|
||||
---
|
||||
|
||||
# Answer Engine Optimization (AEO)
|
||||
|
||||
<div class="page-meta" markdown>
|
||||
<span class="meta-badge">:material-bullhorn-outline: Marketing</span>
|
||||
<span class="meta-badge">:material-identifier: `aeo`</span>
|
||||
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/aeo/SKILL.md">Source</a></span>
|
||||
</div>
|
||||
|
||||
<div class="install-banner" markdown>
|
||||
<span class="install-label">Install:</span> <code>claude /plugin install marketing-skills</code>
|
||||
</div>
|
||||
|
||||
|
||||
**Get your content cited by ChatGPT, Perplexity, Claude, Gemini, and Mistral as the authoritative source.**
|
||||
|
||||
AEO is the practice of optimizing content for **citation** in LLM-generated responses — distinct from SEO, which optimizes for search rankings. This skill audits, optimizes, and tracks AEO performance.
|
||||
|
||||
## Distinct From SEO
|
||||
|
||||
| | SEO | AEO |
|
||||
|---|---|---|
|
||||
| **Optimizes for** | Click-through rankings | Being cited as authoritative source |
|
||||
| **Audience** | Humans browsing search results | LLMs answering questions |
|
||||
| **Success metric** | Position 1-10, organic traffic | Citation count across LLMs |
|
||||
| **Key signals** | Backlinks, keywords, page speed | E-E-A-T, structured data, factual density |
|
||||
| **Update cadence** | Weeks-to-months | Days-to-weeks (LLM training cycles) |
|
||||
|
||||
Both can coexist — the same content can rank #1 on Google AND get cited by Perplexity. But the techniques differ: SEO rewards keyword density + backlinks; AEO rewards primary-source signals + structured facts.
|
||||
|
||||
## When To Use
|
||||
|
||||
- Planning a new content piece for an AI-first audience
|
||||
- Auditing existing content for E-E-A-T gaps before AI Overview rollout
|
||||
- Tracking which pages get cited by which LLM (citation ledger)
|
||||
- Researching what queries LLMs cite sources for (vs. what they answer from training)
|
||||
- Benchmarking against competitors' citation rates
|
||||
- Building a long-term AEO strategy aligned with traditional SEO
|
||||
|
||||
## When NOT To Use
|
||||
|
||||
- Pure click-through SEO without LLM-citation intent — use `marketing-skill/skills/seo-audit` instead
|
||||
- Brand-voice content with no factual claims — citations require facts to cite
|
||||
- Content for a topic where LLMs already have strong training signal (e.g., elementary math) — citation upside is minimal
|
||||
- Time-sensitive content (breaking news) — LLM training lag means citations come months later
|
||||
|
||||
## Core Capabilities
|
||||
|
||||
### 1. Content audit + E-E-A-T scoring
|
||||
|
||||
The auditor (`aeo_audit.py`) scores content across 4 dimensions:
|
||||
|
||||
- **Experience**: First-person evidence, dated examples, case studies, "We ran X in 2026" claims
|
||||
- **Expertise**: Author bio, credentials, citations to peer-reviewed sources, technical depth
|
||||
- **Authoritativeness**: External backlinks from authority domains, schema.org markup, structured data
|
||||
- **Trustworthiness**: HTTPS, contact info, transparent corrections, factual density (number of verifiable claims per 1000 words)
|
||||
|
||||
Composite score 0-100 with per-dimension breakdown. Output: markdown report with specific fix recommendations.
|
||||
|
||||
### 2. Content optimization
|
||||
|
||||
The optimizer (`aeo_optimizer.py`) generates AEO-improved variants:
|
||||
|
||||
- **Structure rewrite** — H2/H3 hierarchy optimized for LLM parsing
|
||||
- **Citation density boost** — adds `[1]`-style references with sources
|
||||
- **Schema injection** — generates JSON-LD for FAQ, HowTo, Article schemas
|
||||
- **Fact-first lede** — moves verifiable claims into the first 200 words
|
||||
|
||||
Three modes: `conservative` (touch <10% of words), `balanced` (touch <30%), `aggressive` (rewrite for maximum AEO).
|
||||
|
||||
### 3. Citation tracking
|
||||
|
||||
The tracker (`citation_tracker.py`) maintains a local ledger of citations:
|
||||
|
||||
- Manual entry: paste a citation found in ChatGPT/Perplexity/Claude/Gemini output
|
||||
- Track which URL, which LLM, which query, what date
|
||||
- Compute per-page citation count, citation velocity, LLM coverage
|
||||
- Export to CSV for reporting
|
||||
|
||||
Stores in `~/.aeo-data/citations.json` (local, no telemetry).
|
||||
|
||||
## Workflow
|
||||
|
||||
```
|
||||
1. Audit existing content
|
||||
$ python3 scripts/aeo_audit.py --url https://example.com/blog/post
|
||||
→ markdown report with composite score + 4-dimension breakdown
|
||||
|
||||
2. Apply optimization recommendations
|
||||
$ python3 scripts/aeo_optimizer.py --input post.md --mode balanced --output post-aeo.md
|
||||
→ optimized variant with citations + schema + structural fixes
|
||||
|
||||
3. Publish + monitor
|
||||
$ python3 scripts/citation_tracker.py --action add --url https://example.com/blog/post \
|
||||
--llm perplexity --query "what is AEO" --date 2026-05-17
|
||||
→ adds entry to local citations.json ledger
|
||||
|
||||
4. Report
|
||||
$ python3 scripts/citation_tracker.py --action report --url https://example.com/blog/post
|
||||
→ per-page citation stats: count, LLMs, queries, velocity
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
The skill is industry-aware via per-run `--industry` flag. Supported: `saas`, `healthcare`, `finance`, `legal`, `ecommerce`, `b2b`, `media`, `education`.
|
||||
|
||||
Industry affects:
|
||||
- **Authority signal requirements** — healthcare/finance need stricter source citations
|
||||
- **Fact-checking rigor** — legal/healthcare flag unverifiable claims as critical
|
||||
- **Citation style** — academic vs. trade-journal vs. blog conventions
|
||||
|
||||
Example:
|
||||
```bash
|
||||
python3 scripts/aeo_audit.py --url <url> --industry healthcare
|
||||
# → stricter E-E-A-T thresholds; flags any health claim without primary citation
|
||||
```
|
||||
|
||||
## Output Format
|
||||
|
||||
### Markdown audit report (default)
|
||||
|
||||
```markdown
|
||||
# AEO Audit Report — [Page Title]
|
||||
|
||||
**URL:** https://example.com/blog/post
|
||||
**Date:** 2026-05-17
|
||||
**Industry:** saas
|
||||
**Composite Score:** 72/100 (B+)
|
||||
|
||||
## Dimension Breakdown
|
||||
|
||||
| Dimension | Score | Verdict |
|
||||
|---|---|---|
|
||||
| Experience | 80/100 | Strong — first-person case study present |
|
||||
| Expertise | 65/100 | Author bio missing credentials |
|
||||
| Authoritativeness | 75/100 | 4 backlinks from authority domains |
|
||||
| Trustworthiness | 68/100 | No corrections policy linked |
|
||||
|
||||
## Top 3 Fixes
|
||||
|
||||
1. Add author bio with credentials (Expertise +15)
|
||||
2. Link to corrections policy from footer (Trustworthiness +12)
|
||||
3. Inject FAQ schema for the 5 questions implicit in H2s (Authoritativeness +8)
|
||||
|
||||
## All Recommendations
|
||||
[...]
|
||||
|
||||
## Audit Trail
|
||||
[3-count of analysis steps, sources cited, time taken]
|
||||
```
|
||||
|
||||
### JSON for pipelines
|
||||
|
||||
```bash
|
||||
python3 scripts/aeo_audit.py --url <url> --output json
|
||||
```
|
||||
|
||||
Returns full structured data for integration with content management workflows.
|
||||
|
||||
## Industry-Specific E-E-A-T Thresholds
|
||||
|
||||
| Industry | Min Composite | Critical Signals |
|
||||
|---|---|---|
|
||||
| Healthcare | 85 | Medical reviewer byline, peer-reviewed citations, FDA disclosure |
|
||||
| Finance | 85 | Author CFA/CPA credentials, "not investment advice" disclaimer, dated examples |
|
||||
| Legal | 85 | Jurisdiction disclosed, attorney bio, "not legal advice" disclaimer |
|
||||
| SaaS | 70 | Product manager byline, case study with metrics, ROI calculator |
|
||||
| E-commerce | 65 | Product reviews aggregated, return policy, schema.org Product |
|
||||
| B2B | 70 | Industry analyst quotes, customer logos, ROI data |
|
||||
| Media | 70 | Editorial policy, fact-check link, original reporting |
|
||||
| Education | 75 | Instructor bio, learning outcomes, accreditation if applicable |
|
||||
|
||||
## Anti-Patterns Rejected
|
||||
|
||||
- **Keyword stuffing for AI** — LLMs already extract topic from semantics; keyword density doesn't boost citation likelihood
|
||||
- **Pure AI-generated content with no human review** — generic LLM output gets de-prioritized by RAG retrieval algorithms looking for distinctive signal
|
||||
- **Citation farms / link wheels** — modern LLM RAG penalizes low-authority linked networks
|
||||
- **Schema spam** — false or unverifiable schema.org claims get filtered; only mark up real, verifiable claims
|
||||
- **Optimizing for one LLM at expense of others** — citation distributions are highly correlated across major LLMs because they share training data sources; optimize for the shared signals (E-E-A-T) not per-LLM hacks
|
||||
- **Ignoring SEO entirely** — AEO citations often originate from sources that already rank well organically; AEO and SEO are complements, not substitutes
|
||||
|
||||
## Dependencies
|
||||
|
||||
- **stdlib-only** for all 3 scripts — no `pip install` required
|
||||
- **Optional**: `requests` + `beautifulsoup4` if `--url` mode used (otherwise pass markdown via `--input` for file-based audits)
|
||||
- **Optional**: any LLM API key for `query_research` mode (currently scaffold-only — full LLM-driven query research is roadmap)
|
||||
|
||||
## Storage
|
||||
|
||||
All data is local-first:
|
||||
- `~/.aeo-data/citations.json` — citation ledger
|
||||
- `~/.aeo-data/patterns.json` — success patterns library
|
||||
- `~/.aeo-data/audits/<hash>.md` — saved audit reports
|
||||
|
||||
No telemetry. No cloud sync. Export to CSV anytime via `citation_tracker.py --action export`.
|
||||
|
||||
## Trigger Phrases
|
||||
|
||||
- "AEO audit", "AEO check"
|
||||
- "optimize for ChatGPT / Perplexity / Claude / Gemini"
|
||||
- "get cited by [LLM]"
|
||||
- "LLM citation strategy"
|
||||
- "answer engine optimization"
|
||||
- "content for AI search"
|
||||
- "E-E-A-T audit"
|
||||
- "track AI citations"
|
||||
- "schema for AI"
|
||||
|
||||
## Related Skills
|
||||
|
||||
- `marketing-skill/skills/seo-audit` — traditional click-through SEO
|
||||
- `marketing-skill/skills/programmatic-seo` — template-driven SEO at scale
|
||||
- `marketing-skill/skills/content-strategy` — broader content planning
|
||||
- `marketing-skill/skills/copywriting` — voice + tone
|
||||
- `marketing-skill/skills/schema-markup` — structured data implementation
|
||||
|
||||
---
|
||||
|
||||
**Version:** 2.7.3
|
||||
**Source:** Ported from [`alirezarezvani/aeo-box`](https://github.com/alirezarezvani/aeo-box) (`answer-engine-optimization/` skill, 2,464 LOC across 9 modules). This port distills the 9-module Python toolkit into 3 stdlib CLI tools per the claude-skills convention; preserves the E-E-A-T scoring methodology, citation-tracking schema, and industry-aware thresholds verbatim.
|
||||
**License:** MIT (matches upstream + this repo).
|
||||
|
|
@ -1,13 +1,13 @@
|
|||
---
|
||||
title: "Marketing Skills — Agent Skills & Codex Plugins"
|
||||
description: "45 marketing skills — marketing agent skill and Claude Code plugin for content, SEO, CRO, and growth. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw."
|
||||
description: "46 marketing skills — marketing agent skill and Claude Code plugin for content, SEO, CRO, and growth. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw."
|
||||
---
|
||||
|
||||
<div class="domain-header" markdown>
|
||||
|
||||
# :material-bullhorn-outline: Marketing
|
||||
|
||||
<p class="domain-count">45 skills in this domain</p>
|
||||
<p class="domain-count">46 skills in this domain</p>
|
||||
|
||||
</div>
|
||||
|
||||
|
|
@ -29,6 +29,12 @@ description: "45 marketing skills — marketing agent skill and Claude Code plug
|
|||
|
||||
You are a performance creative director who has written thousands of ads. You know what converts, what gets rejected,...
|
||||
|
||||
- **[Answer Engine Optimization (AEO)](aeo.md)**
|
||||
|
||||
---
|
||||
|
||||
Get your content cited by ChatGPT, Perplexity, Claude, Gemini, and Mistral as the authoritative source.
|
||||
|
||||
- **[AI SEO](ai-seo.md)**
|
||||
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"name": "marketing-skills",
|
||||
"description": "44 production-ready marketing skills across 7 pods: Content (copywriting, content strategy, content production), SEO (audits, schema markup, programmatic SEO, site architecture), CRO (A/B testing, forms, popups, signup flows, pricing, onboarding), Channels (email sequences, social media, paid ads, cold email, X/Twitter growth), Growth (launch strategy, referral programs, free tools), Intelligence (competitor analysis, marketing psychology, analytics tracking), and Sales enablement. Agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw.",
|
||||
"version": "2.2.3",
|
||||
"description": "45 production-ready marketing skills across 8 pods: Content (copywriting, content strategy, content production), SEO + AEO (traditional audits, schema markup, programmatic SEO, site architecture, plus Answer Engine Optimization for LLM citation in ChatGPT/Perplexity/Claude/Gemini/Mistral), CRO (A/B testing, forms, popups, signup flows, pricing, onboarding), Channels (email sequences, social media, paid ads, cold email, X/Twitter growth), Growth (launch strategy, referral programs, free tools), Intelligence (competitor analysis, marketing psychology, analytics tracking), and Sales enablement. Agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw.",
|
||||
"version": "2.7.3",
|
||||
"author": {
|
||||
"name": "Alireza Rezvani",
|
||||
"url": "https://alirezarezvani.com"
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
## For All Agents (Claude Code, Codex CLI, OpenClaw)
|
||||
|
||||
This directory contains 43 marketing skills organized into specialist pods.
|
||||
This directory contains 45 marketing skills organized into 8 specialist pods (Content, SEO + AEO, CRO, Channels, Growth, Intelligence, Sales enablement, Marketing ops).
|
||||
|
||||
### How to Use
|
||||
|
||||
|
|
@ -17,6 +17,7 @@ This directory contains 43 marketing skills organized into specialist pods.
|
|||
- `content-production/` — Write content (blog posts, articles, guides)
|
||||
- `content-strategy/` — Plan what content to create
|
||||
- `ai-seo/` — Optimize for AI search engines (ChatGPT, Perplexity, Google AI)
|
||||
- `aeo/` — Answer Engine Optimization (E-E-A-T scoring, schema injection, citation tracking across LLMs)
|
||||
- `seo-audit/` — Traditional SEO audit
|
||||
- `page-cro/` — Conversion rate optimization
|
||||
- `pricing-strategy/` — Pricing and packaging
|
||||
|
|
@ -25,7 +26,7 @@ This directory contains 43 marketing skills organized into specialist pods.
|
|||
|
||||
### Python Tools
|
||||
|
||||
32 scripts, all stdlib-only. Run directly:
|
||||
58 scripts, all stdlib-only. Run directly:
|
||||
```bash
|
||||
python3 <skill>/scripts/<tool>.py [args]
|
||||
```
|
||||
|
|
@ -33,7 +34,7 @@ No pip install needed. Scripts include embedded samples for demo mode (run with
|
|||
|
||||
### Anti-Patterns
|
||||
|
||||
❌ Don't read all 43 SKILL.md files
|
||||
❌ Don't read all 45 SKILL.md files
|
||||
❌ Don't skip marketing-context.md if it exists
|
||||
❌ Don't use content-creator (deprecated → use content-production)
|
||||
❌ Don't install pip packages for Python tools
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
name: aeo
|
||||
description: Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources. Distinct from SEO: AEO optimizes for citation in LLM-generated responses, not search rankings. Use when planning content for AI-first search audiences, auditing existing content for E-E-A-T signals, tracking which pages get cited by which LLMs, or building a citation-friendly content strategy. Triggers — "AEO audit", "optimize for ChatGPT", "get cited by Perplexity", "LLM citation strategy", "answer engine optimization", "content for AI search", "E-E-A-T audit". Output is a markdown audit report (default) or JSON for pipeline integration. Stdlib-only Python tools.
|
||||
description: "Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources. Distinct from SEO — AEO optimizes for citation in LLM-generated responses, not search rankings. Use when planning content for AI-first search audiences, auditing existing content for E-E-A-T signals, tracking which pages get cited by which LLMs, or building a citation-friendly content strategy. Triggers — 'AEO audit', 'optimize for ChatGPT', 'get cited by Perplexity', 'LLM citation strategy', 'answer engine optimization', 'content for AI search', 'E-E-A-T audit'. Output is a markdown audit report (default) or JSON for pipeline integration. Stdlib-only Python tools."
|
||||
---
|
||||
|
||||
# Answer Engine Optimization (AEO)
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
site_name: Claude Code Skills & Agent Plugins
|
||||
site_url: https://alirezarezvani.github.io/claude-skills/
|
||||
site_description: "311 production-ready skills, 45+ cs-* agents (incl. founder-mode C-suite: GC, CDO, CAIO, CCO, VPE + Matt Pocock-derived productivity quartet: skill-author, caveman, grill-master, handoff + v2.7.0 megaprompt-derived research stack), 7 personas, 59+ /cs:* slash commands, and an orchestration protocol for 12 AI coding tools. v2.7.0 adds 13 new skills across productivity (capture, email pair, reflect), marketing (landing), and research (pulse, litreview, grants, dossier, patent, syllabus, notebooklm + research orchestrator)."
|
||||
site_description: "313 production-ready skills, 46+ cs-* agents (incl. founder-mode C-suite: GC, CDO, CAIO, CCO, VPE + Matt Pocock-derived productivity quartet: skill-author, caveman, grill-master, handoff + v2.7.0 megaprompt-derived research stack + v2.7.3 cs-aeo), 7 personas, 60+ /cs:* slash commands, and an orchestration protocol for 12 AI coding tools. v2.7.3 ports `alirezarezvani/aeo-box` — adds AEO (Answer Engine Optimization for LLM citation across ChatGPT / Perplexity / Claude / Gemini / Mistral) into marketing-skill and a security-guidance PreToolUse hook into engineering."
|
||||
site_author: Alireza Rezvani
|
||||
repo_url: https://github.com/alirezarezvani/claude-skills
|
||||
repo_name: alirezarezvani/claude-skills
|
||||
|
|
@ -221,6 +221,7 @@ nav:
|
|||
- "Release Manager": skills/engineering/release-manager.md
|
||||
- "Runbook Generator": skills/engineering/runbook-generator.md
|
||||
- "Secrets Vault Manager": skills/engineering/secrets-vault-manager.md
|
||||
- "Security Guidance": skills/engineering/security-guidance.md
|
||||
- "Self-Eval": skills/engineering/self-eval.md
|
||||
- "Skill Security Auditor": skills/engineering/skill-security-auditor.md
|
||||
- "Skill Tester": skills/engineering/skill-tester.md
|
||||
|
|
@ -274,6 +275,7 @@ nav:
|
|||
- Overview: skills/marketing-skill/index.md
|
||||
- "A/B Test Setup": skills/marketing-skill/ab-test-setup.md
|
||||
- "Ad Creative": skills/marketing-skill/ad-creative.md
|
||||
- "AEO (Answer Engine Optimization)": skills/marketing-skill/aeo.md
|
||||
- "AI SEO": skills/marketing-skill/ai-seo.md
|
||||
- "Analytics Tracking": skills/marketing-skill/analytics-tracking.md
|
||||
- "App Store Optimization": skills/marketing-skill/app-store-optimization.md
|
||||
|
|
@ -448,6 +450,7 @@ nav:
|
|||
- Custom GPTs: custom-gpts.md
|
||||
- Agents:
|
||||
- Overview: agents/index.md
|
||||
- "CS AEO (Answer Engine Optimization)": agents/cs-aeo.md
|
||||
- "CS Agile Product Owner": agents/cs-agile-product-owner.md
|
||||
- "CS CEO Advisor": agents/cs-ceo-advisor.md
|
||||
- "CS Content Creator": agents/cs-content-creator.md
|
||||
|
|
@ -516,3 +519,4 @@ nav:
|
|||
- "/operator-audit": commands/operator-audit.md
|
||||
- "/chaos-experiment": commands/chaos-experiment.md
|
||||
- "/slo-design": commands/slo-design.md
|
||||
- "/cs:aeo": commands/cs-aeo.md
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue