$curl -o .claude/agents/CLAUDE.md https://raw.githubusercontent.com/alirezarezvani/claude-skills/HEAD/agents/CLAUDE.mdThis guide provides comprehensive instructions for creating **cs-* prefixed agents** that seamlessly integrate with the 346 production skills in this repository (count derived via scripts/derive_counters.py).
| 1 | # Agent Development Guide |
| 2 | |
| 3 | This guide provides comprehensive instructions for creating **cs-* prefixed agents** that seamlessly integrate with the 346 production skills in this repository (count derived via `scripts/derive_counters.py`). |
| 4 | |
| 5 | ## Agent Architecture |
| 6 | |
| 7 | ### What are cs-* Agents? |
| 8 | |
| 9 | **cs-* agents** are specialized Claude Code agents that orchestrate the repository's 346 skills. Each agent: |
| 10 | - References skills via relative paths (`../marketing-skill/`) |
| 11 | - Executes Python automation tools from skill packages |
| 12 | - Follows established workflows and templates |
| 13 | - Maintains skill portability and independence |
| 14 | |
| 15 | **Key Principle**: Agents ORCHESTRATE skills, they don't replace them. Skills remain self-contained and portable. |
| 16 | |
| 17 | ### ClawHub Publishing Constraints |
| 18 | |
| 19 | When skills are published to **ClawHub** (clawhub.com): |
| 20 | - **cs- prefix for slug conflicts only** — applies only on the ClawHub registry when another publisher already owns the slug. Repo folder names and local skill names are never renamed. |
| 21 | - **No paid/commercial service dependencies** — skills must not require paid third-party API keys or commercial services unless provided by the project itself. |
| 22 | - **plugin.json** — ONLY fields: `name`, `description`, `version`, `author`, `homepage`, `repository`, `license`, `skills: "./"`. |
| 23 | - **Rate limit:** 5 new skills/hour on ClawHub. Use drip publishing for bulk operations. |
| 24 | |
| 25 | ### Production Agents |
| 26 | |
| 27 | **33 agents live in this folder** (93 agent files repo-wide, including plugin-bundled agents). A representative selection: |
| 28 | |
| 29 | | Agent | Domain | Description | |
| 30 | |-------|--------|-------------| |
| 31 | | [cs-content-creator](marketing/cs-content-creator.md) | Marketing | AI-powered content creation with brand voice consistency and SEO optimization | |
| 32 | | [cs-demand-gen-specialist](marketing/cs-demand-gen-specialist.md) | Marketing | Demand generation and customer acquisition specialist | |
| 33 | | [cs-ceo-advisor](c-level/cs-ceo-advisor.md) | C-Level | Strategic leadership advisor for CEOs | |
| 34 | | [cs-cto-advisor](c-level/cs-cto-advisor.md) | C-Level | Technical leadership advisor for CTOs | |
| 35 | | [cs-product-manager](product/cs-product-manager.md) | Product | RICE prioritization and customer discovery | |
| 36 | | [cs-product-strategist](product/cs-product-strategist.md) | Product | Product strategy, OKR cascades, market positioning | |
| 37 | | [cs-agile-product-owner](product/cs-agile-product-owner.md) | Product | Agile product ownership and backlog management | |
| 38 | | [cs-ux-researcher](product/cs-ux-researcher.md) | Product | UX research, usability testing, design insights | |
| 39 | | [cs-product-analyst](product/cs-product-analyst.md) | Product | Product analytics, KPI design, experiment design | |
| 40 | | [cs-engineering-lead](engineering-team/cs-engineering-lead.md) | Engineering | Engineering team coordination and incident management | |
| 41 | | [cs-workspace-admin](engineering-team/cs-workspace-admin.md) | Engineering | Google Workspace administration via gws CLI | |
| 42 | | [cs-senior-engineer](engineering/cs-senior-engineer.md) | Engineering | Architecture decisions, code review, CI/CD setup | |
| 43 | | [cs-fullstack-engineer](engineering/cs-fullstack-engineer.md) | Engineering | Fullstack orchestrator (v2.8.1): walks 7 Matt Pocock forcing questions, picks profile via deterministic engine, forks (`context: fork`) into api-design-reviewer / database-designer / slo-architect / ci-cd-pipeline-builder. Invokable via `/cs:fullstack-review` or `Agent({subagent_type:"cs-fullstack-engineer"})`. | |
| 44 | | [cs-frontend-engineer](engineering/cs-frontend-engineer.md) | Engineering | Frontend orchestrator (v2.8.1): walks 7 forcing questions (device, LCP target, rendering, bundle, SEO, design system, WCAG), picks framework profile, forks into a11y-audit / performance-profiler / epic-design / apple-hig-expert. Invokable via `/cs:frontend-review`. | |
| 45 | | [cs-backend-engineer](engineering/cs-backend-engineer.md) | Engineering | Backend orchestrator (v2.8.1): walks 7 forcing questions (read/write + QPS, tenancy, sync vs async, sensitivity, pattern, RPO/RTO, SLO), picks language + pattern profile, forks into api-design-reviewer / database-designer / migration-architect / slo-architect / observability-designer. Invokable via `/cs:backend-review`. | |
| 46 | | [cs-growth-strategist](business-growth/cs-growth-strategist.md) | Business | Growth strategy and revenue optimization | |
| 47 | | [cs-financial-analyst](finance/cs-financial-analyst.md) | Finance | Financial analysis, DCF valuation, SaaS metrics | |
| 48 | | [cs-project-manager](project-management/cs-project-manager.md) | PM | Project management with Atlassian integration | |
| 49 | | [cs-quality-regulatory](ra-qm-team/cs-quality-regulatory.md) | RA/QM | Regulatory affairs and quality management | |
| 50 | |
| 51 | **Template Available**: [templates/agent-template.md](../templates/agent-template.md) (318 lines) - Use this to create new agents |
| 52 | |
| 53 | ### Agent vs Skill |
| 54 | |
| 55 | | Aspect | Agent (cs-*) | Skill | |
| 56 | |--------|-------------|-------| |
| 57 | | **Purpose** | Orchestrate and execute workflows | Provide tools, knowledge, templates | |
| 58 | | **Location** | |