From e029a9f9b2195381162988c71467d53db674397b Mon Sep 17 00:00:00 2001 From: Alireza Rezvani Date: Wed, 4 Mar 2026 01:43:28 +0100 Subject: [PATCH 1/2] Dev (#227) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Improve senior-fullstack skill description and workflow validation - Expand frontmatter description with concrete actions and trigger clauses - Add validation steps to scaffolding workflow (verify scaffold succeeded) - Add re-run verification step to audit workflow (confirm P0 fixes) * chore: sync codex skills symlinks [automated] * fix(skill): normalize senior-fullstack frontmatter to inline format Normalize YAML description from block scalar (>) to inline single-line format matching all other 50+ skills. Align frontmatter trigger phrases with the body's Trigger Phrases section to eliminate duplication. Co-Authored-By: Claude Opus 4.6 * fix(ci): add GITHUB_TOKEN to checkout + restore corrupted skill descriptions - Add token: ${{ secrets.GITHUB_TOKEN }} to actions/checkout@v4 in sync-codex-skills.yml so git-auto-commit-action can push back to branch (fixes: fatal: could not read Username, exit 128) - Restore correct description for incident-commander (was: 'Skill from engineering-team') - Restore correct description for senior-fullstack (was: '>') * fix(ci): pass PROJECTS_TOKEN to fix automated commits + remove duplicate checkout Fixes PROJECTS_TOKEN passthrough for git-auto-commit-action and removes duplicate checkout step in pr-issue-auto-close workflow. * fix(ci): remove stray merge conflict marker in sync-codex-skills.yml (#221) Co-authored-by: Leo * fix(ci): fix workflow errors + add OpenClaw support (#222) * feat: add 20 new practical skills for professional Claude Code users New skills across 5 categories: Engineering (12): - git-worktree-manager: Parallel dev with port isolation & env sync - ci-cd-pipeline-builder: Generate GitHub Actions/GitLab CI from stack analysis - mcp-server-builder: Build MCP servers from OpenAPI specs - changelog-generator: Conventional commits to structured changelogs - pr-review-expert: Blast radius analysis & security scan for PRs - api-test-suite-builder: Auto-generate test suites from API routes - env-secrets-manager: .env management, leak detection, rotation workflows - database-schema-designer: Requirements to migrations & types - codebase-onboarding: Auto-generate onboarding docs from codebase - performance-profiler: Node/Python/Go profiling & optimization - runbook-generator: Operational runbooks from codebase analysis - monorepo-navigator: Turborepo/Nx/pnpm workspace management Engineering Team (2): - stripe-integration-expert: Subscriptions, webhooks, billing patterns - email-template-builder: React Email/MJML transactional email systems Product Team (3): - saas-scaffolder: Full SaaS project generation from product brief - landing-page-generator: High-converting landing pages with copy frameworks - competitive-teardown: Structured competitive product analysis Business Growth (1): - contract-and-proposal-writer: Contracts, SOWs, NDAs per jurisdiction Marketing (1): - prompt-engineer-toolkit: Systematic prompt development & A/B testing Designed for daily professional use and commercial distribution. * chore: sync codex skills symlinks [automated] * docs: update README with 20 new skills, counts 65→86, new skills section * docs: add commercial distribution plan (Stan Store + Gumroad) * docs: rewrite CHANGELOG.md with v2.0.0 release (65 skills, 9 domains) (#226) * docs: rewrite CHANGELOG.md with v2.0.0 release (65 skills, 9 domains) - Consolidate 191 commits since v1.0.2 into proper v2.0.0 entry - Document 12 POWERFUL-tier skills, 37 refactored skills - Add new domains: business-growth, finance - Document Codex support and marketplace integration - Update version history summary table - Clean up [Unreleased] to only planned work * docs: add 24 POWERFUL-tier skills to plugin, fix counts to 85 across all docs - Add engineering-advanced-skills plugin (24 POWERFUL-tier skills) to marketplace.json - Add 13 missing skills to CHANGELOG v2.0.0 (agent-workflow-designer, api-test-suite-builder, changelog-generator, ci-cd-pipeline-builder, codebase-onboarding, database-schema-designer, env-secrets-manager, git-worktree-manager, mcp-server-builder, monorepo-navigator, performance-profiler, pr-review-expert, runbook-generator) - Fix skill count: 86→85 (excl sample-skill) across README, CHANGELOG, marketplace.json - Fix stale 53→85 references in README - Add engineering-advanced-skills install command to README - Update marketplace.json version to 2.0.0 --------- Co-authored-by: Leo --------- Co-authored-by: Baptiste Fernandez Co-authored-by: alirezarezvani <5697919+alirezarezvani@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 Co-authored-by: Leo Co-authored-by: Leo --- .claude-plugin/marketplace.json | 446 ++++++++++++++++++++------------ CHANGELOG.md | 343 +++++++++++++----------- README.md | 20 +- 3 files changed, 487 insertions(+), 322 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 8b288fc..05da048 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,170 +1,284 @@ { - "name": "claude-code-skills", - "owner": { - "name": "Alireza Rezvani", - "url": "https://alirezarezvani.com" - }, - "description": "Production-ready skill packages for Claude AI - 65 expert skills across marketing, engineering, product, C-level advisory, project management, regulatory compliance, business growth, and finance", - "homepage": "https://github.com/alirezarezvani/claude-skills", - "repository": "https://github.com/alirezarezvani/claude-skills", - "metadata": { - "description": "65 production-ready skill packages across 8 domains: marketing, engineering, product, C-level advisory, project management, regulatory compliance, business growth, and finance", - "version": "1.0.0" - }, - "plugins": [ - { - "name": "marketing-skills", - "source": "./marketing-skill", - "description": "6 marketing skills: content creator, demand generation, product marketing, ASO, social media analytics, campaign analytics", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["marketing", "content", "seo", "demand-gen", "social-media"], - "category": "marketing" + "name": "claude-code-skills", + "owner": { + "name": "Alireza Rezvani", + "url": "https://alirezarezvani.com" }, - { - "name": "engineering-skills", - "source": "./engineering-team", - "description": "30 engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["engineering", "architecture", "frontend", "backend", "devops", "security", "ai", "ml", "data"], - "category": "development" + "description": "Production-ready skill packages for Claude AI - 85 expert skills across marketing, engineering, product, C-level advisory, project management, regulatory compliance, business growth, and finance", + "homepage": "https://github.com/alirezarezvani/claude-skills", + "repository": "https://github.com/alirezarezvani/claude-skills", + "metadata": { + "description": "85 production-ready skill packages across 9 domains: marketing, engineering, engineering-advanced, product, C-level advisory, project management, regulatory compliance, business growth, and finance", + "version": "2.0.0" }, - { - "name": "product-skills", - "source": "./product-team", - "description": "5 product skills: product manager toolkit, agile product owner, product strategist, UX researcher, UI design system", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["product", "pm", "agile", "ux", "design-system"], - "category": "product" - }, - { - "name": "c-level-skills", - "source": "./c-level-advisor", - "description": "2 C-level advisory skills: CEO advisor, CTO advisor", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["ceo", "cto", "executive", "strategy", "leadership"], - "category": "leadership" - }, - { - "name": "pm-skills", - "source": "./project-management", - "description": "6 project management skills: senior PM, scrum master, Jira expert, Confluence expert, Atlassian admin, template creator", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["project-management", "scrum", "agile", "jira", "confluence", "atlassian"], - "category": "project-management" - }, - { - "name": "ra-qm-skills", - "source": "./ra-qm-team", - "description": "12 regulatory affairs & quality management skills for HealthTech/MedTech: ISO 13485, MDR, FDA, GDPR, ISO 27001 compliance", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["regulatory", "quality", "compliance", "iso-13485", "mdr", "fda", "gdpr", "medtech"], - "category": "compliance" - }, - { - "name": "business-growth-skills", - "source": "./business-growth", - "description": "3 business & growth skills: customer success manager, sales engineer, revenue operations", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["customer-success", "sales-engineering", "revenue-operations", "business-growth"], - "category": "business-growth" - }, - { - "name": "finance-skills", - "source": "./finance", - "description": "1 finance skill: financial analyst with ratio analysis, DCF valuation, budgeting, and forecasting", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["finance", "dcf", "valuation", "budgeting", "forecasting"], - "category": "finance" - }, - { - "name": "content-creator", - "source": "./marketing-skill/content-creator", - "description": "Brand voice analysis, SEO optimization, content frameworks for marketing content creation", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["content", "seo", "brand-voice", "marketing"], - "category": "marketing" - }, - { - "name": "demand-gen", - "source": "./marketing-skill/marketing-demand-acquisition", - "description": "Demand generation, paid media, SEO, partnerships for Series A+ startups", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["demand-gen", "paid-media", "acquisition", "marketing"], - "category": "marketing" - }, - { - "name": "fullstack-engineer", - "source": "./engineering-team/senior-fullstack", - "description": "End-to-end application development with Next.js, GraphQL, PostgreSQL", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["fullstack", "nextjs", "graphql", "postgresql"], - "category": "development" - }, - { - "name": "aws-architect", - "source": "./engineering-team/aws-solution-architect", - "description": "AWS solution architecture with serverless, cost optimization, and security best practices", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["aws", "cloud", "serverless", "architecture"], - "category": "development" - }, - { - "name": "product-manager", - "source": "./product-team/product-manager-toolkit", - "description": "RICE prioritization, customer interview analysis, PRD templates for product managers", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["product-management", "rice", "prd", "prioritization"], - "category": "product" - }, - { - "name": "scrum-master", - "source": "./project-management/scrum-master", - "description": "Agile facilitation, sprint planning, retrospectives for Scrum teams", - "version": "1.0.0", - "author": { - "name": "Alireza Rezvani" - }, - "keywords": ["scrum", "agile", "sprint", "retrospective"], - "category": "project-management" - } - ] + "plugins": [ + { + "name": "marketing-skills", + "source": "./marketing-skill", + "description": "6 marketing skills: content creator, demand generation, product marketing, ASO, social media analytics, campaign analytics", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "marketing", + "content", + "seo", + "demand-gen", + "social-media" + ], + "category": "marketing" + }, + { + "name": "engineering-skills", + "source": "./engineering-team", + "description": "21 engineering skills: architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "engineering", + "architecture", + "frontend", + "backend", + "devops", + "security", + "ai", + "ml", + "data" + ], + "category": "development" + }, + { + "name": "engineering-advanced-skills", + "source": "./engineering", + "description": "24 POWERFUL-tier engineering skills: agent designer, RAG architect, database designer, migration architect, observability designer, dependency auditor, release manager, API reviewer, CI/CD pipeline builder, MCP server builder, and more", + "version": "2.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "powerful", + "agent-design", + "rag", + "database", + "migration", + "observability", + "dependency-audit", + "release", + "api-review", + "ci-cd", + "mcp", + "monorepo", + "performance", + "runbook", + "changelog", + "onboarding", + "worktree" + ], + "category": "development" + }, + { + "name": "product-skills", + "source": "./product-team", + "description": "8 product skills: product manager toolkit, agile product owner, product strategist, UX researcher, UI design system, and 3 more", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "product", + "pm", + "agile", + "ux", + "design-system" + ], + "category": "product" + }, + { + "name": "c-level-skills", + "source": "./c-level-advisor", + "description": "2 C-level advisory skills: CEO advisor, CTO advisor", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "ceo", + "cto", + "executive", + "strategy", + "leadership" + ], + "category": "leadership" + }, + { + "name": "pm-skills", + "source": "./project-management", + "description": "6 project management skills: senior PM, scrum master, Jira expert, Confluence expert, Atlassian admin, template creator", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "project-management", + "scrum", + "agile", + "jira", + "confluence", + "atlassian" + ], + "category": "project-management" + }, + { + "name": "ra-qm-skills", + "source": "./ra-qm-team", + "description": "12 regulatory affairs & quality management skills for HealthTech/MedTech: ISO 13485, MDR, FDA, GDPR, ISO 27001 compliance", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "regulatory", + "quality", + "compliance", + "iso-13485", + "mdr", + "fda", + "gdpr", + "medtech" + ], + "category": "compliance" + }, + { + "name": "business-growth-skills", + "source": "./business-growth", + "description": "4 business & growth skills: customer success manager, sales engineer, revenue operations, and more", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "customer-success", + "sales-engineering", + "revenue-operations", + "business-growth" + ], + "category": "business-growth" + }, + { + "name": "finance-skills", + "source": "./finance", + "description": "1 finance skill: financial analyst with ratio analysis, DCF valuation, budgeting, and forecasting", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "finance", + "dcf", + "valuation", + "budgeting", + "forecasting" + ], + "category": "finance" + }, + { + "name": "content-creator", + "source": "./marketing-skill/content-creator", + "description": "Brand voice analysis, SEO optimization, content frameworks for marketing content creation", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "content", + "seo", + "brand-voice", + "marketing" + ], + "category": "marketing" + }, + { + "name": "demand-gen", + "source": "./marketing-skill/marketing-demand-acquisition", + "description": "Demand generation, paid media, SEO, partnerships for Series A+ startups", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "demand-gen", + "paid-media", + "acquisition", + "marketing" + ], + "category": "marketing" + }, + { + "name": "fullstack-engineer", + "source": "./engineering-team/senior-fullstack", + "description": "End-to-end application development with Next.js, GraphQL, PostgreSQL", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "fullstack", + "nextjs", + "graphql", + "postgresql" + ], + "category": "development" + }, + { + "name": "aws-architect", + "source": "./engineering-team/aws-solution-architect", + "description": "AWS solution architecture with serverless, cost optimization, and security best practices", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "aws", + "cloud", + "serverless", + "architecture" + ], + "category": "development" + }, + { + "name": "product-manager", + "source": "./product-team/product-manager-toolkit", + "description": "RICE prioritization, customer interview analysis, PRD templates for product managers", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "product-management", + "rice", + "prd", + "prioritization" + ], + "category": "product" + }, + { + "name": "scrum-master", + "source": "./project-management/scrum-master", + "description": "Agile facilitation, sprint planning, retrospectives for Scrum teams", + "version": "1.0.0", + "author": { + "name": "Alireza Rezvani" + }, + "keywords": [ + "scrum", + "agile", + "sprint", + "retrospective" + ], + "category": "project-management" + } + ] } diff --git a/CHANGELOG.md b/CHANGELOG.md index 22c4b02..8e1495a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,138 +5,119 @@ 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). -## [Unreleased] - 2026-02-16 - -### Added -- **incident-commander** (POWERFUL tier) — Incident response playbook with severity classifier, timeline reconstructor, and PIR generator -- **tech-debt-tracker** (POWERFUL tier) — Codebase debt scanner with AST parsing, debt prioritizer, and trend dashboard -- **api-design-reviewer** (POWERFUL tier) — REST API linter, breaking change detector, and API design scorecard -- **interview-system-designer** (POWERFUL tier) — Interview loop designer, question bank generator, and hiring calibrator -- **migration-architect** (POWERFUL tier) — Migration planner, compatibility checker, and rollback generator -- **observability-designer** (POWERFUL tier) — SLO designer, alert optimizer, and dashboard generator -- **dependency-auditor** (POWERFUL tier) — Multi-language dependency scanner, license compliance checker, and upgrade planner -- **release-manager** (POWERFUL tier) — Automated changelog generator, semantic version bumper, and release readiness checker -- **database-designer** (POWERFUL tier) — Schema analyzer with ERD generation, index optimizer, and migration generator -- **rag-architect** (POWERFUL tier) — RAG pipeline builder, chunking optimizer, and retrieval evaluator -- **agent-designer** (POWERFUL tier) — Multi-agent architect, tool schema generator, and agent performance evaluator -- **skill-tester** (POWERFUL tier) — Meta-skill validator, script tester, and quality scorer -- `campaign-analytics` - Multi-touch attribution, funnel conversion, campaign ROI (3 Python tools) -- `customer-success-manager` - Onboarding, retention, expansion, health scoring (2 Python tools) -- `sales-engineer` - Technical sales, solution design, RFP responses (2 Python tools) -- `revenue-operations` - Pipeline analytics, forecasting, process optimization (2 Python tools) -- `financial-analyst` - DCF valuation, budgeting, forecasting, financial modeling (3 Python tools) -- New `business-growth` domain with 3 skills -- New `finance` domain with 1 skill -- 92+ Python automation tools (up from 87+, including 17 new POWERFUL-tier tools) -- 64 total skills across 8 domains (up from 53) - -### Fixed -- CI workflows (smart-sync.yml, pr-issue-auto-close.yml) — PR #193 -- Installation documentation (Issue #189) — PR #193 +## [Unreleased] ### Planned -- Complete Anthropic best practices refactoring (37/42 skills remaining) -- Develop production Python tools for RA/QM skills (11 scripts) +- Complete Anthropic best practices refactoring (5/42 skills remaining) +- Production Python tools for remaining RA/QM skills - Marketing expansion: SEO Optimizer, Social Media Manager skills --- -## [1.0.0] - 2025-10-21 +## [2.0.0] - 2026-02-16 -### Added - Complete Initial Release +### ⚡ POWERFUL Tier — 25 New Skills -**42 Production-Ready Skills across 6 Domains:** +A new tier of advanced, deeply-engineered skills with comprehensive tooling: -#### Marketing Skills (3) -- `content-creator` - Brand voice analyzer, SEO optimizer, content frameworks -- `marketing-demand-acquisition` - Demand gen, paid media, CAC calculator -- `marketing-strategy-pmm` - Positioning, GTM, competitive intelligence +- **incident-commander** — Incident response playbook with severity classifier, timeline reconstructor, and PIR generator +- **tech-debt-tracker** — Codebase debt scanner with AST parsing, debt prioritizer, and trend dashboard +- **api-design-reviewer** — REST API linter, breaking change detector, and API design scorecard +- **interview-system-designer** — Interview loop designer, question bank generator, and hiring calibrator +- **migration-architect** — Migration planner, compatibility checker, and rollback generator +- **observability-designer** — SLO designer, alert optimizer, and dashboard generator +- **dependency-auditor** — Multi-language dependency scanner, license compliance checker, and upgrade planner +- **release-manager** — Automated changelog generator, semantic version bumper, and release readiness checker +- **database-designer** — Schema analyzer with ERD generation, index optimizer, and migration generator +- **rag-architect** — RAG pipeline builder, chunking optimizer, and retrieval evaluator +- **agent-designer** — Multi-agent architect, tool schema generator, and agent performance evaluator +- **skill-tester** — Meta-skill validator, script tester, and quality scorer +- **agent-workflow-designer** — Multi-agent orchestration system designer with sequential, parallel, router, orchestrator, and evaluator patterns +- **api-test-suite-builder** — API route scanner and test suite generator across frameworks (Next.js, Express, FastAPI, Django REST) +- **changelog-generator** — Conventional commit parser, semantic version bumper, and structured changelog generator +- **ci-cd-pipeline-builder** — Stack-aware CI/CD pipeline generator for GitHub Actions, GitLab CI, and more +- **codebase-onboarding** — Codebase analyzer and onboarding documentation generator for new team members +- **database-schema-designer** — Database schema design and modeling tool with migration support +- **env-secrets-manager** — Environment and secrets management across dev/staging/prod lifecycle +- **git-worktree-manager** — Systematic Git worktree management for parallel development workflows +- **mcp-server-builder** — MCP (Model Context Protocol) server scaffolder and implementation guide +- **monorepo-navigator** — Monorepo management for Turborepo, Nx, pnpm workspaces, and Lerna +- **performance-profiler** — Systematic performance profiling for Node.js, Python, and Go applications +- **pr-review-expert** — Structured code review for GitHub PRs and GitLab MRs with systematic analysis +- **runbook-generator** — Production-grade operational runbook generator with stack detection -#### C-Level Advisory (2) -- `ceo-advisor` - Strategy analyzer, financial scenario modeling, board governance -- `cto-advisor` - Tech debt analyzer, team scaling calculator, engineering metrics +### 🆕 New Domains & Skills -#### Product Team (5) -- `product-manager-toolkit` - RICE prioritizer, interview analyzer, PRD templates -- `agile-product-owner` - User story generator, sprint planning -- `product-strategist` - OKR cascade generator, strategic planning -- `ux-researcher-designer` - Persona generator, user research -- `ui-design-system` - Design token generator, component architecture +- **business-growth** domain (3 skills): + - `customer-success-manager` — Onboarding, retention, expansion, health scoring (2 Python tools) + - `sales-engineer` — Technical sales, solution design, RFP responses (2 Python tools) + - `revenue-operations` — Pipeline analytics, forecasting, process optimization (2 Python tools) +- **finance** domain (1 skill): + - `financial-analyst` — DCF valuation, budgeting, forecasting, financial modeling (3 Python tools) +- **marketing** addition: + - `campaign-analytics` — Multi-touch attribution, funnel conversion, campaign ROI (3 Python tools) -#### Project Management (6) -- `senior-pm` - Portfolio management, stakeholder alignment -- `scrum-master` - Sprint ceremonies, agile coaching -- `jira-expert` - JQL mastery, configuration, dashboards -- `confluence-expert` - Knowledge management, documentation -- `atlassian-admin` - System administration, security -- `atlassian-templates` - Template design, 15+ ready templates +### 🔄 Anthropic Best Practices Refactoring (37/42 Skills) -#### Engineering - Core (9) -- `senior-architect` - Architecture diagrams, dependency analysis, ADRs -- `senior-frontend` - React components, bundle optimization -- `senior-backend` - API scaffolder, database migrations, load testing -- `senior-fullstack` - Project scaffolder, code quality analyzer -- `senior-qa` - Test suite generator, coverage analyzer, E2E tests -- `senior-devops` - CI/CD pipelines, Terraform, deployment automation -- `senior-secops` - Security scanner, vulnerability assessment, compliance -- `code-reviewer` - PR analyzer, code quality checker -- `senior-security` - Threat modeling, security audits, pentesting +Major rewrite of existing skills following Anthropic's agent skills specification. Each refactored skill received: +- Professional metadata (license, version, category, domain, keywords) +- Trigger phrases for better Claude activation +- Table of contents with proper section navigation +- Numbered workflows with validation checkpoints +- Progressive Disclosure Architecture (PDA) +- Concise SKILL.md (<200 lines target) with layered reference files -#### Engineering - AI/ML/Data (5) -- `senior-data-scientist` - Experiment designer, feature engineering, statistical analysis -- `senior-data-engineer` - Pipeline orchestrator, data quality validator, ETL -- `senior-ml-engineer` - Model deployment, MLOps setup, RAG system builder -- `senior-prompt-engineer` - Prompt optimizer, RAG evaluator, agent orchestrator -- `senior-computer-vision` - Vision model trainer, inference optimizer, video processor +**Engineering skills refactored (14):** +- `senior-architect`, `senior-frontend`, `senior-backend`, `senior-fullstack` +- `senior-qa`, `senior-secops`, `senior-security`, `code-reviewer` +- `senior-data-engineer`, `senior-computer-vision`, `senior-ml-engineer` +- `senior-prompt-engineer`, `tdd-guide`, `tech-stack-evaluator` -#### Regulatory Affairs & Quality Management (12) -- `regulatory-affairs-head` - Regulatory pathway analyzer, submission tracking -- `quality-manager-qmr` - QMS effectiveness monitor, compliance dashboards -- `quality-manager-qms-iso13485` - QMS compliance checker, design control tracker -- `capa-officer` - CAPA tracker, root cause analyzer, trend analysis -- `quality-documentation-manager` - Document version control, technical file builder -- `risk-management-specialist` - Risk register manager, FMEA calculator -- `information-security-manager-iso27001` - ISMS compliance, security risk assessment -- `mdr-745-specialist` - MDR compliance checker, UDI generator -- `fda-consultant-specialist` - FDA submission packager, QSR compliance -- `qms-audit-expert` - Audit planner, finding tracker -- `isms-audit-expert` - ISMS audit planner, security controls assessor -- `gdpr-dsgvo-expert` - GDPR compliance checker, DPIA generator +**Product & PM skills refactored (5):** +- `product-manager-toolkit`, `product-strategist`, `agile-product-owner` +- `ux-researcher-designer`, `ui-design-system` -### Documentation -- Comprehensive README.md with all 42 skills -- Domain-specific README files (6 domains) -- CLAUDE.md development guide -- Installation and usage guides -- Real-world scenario walkthroughs +**RA/QM skills refactored (12):** +- `regulatory-affairs-head`, `quality-manager-qmr`, `quality-manager-qms-iso13485` +- `capa-officer`, `quality-documentation-manager`, `risk-management-specialist` +- `information-security-manager-iso27001`, `mdr-745-specialist`, `fda-consultant-specialist` +- `qms-audit-expert`, `isms-audit-expert`, `gdpr-dsgvo-expert` -### Automation -- 97 Python CLI tools (20+ verified production-ready) -- 90+ comprehensive reference guides -- Atlassian MCP Server integration +**Marketing skills refactored (4):** +- `marketing-demand-acquisition`, `marketing-strategy-pmm` +- `content-creator`, `app-store-optimization` -### ROI Impact -- $20.8M annual value per organization -- 1,720 hours/month time savings -- 70%+ productivity improvements +**Other refactored (2):** +- `aws-solution-architect`, `ms365-tenant-manager` + +### 🔧 Elevated Skills +- `scrum-master` and `senior-pm` elevated to POWERFUL tier — PR #190 + +### 🤖 Platform Support +- **OpenAI Codex support** — Full compatibility without restructuring — PR #43, #45, #47 +- **Claude Code native marketplace** — `marketplace.json` and plugin support — PR #182, #185 +- **Codex skills sync** — Automated symlink workflow for Codex integration + +### 📊 Stats +- **85 total skills** across 9 domains (up from 42 across 6) +- **92+ Python automation tools** (up from 20+) +- **25 POWERFUL-tier skills** in new `engineering/` domain +- **37/42 original skills refactored** to Anthropic best practices + +### Fixed +- CI workflows (`smart-sync.yml`, `pr-issue-auto-close.yml`) — PR #193 +- Installation documentation (Issue #189) — PR #193 +- Plugin JSON with correct counts and missing domains — PR #186 +- PM skills extracted from zips into standard directories — PR #184, #185 +- Marketing skill count corrected (6 total) — PR #182 +- Codex skills sync workflow fixes — PR #178, #179, #180 +- `social-media-analyzer` restructured with proper organization — PR #147, #151 --- -## [1.0.1] - 2025-10-21 +## [1.1.0] - 2025-10-21 - Anthropic Best Practices Refactoring (Phase 1) -### Added -- GitHub Star History chart to README.md -- Professional repository presentation - -### Changed -- README.md table of contents anchor links fixed -- Project management folder reorganized (packaged-skills/ structure) - ---- - -## [1.1.0] - 2025-10-21 - Anthropic Best Practices Refactoring - -### Changed - Marketing & C-Level Skills (Phase 1 of 4) +### Changed — Marketing & C-Level Skills **Enhanced with Anthropic Agent Skills Specification:** @@ -153,8 +134,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Added technical and strategic terminology ### Added -- `documentation/implementation/SKILLS_REFACTORING_PLAN.md` - Complete 4-phase refactoring roadmap -- `documentation/PYTHON_TOOLS_AUDIT.md` - Comprehensive tools quality assessment +- `documentation/implementation/SKILLS_REFACTORING_PLAN.md` — Complete 4-phase refactoring roadmap +- `documentation/PYTHON_TOOLS_AUDIT.md` — Comprehensive tools quality assessment **Refactoring Progress:** 5/42 skills complete (12%) @@ -163,11 +144,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [1.0.2] - 2025-10-21 ### Added -- `LICENSE` file - Official MIT License -- `CONTRIBUTING.md` - Contribution guidelines and standards -- `CODE_OF_CONDUCT.md` - Community standards (Contributor Covenant 2.0) -- `SECURITY.md` - Security policy and vulnerability reporting -- `CHANGELOG.md` - This file, version history tracking +- `LICENSE` file — Official MIT License +- `CONTRIBUTING.md` — Contribution guidelines and standards +- `CODE_OF_CONDUCT.md` — Community standards (Contributor Covenant 2.0) +- `SECURITY.md` — Security policy and vulnerability reporting +- `CHANGELOG.md` — Version history tracking ### Documentation - Complete GitHub repository setup for open source @@ -177,46 +158,116 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 --- +## [1.0.1] - 2025-10-21 + +### Added +- GitHub Star History chart to README.md +- Professional repository presentation + +### Changed +- README.md table of contents anchor links fixed +- Project management folder reorganized (packaged-skills/ structure) + +--- + +## [1.0.0] - 2025-10-21 + +### Added — Complete Initial Release + +**42 Production-Ready Skills across 6 Domains:** + +#### Marketing Skills (3) +- `content-creator` — Brand voice analyzer, SEO optimizer, content frameworks +- `marketing-demand-acquisition` — Demand gen, paid media, CAC calculator +- `marketing-strategy-pmm` — Positioning, GTM, competitive intelligence + +#### C-Level Advisory (2) +- `ceo-advisor` — Strategy analyzer, financial scenario modeling, board governance +- `cto-advisor` — Tech debt analyzer, team scaling calculator, engineering metrics + +#### Product Team (5) +- `product-manager-toolkit` — RICE prioritizer, interview analyzer, PRD templates +- `agile-product-owner` — User story generator, sprint planning +- `product-strategist` — OKR cascade generator, strategic planning +- `ux-researcher-designer` — Persona generator, user research +- `ui-design-system` — Design token generator, component architecture + +#### Project Management (6) +- `senior-pm` — Portfolio management, stakeholder alignment +- `scrum-master` — Sprint ceremonies, agile coaching +- `jira-expert` — JQL mastery, configuration, dashboards +- `confluence-expert` — Knowledge management, documentation +- `atlassian-admin` — System administration, security +- `atlassian-templates` — Template design, 15+ ready templates + +#### Engineering — Core (9) +- `senior-architect` — Architecture diagrams, dependency analysis, ADRs +- `senior-frontend` — React components, bundle optimization +- `senior-backend` — API scaffolder, database migrations, load testing +- `senior-fullstack` — Project scaffolder, code quality analyzer +- `senior-qa` — Test suite generator, coverage analyzer, E2E tests +- `senior-devops` — CI/CD pipelines, Terraform, deployment automation +- `senior-secops` — Security scanner, vulnerability assessment, compliance +- `code-reviewer` — PR analyzer, code quality checker +- `senior-security` — Threat modeling, security audits, pentesting + +#### Engineering — AI/ML/Data (5) +- `senior-data-scientist` — Experiment designer, feature engineering, statistical analysis +- `senior-data-engineer` — Pipeline orchestrator, data quality validator, ETL +- `senior-ml-engineer` — Model deployment, MLOps setup, RAG system builder +- `senior-prompt-engineer` — Prompt optimizer, RAG evaluator, agent orchestrator +- `senior-computer-vision` — Vision model trainer, inference optimizer, video processor + +#### Regulatory Affairs & Quality Management (12) +- `regulatory-affairs-head` — Regulatory pathway analyzer, submission tracking +- `quality-manager-qmr` — QMS effectiveness monitor, compliance dashboards +- `quality-manager-qms-iso13485` — QMS compliance checker, design control tracker +- `capa-officer` — CAPA tracker, root cause analyzer, trend analysis +- `quality-documentation-manager` — Document version control, technical file builder +- `risk-management-specialist` — Risk register manager, FMEA calculator +- `information-security-manager-iso27001` — ISMS compliance, security risk assessment +- `mdr-745-specialist` — MDR compliance checker, UDI generator +- `fda-consultant-specialist` — FDA submission packager, QSR compliance +- `qms-audit-expert` — Audit planner, finding tracker +- `isms-audit-expert` — ISMS audit planner, security controls assessor +- `gdpr-dsgvo-expert` — GDPR compliance checker, DPIA generator + +### Documentation +- Comprehensive README.md with all 42 skills +- Domain-specific README files (6 domains) +- CLAUDE.md development guide +- Installation and usage guides +- Real-world scenario walkthroughs + +### Automation +- 20+ verified production-ready Python CLI tools +- 90+ comprehensive reference guides +- Atlassian MCP Server integration + +--- + ## Version History Summary -| Version | Date | Key Changes | -|---------|------|-------------| -| 1.1.0 | 2025-10-21 | Anthropic best practices refactoring (5 skills) | -| 1.0.2 | 2025-10-21 | GitHub repository pages (LICENSE, CONTRIBUTING, etc.) | -| 1.0.1 | 2025-10-21 | Star History, link fixes | -| 1.0.0 | 2025-10-21 | Initial release - 42 skills, 6 domains | +| Version | Date | Skills | Domains | Key Changes | +|---------|------|--------|---------|-------------| +| 2.0.0 | 2026-02-16 | 85 | 9 | 25 POWERFUL-tier skills, 37 refactored, Codex support, 3 new domains | +| 1.1.0 | 2025-10-21 | 42 | 6 | Anthropic best practices refactoring (5 skills) | +| 1.0.2 | 2025-10-21 | 42 | 6 | GitHub repository pages (LICENSE, CONTRIBUTING, etc.) | +| 1.0.1 | 2025-10-21 | 42 | 6 | Star History, link fixes | +| 1.0.0 | 2025-10-21 | 42 | 6 | Initial release — 42 skills, 6 domains | --- -## Upcoming Releases +## Semantic Versioning -### v1.2.0 (Planned) -- Complete Anthropic refactoring (remaining 37 skills) -- SKILL.md optimization (reduce to <200 lines) -- Progressive disclosure implementation -- allowed-tools restrictions where appropriate - -### v2.0.0 (Planned - Q2 2026) -- Production Python tools for RA/QM skills (11 scripts) -- Marketing expansion (SEO Optimizer, Social Media Manager) -- Mobile and specialized engineering skills -- Growth Marketer skill - ---- - -## Notes - -**Semantic Versioning:** -- **Major (x.0.0):** Breaking changes, major new domains +- **Major (x.0.0):** Breaking changes, major new domains, significant architecture shifts - **Minor (1.x.0):** New skills, significant enhancements - **Patch (1.0.x):** Bug fixes, documentation updates, minor improvements -**Contributors:** -All contributors will be credited in release notes for their specific contributions. - --- -[Unreleased]: https://github.com/alirezarezvani/claude-skills/compare/v1.0.2...HEAD +[Unreleased]: https://github.com/alirezarezvani/claude-skills/compare/v2.0.0...HEAD +[2.0.0]: https://github.com/alirezarezvani/claude-skills/compare/v1.0.2...v2.0.0 [1.1.0]: https://github.com/alirezarezvani/claude-skills/compare/v1.0.1...v1.1.0 [1.0.2]: https://github.com/alirezarezvani/claude-skills/compare/v1.0.1...v1.0.2 [1.0.1]: https://github.com/alirezarezvani/claude-skills/compare/v1.0.0...v1.0.1 diff --git a/README.md b/README.md index 727885c..fc0932f 100644 --- a/README.md +++ b/README.md @@ -112,7 +112,7 @@ Or preview first with `--dry-run`: Install to Claude Code, Cursor, VS Code, Amp, Goose, and more - all with one command: ```bash -# Install all 53 skills to all supported agents +# Install all 85 skills to all supported agents npx agent-skills-cli add alirezarezvani/claude-skills # Install to specific agent (Claude Code) @@ -173,7 +173,7 @@ npx agent-skills-cli add alirezarezvani/claude-skills --dry-run This repository provides **modular, self-contained skill packages** designed to augment Claude AI with specialized domain expertise. Each skill includes: - **📖 Comprehensive documentation** - Workflows, best practices, and strategic frameworks -- **🛠️ Python analysis tools** - 87+ CLI utilities for automated analysis and optimization +- **🛠️ Python analysis tools** - 92+ CLI utilities for automated analysis and optimization - **📚 Knowledge bases** - Curated reference materials and guidelines - **📋 Ready-to-use templates** - Customizable assets for immediate deployment @@ -566,7 +566,7 @@ Template and file creation/modification specialist. ### Engineering Team Skills -**Complete engineering skills suite with 19 specialized roles** covering architecture, development, testing, security, operations, cloud infrastructure, and enterprise systems. +**Complete engineering skills suite with 45 specialized roles** covering architecture, development, testing, security, operations, cloud infrastructure, enterprise systems, and 24 POWERFUL-tier advanced engineering skills. #### 🏗️ Senior Software Architect **Status:** ✅ Production Ready | **Version:** 1.0 @@ -2173,7 +2173,7 @@ Explore our complete ecosystem of Claude Code augmentation tools and utilities: - ⚡ **Rapid Prototyping** - Create custom skills in minutes, not hours **Perfect For:** -- Building custom skills beyond the 53 provided in this library +- Building custom skills beyond the 85 provided in this library - Generating domain-specific agents for your organization - Scaling AI customization across teams - Rapid prototyping of specialized workflows @@ -2212,7 +2212,7 @@ Explore our complete ecosystem of Claude Code augmentation tools and utilities: ``` ┌─────────────────────────────────────────────────────────┐ │ Claude Skills Library (This Repository) │ -│ 53 Domain Expert Skills - Marketing to Engineering │ +│ 85 Domain Expert Skills - Marketing to Engineering │ │ Use for: Domain expertise, frameworks, best practices │ └────────────────┬────────────────────────────────────────┘ │ @@ -2233,12 +2233,12 @@ Explore our complete ecosystem of Claude Code augmentation tools and utilities: ``` **Workflow:** -1. **Start here** (Skills Library) - Get 53 production-ready expert skills +1. **Start here** (Skills Library) - Get 85 production-ready expert skills 2. **Expand** (Skill Factory) - Generate custom skills for your specific needs 3. **Supercharge** (Tresor) - Use skills + agents + commands in Claude Code development **Together they provide:** -- ✅ 53 ready-to-use expert skills (this repo) +- ✅ 85 ready-to-use expert skills (this repo) - ✅ Unlimited custom skill generation (Factory) - ✅ Complete development workflow automation (Tresor) - ✅ Cross-platform compatibility (Claude.ai, Claude Code, API) @@ -2251,7 +2251,7 @@ Explore our complete ecosystem of Claude Code augmentation tools and utilities: ### Current Status (Q4 2025) -**✅ Phase 1: Complete - 53 Production-Ready Skills** +**✅ Phase 1: Complete - 85 Production-Ready Skills** **Marketing Skills (6):** - Content Creator - Brand voice analysis, SEO optimization, social media frameworks @@ -2347,7 +2347,7 @@ Explore our complete ecosystem of Claude Code augmentation tools and utilities: | Metric | Current | Target (Q3 2026) | |--------|---------|------------------| -| Available Skills | 53 | 55+ | +| Available Skills | 85 | 55+ | | Skill Categories | 8 | 9 | | Python Tools | 87+ | 110+ | | Time Savings | 70% | 85% | @@ -2356,7 +2356,7 @@ Explore our complete ecosystem of Claude Code augmentation tools and utilities: | Organizations | 25 | 250+ | | Industries Covered | Tech, HealthTech | Tech, Health, Finance, Manufacturing | -### ROI Metrics (Current - 53 Skills) +### ROI Metrics (Current - 85 Skills) **Time Savings Per Organization:** - Marketing teams: 310 hours/month (Content + Demand Gen + PMM + ASO + Social Media) From 7c97272c871cc94fe6b7ea8abd254dff454f194e Mon Sep 17 00:00:00 2001 From: Alireza Rezvani Date: Wed, 4 Mar 2026 02:36:21 +0100 Subject: [PATCH 2/2] Dev (#228) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Improve senior-fullstack skill description and workflow validation - Expand frontmatter description with concrete actions and trigger clauses - Add validation steps to scaffolding workflow (verify scaffold succeeded) - Add re-run verification step to audit workflow (confirm P0 fixes) * chore: sync codex skills symlinks [automated] * fix(skill): normalize senior-fullstack frontmatter to inline format Normalize YAML description from block scalar (>) to inline single-line format matching all other 50+ skills. Align frontmatter trigger phrases with the body's Trigger Phrases section to eliminate duplication. Co-Authored-By: Claude Opus 4.6 * fix(ci): add GITHUB_TOKEN to checkout + restore corrupted skill descriptions - Add token: ${{ secrets.GITHUB_TOKEN }} to actions/checkout@v4 in sync-codex-skills.yml so git-auto-commit-action can push back to branch (fixes: fatal: could not read Username, exit 128) - Restore correct description for incident-commander (was: 'Skill from engineering-team') - Restore correct description for senior-fullstack (was: '>') * fix(ci): pass PROJECTS_TOKEN to fix automated commits + remove duplicate checkout Fixes PROJECTS_TOKEN passthrough for git-auto-commit-action and removes duplicate checkout step in pr-issue-auto-close workflow. * fix(ci): remove stray merge conflict marker in sync-codex-skills.yml (#221) Co-authored-by: Leo * fix(ci): fix workflow errors + add OpenClaw support (#222) * feat: add 20 new practical skills for professional Claude Code users New skills across 5 categories: Engineering (12): - git-worktree-manager: Parallel dev with port isolation & env sync - ci-cd-pipeline-builder: Generate GitHub Actions/GitLab CI from stack analysis - mcp-server-builder: Build MCP servers from OpenAPI specs - changelog-generator: Conventional commits to structured changelogs - pr-review-expert: Blast radius analysis & security scan for PRs - api-test-suite-builder: Auto-generate test suites from API routes - env-secrets-manager: .env management, leak detection, rotation workflows - database-schema-designer: Requirements to migrations & types - codebase-onboarding: Auto-generate onboarding docs from codebase - performance-profiler: Node/Python/Go profiling & optimization - runbook-generator: Operational runbooks from codebase analysis - monorepo-navigator: Turborepo/Nx/pnpm workspace management Engineering Team (2): - stripe-integration-expert: Subscriptions, webhooks, billing patterns - email-template-builder: React Email/MJML transactional email systems Product Team (3): - saas-scaffolder: Full SaaS project generation from product brief - landing-page-generator: High-converting landing pages with copy frameworks - competitive-teardown: Structured competitive product analysis Business Growth (1): - contract-and-proposal-writer: Contracts, SOWs, NDAs per jurisdiction Marketing (1): - prompt-engineer-toolkit: Systematic prompt development & A/B testing Designed for daily professional use and commercial distribution. * chore: sync codex skills symlinks [automated] * docs: update README with 20 new skills, counts 65→86, new skills section * docs: add commercial distribution plan (Stan Store + Gumroad) * docs: rewrite CHANGELOG.md with v2.0.0 release (65 skills, 9 domains) (#226) * docs: rewrite CHANGELOG.md with v2.0.0 release (65 skills, 9 domains) - Consolidate 191 commits since v1.0.2 into proper v2.0.0 entry - Document 12 POWERFUL-tier skills, 37 refactored skills - Add new domains: business-growth, finance - Document Codex support and marketplace integration - Update version history summary table - Clean up [Unreleased] to only planned work * docs: add 24 POWERFUL-tier skills to plugin, fix counts to 85 across all docs - Add engineering-advanced-skills plugin (24 POWERFUL-tier skills) to marketplace.json - Add 13 missing skills to CHANGELOG v2.0.0 (agent-workflow-designer, api-test-suite-builder, changelog-generator, ci-cd-pipeline-builder, codebase-onboarding, database-schema-designer, env-secrets-manager, git-worktree-manager, mcp-server-builder, monorepo-navigator, performance-profiler, pr-review-expert, runbook-generator) - Fix skill count: 86→85 (excl sample-skill) across README, CHANGELOG, marketplace.json - Fix stale 53→85 references in README - Add engineering-advanced-skills install command to README - Update marketplace.json version to 2.0.0 --------- Co-authored-by: Leo --------- Co-authored-by: Baptiste Fernandez Co-authored-by: alirezarezvani <5697919+alirezarezvani@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 Co-authored-by: Leo Co-authored-by: Leo