Skip to content

Dev - #362

Merged
alirezarezvani merged 4 commits into
mainfrom
dev
Mar 15, 2026
Merged

Dev#362
alirezarezvani merged 4 commits into
mainfrom
dev

Conversation

@alirezarezvani

Copy link
Copy Markdown
Owner

Summary

Checklist

  • Target branch is dev (not main — PRs to main will be auto-closed)
  • Skill has SKILL.md with valid YAML frontmatter (name, description, license)
  • Scripts (if any) run with --help without errors
  • No hardcoded API keys, tokens, or secrets
  • No vendor-locked dependencies without open-source fallback
  • Follows existing directory structure (domain/skill-name/SKILL.md)

Type of Change

  • New skill
  • Improvement to existing skill
  • Bug fix
  • Documentation
  • Infrastructure / CI

Testing

Leo added 4 commits March 14, 2026 00:38
…commands

- Content Strategist: 6 commands (/content:audit, cluster, brief, calendar, repurpose, seo), 8 bundled skills
- Product Manager: 7 commands (/pm:story, prd, prioritize, experiment, sprint, retro, metrics), 6 bundled skills
- DevOps Engineer: 7 commands (/devops:deploy, infra, docker, monitor, incident, security, cost), 4 bundled skills
- Finance Lead: 6 commands (/finance:model, fundraise, pricing, burn, unit-economics, board), 2 bundled skills

Total personas: 3 → 7
…Metrics

Aligns new personas with agency-agents structure:
- Core Capabilities: scannable bullet-list summary
- Decision Framework: when to use (and when NOT to)
- Success Metrics: quantified outcomes

All 4 Tier 1 personas now match full agency-agents spec.
…s, not job descriptions

- Cut 70% bloat (750 lines removed, 220 added)
- Dropped corporate sections (Core Capabilities, Decision Framework → merged naturally)
- Commands as the centerpiece — what you DO, not what you ARE
- 'How You Think' + 'What You Never Do' = personality, not résumé
- 'When to Use Me' with ✅/❌ = clear routing
- 'What Good Looks Like' = success without corporate metric tables

Our format: opinionated colleague with tools
Agency-agents format: job description with capabilities
Different on purpose.
@alirezarezvani
alirezarezvani merged commit 11a4271 into main Mar 15, 2026
6 checks passed
@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

test comment

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Purpose

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: 177 production-ready skills across 9 domains with 254 Python automation tools, 357 reference guides, 17 agents, and 22 slash commands.

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.

Navigation Map

This repository uses modular documentation. For domain-specific guidance, see:

Domain CLAUDE.md Location Focus
Agent Development agents/CLAUDE.md cs-* agent creation, YAML frontmatter, relative paths
Marketing Skills marketing-skill/CLAUDE.md Content creation, SEO, ASO, demand gen, campaign analytics
Product Team product-team/CLAUDE.md RICE, OKRs, user stories, UX research, SaaS scaffolding
Engineering (Core) engineering-team/CLAUDE.md Fullstack, AI/ML, DevOps, security, data, QA tools
Engineering (POWERFUL) engineering/ Agent design, RAG, MCP, CI/CD, database, observability
C-Level Advisory c-level-advisor/CLAUDE.md CEO/CTO strategic decision-making
Project Management project-management/CLAUDE.md Atlassian MCP, Jira/Confluence integration
RA/QM Compliance ra-qm-team/CLAUDE.md ISO 13485, MDR, FDA, GDPR, ISO 27001 compliance
Business & Growth business-growth/CLAUDE.md Customer success, sales engineering, revenue operations
Finance finance/CLAUDE.md Financial analysis, DCF valuation, budgeting, forecasting, SaaS metrics
Standards Library standards/CLAUDE.md Communication, quality, git, security standards
Templates templates/CLAUDE.md Template system usage

Architecture Overview

Repository Structure

claude-code-skills/
├── .claude-plugin/            # Plugin registry (marketplace.json)
├── agents/                    # 15 cs-* prefixed agents across all domains
├── commands/                  # 22 slash commands (changelog, tdd, saas-health, workspace, prd, sprint-plan, ar:*, etc.)
├── engineering-team/          # 24 core engineering skills + Playwright Pro + Self-Improving Agent
├── engineering/               # 25 POWERFUL-tier advanced skills
├── product-team/              # 12 product skills + Python tools
├── marketing-skill/           # 43 marketing skills (7 pods) + Python tools
├── c-level-advisor/           # 28 C-level advisory skills (10 roles + orchestration)
├── project-management/        # 6 PM skills + Atlassian MCP
├── ra-qm-team/                # 12 RA/QM compliance skills
├── business-growth/           # 4 business & growth skills + Python tools
├── finance/                   # 2 finance skills + Python tools
├── eval-workspace/            # Skill evaluation results (Tessl)
├── standards/                 # 5 standards library files
├── templates/                 # Reusable templates
├── docs/                      # MkDocs Material documentation site
├── scripts/                   # Build scripts (docs generation)
└── documentation/             # Implementation plans, sprints, delivery

Skill Package Pattern

Each skill follows this structure:

skill-name/
├── SKILL.md              # Master documentation
├── scripts/              # Python CLI tools (no ML/LLM calls)
├── references/           # Expert knowledge bases
└── assets/               # User templates

Design Philosophy: Skills are self-contained packages. Each includes executable tools (Python scripts), knowledge bases (markdown references), and user-facing templates. Teams can extract a skill folder and use it immediately.

Key Pattern: Knowledge flows from references/ → into SKILL.md workflows → executed via scripts/ → applied using assets/ templates.

Git Workflow

Branch Strategy: feature → dev → main (PR only)

Branch Protection Active: Main branch requires PR approval. Direct pushes blocked.

Quick Start

# 1. Always start from dev
git checkout dev
git pull origin dev

# 2. Create feature branch
git checkout -b feature/agents-{name}

# 3. Work and commit (conventional commits)
feat(agents): implement cs-{agent-name}
fix(tool): correct calculation logic
docs(workflow): update branch strategy

# 4. Push and create PR to dev
git push origin feature/agents-{name}
gh pr create --base dev --head feature/agents-{name}

# 5. After approval, PR merges to dev
# 6. Periodically, dev merges to main via PR

Branch Protection Rules:

  • ✅ Main: Requires PR approval, no direct push
  • ✅ Dev: Unprotected, but PRs recommended
  • ✅ All: Conventional commits enforced

See documentation/WORKFLOW.md for complete workflow guide.
See standards/git/git-workflow-standards.md for commit standards.

Development Environment

No build system or test frameworks - intentional design choice for portability.

Python Scripts:

  • Use standard library only (minimal dependencies)
  • CLI-first design for easy automation
  • Support both JSON and human-readable output
  • No ML/LLM calls (keeps skills portable and fast)

If adding dependencies:

  • Keep scripts runnable with minimal setup (pip install package at most)
  • Document all dependencies in SKILL.md
  • Prefer standard library implementations

Current Version

Version: v2.1.2 (latest)

v2.1.2 Highlights:

  • Landing page generator now outputs Next.js TSX + Tailwind CSS by default (4 design styles, 7 section generators)
  • Brand voice integration — landing page workflow uses marketing brand voice analyzer to match copy tone to design style
  • 25 Python scripts fixed across all domains (syntax, dependencies, argparse)
  • 237/237 scripts verified passing --help
  • Competitive teardown SKILL.md fixed (6 broken file references)
  • Cross-domain workflows documented (product + marketing skill integration)

v2.1.1 (2026-03-07):

  • 18 skills optimized from 66-83% to 85-100% via Tessl quality review
  • YAML frontmatter (name + description) added to all SKILL.md files
  • 6 new agents + 5 slash commands, Gemini CLI support, MkDocs docs site

v2.0.0 (2026-02-16):

  • 25 POWERFUL-tier engineering skills added (engineering/ folder)
  • Plugin marketplace infrastructure (.claude-plugin/marketplace.json)
  • Multi-platform support: Claude Code, OpenAI Codex, OpenClaw

Past Sprints: See documentation/delivery/ and CHANGELOG.md for history.

Roadmap

Phase 1-2 Complete: 177 production-ready skills deployed across 9 domains

  • Engineering Core (24), Engineering POWERFUL (25), Product (8), Marketing (43), PM (6), C-Level (28), RA/QM (12), Business & Growth (4), Finance (2)
  • 254 Python automation tools, 357 reference guides, 17 agents, 22 commands
  • Complete enterprise coverage from engineering through regulatory compliance, sales, customer success, and finance
  • MkDocs Material docs site with 210+ indexed pages for SEO

See domain-specific roadmaps in each skill folder's README.md or roadmap files.

Key Principles

  1. Skills are products - Each skill deployable as standalone package
  2. Documentation-driven - Success depends on clear, actionable docs
  3. Algorithm over AI - Use deterministic analysis (code) vs LLM calls
  4. Template-heavy - Provide ready-to-use templates users customize
  5. Platform-specific - Specific best practices > generic advice

ClawHub Publishing Constraints

This repository publishes skills to ClawHub (clawhub.com) as the distribution registry. The following rules are non-negotiable:

  1. cs- prefix for slug conflicts only. When a skill slug is already taken on ClawHub by another publisher, publish with the cs- prefix (e.g., cs-copywriting, cs-seo-audit). The cs- prefix applies only on the ClawHub registry — repo folder names, local skill names, and all other tools (Claude Code, Codex, Gemini CLI) remain unchanged.
  2. Never rename repo folders or local skill names to match ClawHub slugs. The repo is the source of truth.
  3. No paid/commercial service dependencies. Skills must not require paid third-party API keys or commercial services unless provided by the project itself. Free-tier APIs and BYOK (bring-your-own-key) patterns are acceptable.
  4. Rate limit: 5 new skills per hour on ClawHub. Batch publishes must respect this. Use the drip timer (clawhub-drip.timer) for bulk operations.
  5. plugin.json schema — ONLY these fields: name, description, version, author, homepage, repository, license, skills: "./". No extra fields.
  6. Version follows repo versioning. ClawHub package versions must match the repo release version (currently v2.1.2+).

Anti-Patterns to Avoid

  • Creating dependencies between skills (keep each self-contained)
  • Adding complex build systems or test frameworks (maintain simplicity)
  • Generic advice (focus on specific, actionable frameworks)
  • LLM calls in scripts (defeats portability and speed)
  • Over-documenting file structure (skills are simple by design)

Working with This Repository

Creating New Skills: Follow the appropriate domain's roadmap and CLAUDE.md guide (see Navigation Map above).

Editing Existing Skills: Maintain consistency across markdown files. Use the same voice, formatting, and structure patterns.

Quality Standard: Each skill should save users 40%+ time while improving consistency/quality by 30%+.

Additional Resources


Last Updated: March 11, 2026
Version: v2.1.2
Status: 177 skills deployed across 9 domains, 19 marketplace plugins, docs site live

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

REPLACING PREVIOUS TEST COMMENT - PR Review: 4 New Personas + README Rebrand. The 4 personas are high quality with a compelling voice and clear command structure. Key issues: (1) README badge updated 177->192 but only 4 files added - inflated count needs correction or documentation. (2) TEMPLATE.md not updated to reflect new opinionated-colleague format - future contributors will produce inconsistent personas. (3) Frontmatter skill references need validation (ceo-advisor is a persona not a skill; ms365-tenant-manager is an odd fit for DevOps; competitor-alternatives has no clear mapping). (4) PR checklist left entirely unchecked. (5) No license field in YAML frontmatter. Minor: devops-engineer.md has 4 bundled skills vs 8 for content-strategist; /finance:fundraise lacks a valuation tool reference; README and CLAUDE.md descriptions are out of sync on the library description.

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

Commercial Distribution — Stan Store & Gumroad

Product Bundles

🚀 Indie Hacker Pack — $49

Everything you need to launch a SaaS product in a weekend.

Includes 6 skills:

  • saas-scaffolder — Full SaaS project generation (auth, billing, dashboard, landing page)
  • stripe-integration-expert — Subscriptions, webhooks, usage billing, customer portal
  • landing-page-generator — High-converting pages with copy frameworks (PAS, AIDA, BAB)
  • email-template-builder — React Email transactional system (welcome, invoice, digest)
  • database-schema-designer — Requirements → migrations, types, RLS policies
  • changelog-generator — Conventional commits → structured release notes

Value prop: "Ship your SaaS in days, not months. 6 skills that replace $1,200+ in boilerplate templates."


🏗️ Engineering Lead Pack — $49

Level up your engineering workflow and team productivity.

Includes 6 skills:

  • git-worktree-manager — Parallel Claude Code sessions with port isolation
  • ci-cd-pipeline-builder — Analyze stack → generate CI/CD configs automatically
  • pr-review-expert — Blast radius analysis, security scan, coverage delta
  • api-test-suite-builder — Scan routes → complete test suites (Vitest, Pytest)
  • env-secrets-manager — .env management, leak detection, rotation workflows
  • performance-profiler — Node/Python/Go profiling, load testing, optimization

Value prop: "Stop wasting hours on DevOps busywork. 6 skills that save 10+ hours per week."


💼 Agency & Freelancer Pack — $39

Win more clients and deliver better projects.

Includes 5 skills:

  • contract-and-proposal-writer — Contracts, SOWs, NDAs (US, EU, DACH jurisdiction)
  • competitive-teardown — Structured competitive analysis with SWOT & positioning
  • codebase-onboarding — Auto-generate onboarding docs from any codebase
  • landing-page-generator — High-converting landing pages for client projects
  • runbook-generator — Operational runbooks from codebase analysis

Value prop: "From proposal to handoff — everything you need to run a professional dev agency."


🤖 AI Builder Pack — $39

Build production AI systems, not toy demos.

Includes 4 skills:

  • mcp-server-builder — OpenAPI spec → working MCP server (Python + TypeScript)
  • prompt-engineer-toolkit — A/B testing, version control, quality metrics for prompts
  • agent-workflow-designer — Multi-agent orchestration (Claude Code, OpenClaw, CrewAI)
  • monorepo-navigator — Manage complex multi-package AI projects

Value prop: "From prompt to production. 4 skills for serious AI engineering."


🎯 Complete Collection — $99

All 20 new skills + all 66 original skills = 86 total.

Everything above plus:

  • All 12 RA/QM regulatory skills
  • All 6 project management skills
  • C-level advisory (CEO, CTO)
  • Full marketing suite
  • Business growth & finance

Value prop: "The most comprehensive Claude Code skill library available. 86 skills, 10K+ lines of production-ready expertise."


Individual Skills — $9 each

Any single skill can be purchased individually on Gumroad.


Free Tier (GitHub)

All skills remain free and open source on GitHub. Paid bundles add:

  • ✅ Curated combinations for specific workflows
  • ✅ Priority updates and new skills
  • ✅ Installation scripts for one-click setup
  • ✅ Bonus: CLAUDE.md templates pre-configured per bundle

Stan Store Setup

Products to Create

  1. Indie Hacker Pack ($49)
  2. Engineering Lead Pack ($49)
  3. Agency & Freelancer Pack ($39)
  4. AI Builder Pack ($39)
  5. Complete Collection ($99)

Delivery

  • Digital download (ZIP with SKILL.md files + install script)
  • Each bundle includes a README-INSTALL.md with setup instructions
  • License: MIT (same as GitHub, but bundled for convenience)

Landing Page Copy

Headline: "86 Expert Skills for Claude Code — Ship Faster, Build Better"

Subheadline: "Production-ready expertise bundles that turn Claude Code into a senior engineer, product manager, and business consultant. Used by 960+ developers."

Social Proof:

  • 960+ GitHub stars
  • 86 skills across 9 categories
  • Used by engineers at [companies]
  • MIT licensed, actively maintained

Gumroad Setup

Products

Same 5 bundles + 20 individual skills at $9 each.

Tags

claude-code, ai-skills, developer-tools, saas-boilerplate, claude-ai, mcp, prompt-engineering, ai-engineering

Categories

  • Software Development
  • AI & Machine Learning
  • Business & Productivity

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

test2

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

PR Review: 4 New Personas + README Rebrand

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

PR Review: 4 New Personas + README Rebrand. This PR is already merged; feedback is for future reference. STRENGTHS: (1) Opinionated-colleague voice is more engaging than TEMPLATE.md - clean How-You-Think / What-You-Never-Do / When-to-Use-Me structure. (2) Commands well-scoped with clear one-sentence deliverables. (3) Routing yes/no sections set correct expectations. (4) Quantified success metrics are useful. ISSUES: (1) README badge 177->192 but only 4 files added - inflated by 11. Fix: revert to 177 or document the delta. CLAUDE.md still says 177. (2) TEMPLATE.md not updated for new opinionated format - future contributors will produce inconsistent personas. Fix: update TEMPLATE.md or document both patterns in README. (3) Frontmatter skill references need validation: ceo-advisor is a persona not a skill; ms365-tenant-manager is odd for DevOps; competitor-alternatives has no clear mapping. (4) PR checklist entirely unchecked - mark N/A where not applicable. (5) No license field in YAML frontmatter for any of the 4 files. MINOR: devops-engineer.md has 4 bundled skills vs 8 for content-strategist; finance:fundraise lacks a valuation tool reference; README and CLAUDE.md library descriptions are out of sync. SUMMARY: High quality personas with compelling voice. Main fixes: skill count (177 vs 192) and update TEMPLATE.md.

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

PR Review: 4 New Personas + README Rebrand (already merged - for team reference)

@claude

claude Bot commented Mar 15, 2026

Copy link
Copy Markdown

PR Review: 4 New Personas + README Rebrand (already merged - for team reference)

What Works Well

Opinionated voice (How-You-Think / What-You-Never-Do / When-to-Use-Me) is much more engaging than TEMPLATE.md. Command definitions are well-scoped (/finance:burn, /devops:incident, /pm:prd) with clear deliverables. Quantified success metrics ("20%+ MoM organic growth", "LTV:CAC above 3:1") give real signal.

Issues to Address

  1. Skill count mismatch in README: badge updated 177 to 192 (+15) but only 4 files were added. Personas were never counted in the 177 figure. CLAUDE.md still says 177. Fix: revert to 177 or document which 15 skills justify 192.

  2. TEMPLATE.md not updated: the new format intentionally differs ("opinionated colleague vs job description" per commit message) but TEMPLATE.md is unchanged. Future contributors will produce inconsistent personas. Fix: update agents/personas/TEMPLATE.md or document both patterns.

  3. Frontmatter skill references need validation: finance-lead.md lists "ceo-advisor" (a persona, not a skill); devops-engineer.md lists "ms365-tenant-manager" (unusual fit for DevOps); content-strategist.md lists "competitor-alternatives" (no clear folder mapping).

  4. PR checklist entirely unchecked: all boxes are empty. Future persona PRs should tick relevant boxes or mark items N/A with a reason.

  5. No license field in YAML frontmatter: the PR checklist requires name, description, and license. None of the 4 new persona files include a license field.

Minor Observations

devops-engineer.md has only 4 bundled skills vs 8 for content-strategist (could add ci-cd or observability). The /finance:fundraise command mentions "comparable valuations" but references no tool that provides this (cs-financial-analyst would fit). README now says "Agent Skills and Plugins" but CLAUDE.md says "comprehensive skills library for Claude AI" - keep these in sync.

Summary

The 4 personas are high quality with compelling voice and clear command structure. Main actionable fixes: correct the README skill count (177 vs 192) and update TEMPLATE.md so future contributors have a consistent reference.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant