mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-08-28 04:24:58 +00:00
23eefc2e9a
Phase 3 of the multi-skill build effort. Same 14-step pipeline. Composes
explicitly with feature-flags-architect (kill switches as abort triggers)
and kubernetes-operator (operators are common chaos targets).
## What landed
### New skill: engineering/chaos-engineering
End-to-end chaos engineering discipline. Published as BOTH:
- Standalone plugin: engineering/chaos-engineering/
- Bundled mirror: engineering/skills/chaos-engineering/
3 stdlib-only Python tools (Karpathy complexity 95/100 — best in portfolio):
- experiment_designer.py — generates structured plans with hypothesis,
steady-state, blast radius, abort criteria,
rollback. Refuses to render plans without
abort criteria (exit code 1).
- blast_radius_calculator.py — computes affected users + error budget
consumption + GREEN/YELLOW/RED risk score.
Validates inputs (0 ≤ traffic-share ≤ 1).
- experiment_postmortem.py — blameless postmortems from plan + result log;
detects blame-laden language ("fault of",
"should have known", "stupid", etc.) and
warns at write time.
4 reference docs:
- chaos_principles.md — 4 founding principles + 5th abort principle,
maturity model, history, when-to-start checklist
- experiment_design.md — 7-section plan structure, pre-flight checklist,
time-boxing, escalation
- attack_taxonomy.md — 7 attack types (latency / error / resource /
network-partition / dependency-failure / time-skew
/ infrastructure) with magnitudes and tooling
- tooling_landscape.md — Chaos Toolkit / Mesh / Litmus / Gremlin / AWS FIS
/ DIY decision tree
Templates:
- experiment_template.md — fill-in plan with all 7 sections
- postmortem_template.md — blameless postmortem structure
Plus: SKILL.md (213 lines), README.md, /chaos-experiment slash command.
### Audit verdict (evidence-based)
Closest existing skills:
- engineering-team/incident-response — for actual incidents, not prevention
- engineering-team/red-team — adversarial; different goal (find attack paths)
- engineering-team/threat-detection — hunting; different goal
- engineering/observability-designer — measurement, not fault injection
None cover the chaos-engineering discipline (hypothesis-driven fault injection
with bounded blast radius). Verdict: BUILD. Gap is real and tooling-shaped.
### Composition story (Phase 1+2+3 form a stack)
```
feature-flags-architect.kill_switch_audit.py
↓ defines kill switches that ↓
chaos-engineering.experiment_designer.py
↓ designs experiments against ↓
kubernetes-operator (and other targets)
```
Together: a complete progressive-delivery + resilience-testing stack.
### Marketplace / registry
- marketplace.json: chaos-engineering registered as standalone plugin
- engineering-advanced-skills bundle: 47 → 48 skills, version → 2.4.2
- engineering/.claude-plugin/plugin.json: version + skill list updated
- mkdocs.yml: nav entry under "Engineering - POWERFUL"
- docs/skills/engineering/chaos-engineering.md: docs page (manual,
pending generate-docs.py classification fix)
- docs/commands/chaos-experiment.md: auto-generated
- .codex/, .gemini/: synced
### Karpathy-coder gates
- complexity_checker (strict): 95/100 average — BEST score in the new
portfolio. Only 1 WARN (depth 5 in blast_radius_calculator.py validation
branches; the other 2 scripts hit no findings whatsoever).
- All 1666 tests pass (was 1648; added 18 for the new skill).
- mkdocs build --strict: succeeded in 13.33s.
### Verifiable success criteria (all green)
✓ scripts/*.py --help → exit 0 for all 3 scripts
✓ SKILL.md frontmatter → name + description + tags + compatible_tools
✓ plugin.json schema → 8 fields exact (verified by check_plugin_json.py)
✓ sync_skill_bundles → standalone ↔ bundled mirror in sync
✓ marketplace.json → standalone entry + bundle counts updated
✓ generate-docs.py → command page generated (skill page manual)
✓ mkdocs build --strict → succeeded
✓ cross-tool sync → codex + gemini synced
✓ pytest tests/ → 1666 passed, 0 failed
✓ CHANGELOG.md → [Unreleased] entry expanded for Phase 3
✓ Self-test (RED case) → 50% blast radius on 99.9% baseline correctly
classifies as RED (17.33% of monthly budget) and
returns ABORT recommendation
✓ Composition test → references named skills explicitly compose
## Phase 1+2+3 cumulative
- 3 new skills: feature-flags-architect, kubernetes-operator, chaos-engineering
- 9 new Python tools (all stdlib, all <200 LOC, average complexity 90/100)
- 12 new reference docs (~250-500 lines each)
- 3 new slash commands (/flag-cleanup, /operator-audit, /chaos-experiment)
- 2 repo-infrastructure scripts (sync_skill_bundles, check_plugin_json)
- 1 pre-existing test fix (full-page-screenshot CI red)
## Files
- engineering/chaos-engineering/ (new standalone plugin)
- engineering/skills/chaos-engineering/ (new bundled mirror)
- commands/chaos-experiment.md (new slash command)
- docs/skills/engineering/chaos-engineering.md (new docs page)
- docs/commands/chaos-experiment.md (auto-generated)
- mkdocs.yml (nav entries)
- .claude-plugin/marketplace.json (registered)
- engineering/.claude-plugin/plugin.json (bundle bumped)
- CHANGELOG.md ([Unreleased] expanded)
- .codex/, .gemini/ (cross-tool sync)
https://claude.ai/code/session_01Dq12xJakFRxwaoU8Pqejdm
|
||
|---|---|---|
| .autoresearch/seo/skill-descriptions | ||
| .claude | ||
| .claude-plugin | ||
| .codex | ||
| .codex-plugin | ||
| .gemini | ||
| .github | ||
| agents | ||
| business-growth | ||
| c-level-advisor | ||
| commands | ||
| custom-gpt | ||
| docs | ||
| documentation | ||
| engineering | ||
| engineering-team | ||
| eval-workspace/iteration-1 | ||
| finance | ||
| marketing-skill | ||
| orchestration | ||
| product-team | ||
| project-management | ||
| ra-qm-team | ||
| scripts | ||
| standards | ||
| templates | ||
| tests | ||
| .gitignore | ||
| .mcp.json | ||
| .yamllintignore | ||
| AUDIT_REPORT.md | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| CONVENTIONS.md | ||
| GEMINI.md | ||
| INSTALLATION.md | ||
| LICENSE | ||
| mkdocs.yml | ||
| pyproject.toml | ||
| README.md | ||
| requirements-dev.txt | ||
| SECURITY.md | ||
| SKILL-AUTHORING-STANDARD.md | ||
| SKILL_PIPELINE.md | ||
| STORE.md | ||
| tessl.json | ||
Claude Code Skills & Plugins — Agent Skills for Every Coding Tool
235 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, and more.
Works with: Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Hermes Agent · Cursor · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity
5,200+ GitHub stars — the most comprehensive open-source Claude Code skills & agent plugins library.
What Are Claude Code Skills & Agent Plugins?
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 — 305 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 305 Python tools run anywhere Python runs.
Skills vs Agents vs Personas
| Skills | Agents | Personas | |
|---|---|---|---|
| Purpose | How to execute a task | What task to do | Who is thinking |
| Scope | Single domain | Single domain | Cross-domain |
| Voice | Neutral | Professional | Personality-driven |
| Example | "Follow these steps for SEO" | "Run a security audit" | "Think like a startup CTO" |
All three work together. See Orchestration for how to combine them.
Quick Install
Gemini CLI (New)
# Clone the repository
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
# Run the setup script
./scripts/gemini-install.sh
# Start using skills
> activate_skill(name="senior-architect")
Claude Code (Recommended)
# Add the marketplace
/plugin marketplace add alirezarezvani/claude-skills
# Install by domain
/plugin install engineering-skills@claude-code-skills # 24 core engineering
/plugin install engineering-advanced-skills@claude-code-skills # 25 POWERFUL-tier
/plugin install product-skills@claude-code-skills # 12 product skills
/plugin install marketing-skills@claude-code-skills # 43 marketing skills
/plugin install ra-qm-skills@claude-code-skills # 12 regulatory/quality
/plugin install pm-skills@claude-code-skills # 6 project management
/plugin install c-level-skills@claude-code-skills # 28 C-level advisory (full C-suite)
/plugin install business-growth-skills@claude-code-skills # 4 business & growth
/plugin install finance-skills@claude-code-skills # 2 finance (analyst + SaaS metrics)
# Or install individual skills
/plugin install skill-security-auditor@claude-code-skills # Security scanner
/plugin install playwright-pro@claude-code-skills # Playwright testing toolkit
/plugin install self-improving-agent@claude-code-skills # Auto-memory curation
/plugin install content-creator@claude-code-skills # Single skill
OpenAI Codex
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex
# Or: git clone + ./scripts/codex-install.sh
OpenClaw
bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)
Manual Installation
git clone https://github.com/alirezarezvani/claude-skills.git
# Copy any skill folder to ~/.claude/skills/ (Claude Code) or ~/.codex/skills/ (Codex)
Multi-Tool Support (New)
Convert all 156 skills to 7 AI coding tools with a single script:
| Tool | Format | Install |
|---|---|---|
| Cursor | .mdc rules |
./scripts/install.sh --tool cursor --target . |
| Aider | CONVENTIONS.md |
./scripts/install.sh --tool aider --target . |
| Kilo Code | .kilocode/rules/ |
./scripts/install.sh --tool kilocode --target . |
| Windsurf | .windsurf/skills/ |
./scripts/install.sh --tool windsurf --target . |
| OpenCode | .opencode/skills/ |
./scripts/install.sh --tool opencode --target . |
| Augment | .augment/rules/ |
./scripts/install.sh --tool augment --target . |
| Antigravity | ~/.gemini/antigravity/skills/ |
./scripts/install.sh --tool antigravity |
| Hermes Agent | ~/.hermes/skills/ |
python scripts/sync-hermes-skills.py --verbose |
How it works:
# 1. Convert all skills to all tools (takes ~15 seconds)
./scripts/convert.sh --tool all
# 2. Install into your project (with confirmation)
./scripts/install.sh --tool cursor --target /path/to/project
# Or use --force to skip confirmation:
./scripts/install.sh --tool aider --target . --force
# 3. Verify
find .cursor/rules -name "*.mdc" | wc -l # Should show 156
Each tool gets:
- ✅ All 156 skills converted to native format
- ✅ Per-tool README with install/verify/update steps
- ✅ Support for scripts, references, templates where applicable
- ✅ Zero manual conversion work
Run ./scripts/convert.sh --tool all to generate tool-specific outputs locally.
Skills Overview
235 skills across 9 domains:
| Domain | Skills | Highlights | Details |
|---|---|---|---|
| 🔧 Engineering — Core | 37 | Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright, self-improving agent, security suite (6), a11y audit | engineering-team/ |
| 🎭 Playwright Pro | 9+3 | Test generation, flaky fix, Cypress/Selenium migration, TestRail, BrowserStack, 55 templates | engineering-team/playwright-pro |
| 🧠 Self-Improving Agent | 5+2 | Auto-memory curation, pattern promotion, skill extraction, memory health | engineering-team/self-improving-agent |
| ⚡ Engineering — POWERFUL | 45 | Agent designer, RAG architect, database designer, CI/CD builder, security auditor, MCP builder, AgentHub, Helm charts, Terraform, self-eval, llm-wiki (second brain for Obsidian), tc-tracker | engineering/ |
| 🎯 Product | 16 | 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/ |
| 📣 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/ |
| 📋 Project Management | 9 | Senior PM, scrum master, Jira, Confluence, Atlassian admin, templates | project-management/ |
| 🏥 Regulatory & QM | 14 | ISO 13485, MDR 2017/745, FDA, ISO 27001, GDPR, CAPA, risk management | ra-qm-team/ |
| 💼 C-Level Advisory | 34 | Full C-suite (10 roles) + orchestration + board meetings + culture & collaboration | c-level-advisor/ |
| 📈 Business & Growth | 5 | Customer success, sales engineer, revenue ops, contracts & proposals | business-growth/ |
| 💰 Finance | 4 | Financial analyst (DCF, budgeting, forecasting), SaaS metrics coach (ARR, MRR, churn, LTV, CAC) | finance/ |
Personas
Pre-configured agent identities with curated skill loadouts, workflows, and distinct communication styles. Personas go beyond "use these skills" — they define how an agent thinks, prioritizes, and communicates.
| Persona | Domain | Best For |
|---|---|---|
| Startup CTO | Engineering + Strategy | Architecture decisions, tech stack selection, team building, technical due diligence |
| Growth Marketer | Marketing + Growth | Content-led growth, launch strategy, channel optimization, bootstrapped marketing |
| Solo Founder | Cross-domain | One-person startups, side projects, MVP building, wearing all hats |
Usage:
# Claude Code
cp agents/personas/startup-cto.md ~/.claude/agents/
# Any tool
./scripts/convert.sh --tool cursor # Converts personas too
See agents/personas/ for details. Create your own with TEMPLATE.md.
Orchestration
A lightweight protocol for coordinating personas, skills, and agents on work that crosses domain boundaries. No framework required.
Four patterns:
| Pattern | What | When |
|---|---|---|
| Solo Sprint | Switch personas across project phases | Side projects, MVPs, solo founders |
| Domain Deep-Dive | One persona + multiple stacked skills | Architecture reviews, compliance audits |
| Multi-Agent Handoff | Personas review each other's output | High-stakes decisions, launch readiness |
| Skill Chain | Sequential skills, no persona needed | Content pipelines, repeatable checklists |
Example: 6-week product launch
Week 1-2: startup-cto + aws-solution-architect + senior-frontend → Build
Week 3-4: growth-marketer + launch-strategy + copywriting + seo-audit → Prepare
Week 5-6: solo-founder + email-sequence + analytics-tracking → Ship and iterate
See orchestration/ORCHESTRATION.md for the full protocol and examples.
POWERFUL Tier
25 advanced skills with deep, production-grade capabilities:
| Skill | What It Does |
|---|---|
| agent-designer | Multi-agent orchestration, tool schemas, performance evaluation |
| agent-workflow-designer | Sequential, parallel, router, orchestrator, and evaluator patterns |
| rag-architect | RAG pipeline builder, chunking optimizer, retrieval evaluator |
| database-designer | Schema analyzer, ERD generation, index optimizer, migration generator |
| database-schema-designer | Requirements → migrations, types, seed data, RLS policies |
| migration-architect | Migration planner, compatibility checker, rollback generator |
| skill-security-auditor | 🔒 Security gate — scan skills for malicious code before installation |
| ci-cd-pipeline-builder | Analyze stack → generate GitHub Actions / GitLab CI configs |
| mcp-server-builder | Build MCP servers from OpenAPI specs |
| pr-review-expert | Blast radius analysis, security scan, coverage delta |
| api-design-reviewer | REST API linter, breaking change detector, design scorecard |
| api-test-suite-builder | Scan API routes → generate complete test suites |
| dependency-auditor | Multi-language scanner, license compliance, upgrade planner |
| release-manager | Changelog generator, semantic version bumper, readiness checker |
| observability-designer | SLO designer, alert optimizer, dashboard generator |
| performance-profiler | Node/Python/Go profiling, bundle analysis, load testing |
| monorepo-navigator | Turborepo/Nx/pnpm workspace management & impact analysis |
| changelog-generator | Conventional commits → structured changelogs |
| codebase-onboarding | Auto-generate onboarding docs from codebase analysis |
| runbook-generator | Codebase → operational runbooks with commands |
| git-worktree-manager | Parallel dev with port isolation, env sync |
| env-secrets-manager | .env management, leak detection, rotation workflows |
| incident-commander | Incident response playbook, severity classifier, PIR generator |
| tech-debt-tracker | Codebase debt scanner, prioritizer, trend dashboard |
| interview-system-designer | Interview loop designer, question bank, calibrator |
🔒 Skill Security Auditor
New in v2.0.0 — audit any skill for security risks before installation:
python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py /path/to/skill/
Scans for: command injection, code execution, data exfiltration, prompt injection, dependency supply chain risks, privilege escalation. Returns PASS / WARN / FAIL with remediation guidance.
Zero dependencies. Works anywhere Python runs.
Recently Enhanced Skills
Production-quality upgrades added for:
engineering/git-worktree-manager— worktree lifecycle + cleanup automation scriptsengineering/mcp-server-builder— OpenAPI -> MCP scaffold + manifest validatorengineering/changelog-generator— release note generator + conventional commit linterengineering/ci-cd-pipeline-builder— stack detector + pipeline generatormarketing-skill/prompt-engineer-toolkit— prompt A/B tester + prompt version/diff manager
Each now ships with scripts/, extracted references/, and a usage-focused README.md.
Usage Examples
Architecture Review
Using the senior-architect skill, review our microservices architecture
and identify the top 3 scalability risks.
Content Creation
Using the content-creator skill, write a blog post about AI-augmented
development. Optimize for SEO targeting "Claude Code tutorial".
Compliance Audit
Using the mdr-745-specialist skill, review our technical documentation
for MDR Annex II compliance gaps.
Python Analysis Tools
305 CLI tools ship with the skills (all verified, stdlib-only):
# SaaS health check
python3 finance/saas-metrics-coach/scripts/metrics_calculator.py --mrr 80000 --customers 200 --churned 3 --json
# Brand voice analysis
python3 marketing-skill/content-production/scripts/brand_voice_analyzer.py article.txt
# Tech debt scoring
python3 c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py /path/to/codebase
# RICE prioritization
python3 product-team/product-manager-toolkit/scripts/rice_prioritizer.py features.csv
# Security audit
python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py /path/to/skill/
# Landing page (TSX + Tailwind)
python3 product-team/landing-page-generator/scripts/landing_page_scaffolder.py config.json --format tsx
Related Projects
| Project | Description |
|---|---|
| Claude Code Skills & Agents Factory | Methodology for building skills at scale |
| Claude Code Tresor | Productivity toolkit with 60+ prompt templates |
| Product Manager Skills | Senior PM agent with 6 knowledge domains, 12 templates, 30+ frameworks — discovery, strategy, delivery, SaaS metrics, career coaching, AI product craft |
FAQ
How do I install Claude Code plugins?
Add the marketplace with /plugin marketplace add alirezarezvani/claude-skills, then install any skill bundle with /plugin install <name>@claude-code-skills.
Do these skills work with OpenAI Codex / Cursor / Windsurf / Aider?
Yes. Skills work natively with 12 tools: Claude Code, OpenAI Codex, Gemini CLI, OpenClaw, Hermes Agent, Cursor, Aider, Windsurf, Kilo Code, OpenCode, Augment, and Antigravity. Hermes Agent uses the same agentskills.io SKILL.md standard — run python scripts/sync-hermes-skills.py to install. For other tools run ./scripts/convert.sh --tool all then ./scripts/install.sh --tool <name>. See Multi-Tool Integrations for details.
Will updating break my installation? 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 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.
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 for a step-by-step guide.
Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
Quick ideas:
- Add new skills in underserved domains
- Improve existing Python tools
- Add test coverage for scripts
- Translate skills for non-English markets
License
MIT — see LICENSE for details.
Star History
Built by Alireza Rezvani · Medium · Twitter