skills/borghei__claude-skills
1
0
Fork 0
mirror of https://github.com/borghei/Claude-Skills.git synced 2026-09-14 19:41:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat: redesign README (1082 → 196 lines) + create docs/ reference

Browse Source 
- Rewrite README.md: concise stats, 2 install methods, 13-row domain
  table, agent overview, clean structure tree
- Create docs/SKILLS.md: full 204-skill reference by domain
- Create docs/USAGE.md: detailed CLI examples and multi-platform guide
- Create docs/AGENTS.md: 6 subagents + 19 role-based agents documented
- Create docs/WORKFLOWS.md: 12 CI/CD workflow reference
- Remove bloat: "What's New" section, full skills tables, verbose
  examples all moved to docs/
This commit is contained in:
Brian Borghei
2026-03-21 18:03:07 +01:00
parent deb73d4795
commit efcc8a3b9e
5 changed files with 997 additions and 990 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+105 -990
View File
File diff suppressed because it is too large Load Diff
docs/AGENTS.md
+104
View File
@@ -0,0 +1,104 @@
# Agents
Claude Skills includes two types of agents: **built-in subagents** (`.claude/agents/`) for autonomous code workflows, and **role-based agents** (`agents/`) that combine multiple skills into specialized personas.
---
## Built-In Subagents (6)
Located in `.claude/agents/`. Invoke with `/agents/name` in Claude Code.
| Agent | What It Does | Invoke With |
|-------|-------------|-------------|
| **code-reviewer** | Scores code across 5 categories (1-10), flags bugs, security holes, performance issues | `/agents/code-reviewer` |
| **security-auditor** | OWASP Top 10 audit, secrets scanning, infrastructure security checks | `/agents/security-auditor` |
| **qa-engineer** | Test coverage analysis, bug hunting, test generation, quality metrics | `/agents/qa-engineer` |
| **doc-generator** | Generates README, API docs, architecture docs, changelog entries from code | `/agents/doc-generator` |
| **changelog-manager** | Builds Keep a Changelog entries from git history, determines semver | `/agents/changelog-manager` |
| **git-workflow** | Conventional commits, branch strategy, PR creation, release workflow | `/agents/git-workflow` |
---
## Role-Based Agents (19)
Located in `agents/`. These are specialized AI personas that orchestrate multiple skills with domain-specific behavior. Each agent file defines the persona, tools, and workflows the agent uses.
### Engineering (6)
| Agent | Role | File |
|-------|------|------|
| **cs-tech-lead** | Technical leadership, architecture reviews, team mentoring | `agents/engineering/cs-tech-lead.md` |
| **cs-engineering-director** | Engineering management, hiring, process optimization | `agents/engineering/cs-engineering-director.md` |
| **cs-architecture-reviewer** | Architecture review, system design validation | `agents/engineering/cs-architecture-reviewer.md` |
| **cs-code-auditor** | Deep code audit, quality analysis, refactoring recommendations | `agents/engineering/cs-code-auditor.md` |
| **cs-doc-writer** | Technical documentation, API docs, architecture guides | `agents/engineering/cs-doc-writer.md` |
| **cs-security-engineer** | Security engineering, threat modeling, vulnerability assessment | `agents/engineering/cs-security-engineer.md` |
### C-Level (3)
| Agent | Role | File |
|-------|------|------|
| **cs-ceo-advisor** | Strategic planning, board governance, investor relations | `agents/c-level/cs-ceo-advisor.md` |
| **cs-cto-advisor** | Technical strategy, architecture decisions, engineering leadership | `agents/c-level/cs-cto-advisor.md` |
| **cs-cfo-advisor** | Financial planning, fundraising, unit economics | `agents/c-level/cs-cfo-advisor.md` |
### Compliance (2)
| Agent | Role | File |
|-------|------|------|
| **cs-compliance-auditor** | Multi-framework compliance audit across 18 standards (SOC 2, ISO 27001, GDPR, HIPAA, PCI-DSS, EU AI Act, NIS2, DORA, NIST CSF 2.0, CCPA) | `agents/compliance/cs-compliance-auditor.md` |
| **cs-ciso-advisor** | Security strategy, risk quantification, compliance roadmap | `agents/compliance/cs-ciso-advisor.md` |
### Marketing (3)
| Agent | Role | File |
|-------|------|------|
| **cs-content-creator** | Content strategy, brand voice, SEO optimization | `agents/marketing/cs-content-creator.md` |
| **cs-demand-gen-specialist** | Demand generation, paid media, lead nurturing | `agents/marketing/cs-demand-gen-specialist.md` |
| **cs-seo-analyst** | Technical SEO, keyword research, analytics | `agents/marketing/cs-seo-analyst.md` |
### Product (1)
| Agent | Role | File |
|-------|------|------|
| **cs-product-manager** | Product strategy, roadmap planning, user research | `agents/product/cs-product-manager.md` |
### Cross-Functional (4)
| Agent | Role | File |
|-------|------|------|
| **cs-cmo-advisor** | Marketing leadership, brand strategy, demand generation | `agents/cs-cmo-advisor.md` |
| **cs-design-lead** | Design leadership, design systems, UX strategy | `agents/cs-design-lead.md` |
| **cs-growth-lead** | Growth strategy, experimentation, product-led growth | `agents/cs-growth-lead.md` |
| **cs-privacy-officer** | Data privacy, GDPR/CCPA compliance, privacy engineering | `agents/cs-privacy-officer.md` |
---
## How Agents Orchestrate Skills
Agents combine multiple skills to handle complex, multi-step workflows. When you invoke an agent, it:
1. **Activates its persona** with role-specific expertise and communication style
2. **Selects relevant skills** from its domain based on the task
3. **Runs Python tools** from those skills to gather data and produce analysis
4. **Synthesizes results** into structured, actionable output
### Example Workflow: Engineering Director
When asked to "review our engineering health," the `cs-engineering-director` agent might:
1. Run `code_quality_analyzer.py` across key services (from `senior-fullstack`)
2. Analyze test coverage patterns (from `senior-qa`)
3. Check dependency health (from `dependency-auditor`)
4. Review CI/CD pipeline efficiency (from `devops-workflow-engineer`)
5. Produce a consolidated engineering health report with recommendations
### Example Workflow: Compliance Auditor
When asked to "audit SOC 2 readiness," the `cs-compliance-auditor` agent might:
1. Run infrastructure security checks (from `infrastructure-compliance-auditor`)
2. Evaluate access control policies (from `soc2-compliance-expert`)
3. Check encryption and secrets management (from `information-security-manager-iso27001`)
4. Cross-reference findings against SOC 2 Trust Services Criteria
5. Produce a gap analysis with remediation priorities
docs/SKILLS.md
+320
View File
@@ -0,0 +1,320 @@
# Skills Reference
Complete reference for all 204 skills across 13 domains. Each skill is a self-contained package with documentation (`SKILL.md`), Python CLI tools (`scripts/`), knowledge bases (`references/`), and user templates (`assets/`).
---
## Engineering (28)
Core software engineering expertise with Python automation tools.
| Skill | Description | Tools |
|-------|-------------|-------|
| [senior-architect](../engineering/senior-architect/SKILL.md) | System design, distributed systems, architectural patterns | 2 |
| [senior-frontend](../engineering/senior-frontend/SKILL.md) | React patterns, state management, performance, accessibility | 2 |
| [senior-backend](../engineering/senior-backend/SKILL.md) | API design, microservices, databases, caching, queues | 2 |
| [senior-fullstack](../engineering/senior-fullstack/SKILL.md) | React, Node.js, databases, API design, system architecture | 3 |
| [senior-qa](../engineering/senior-qa/SKILL.md) | Test strategy, automation frameworks, performance testing | 2 |
| [senior-devops](../engineering/senior-devops/SKILL.md) | Docker, Kubernetes, Terraform, CI/CD, monitoring, SRE | 2 |
| [senior-secops](../engineering/senior-secops/SKILL.md) | Security operations, vulnerability management, incident response | 2 |
| [senior-security](../engineering/senior-security/SKILL.md) | OWASP, threat modeling, penetration testing, compliance | 2 |
| [senior-mobile](../engineering/senior-mobile/SKILL.md) | React Native, iOS, Android, cross-platform, app store | 3 |
| [senior-cloud-architect](../engineering/senior-cloud-architect/SKILL.md) | AWS, GCP, Azure, multi-cloud, cost optimization | - |
| [senior-data-scientist](../engineering/senior-data-scientist/SKILL.md) | A/B testing, statistical analysis, feature engineering | 3 |
| [senior-data-engineer](../engineering/senior-data-engineer/SKILL.md) | Airflow, Spark, data pipelines, warehousing | 3 |
| [senior-ml-engineer](../engineering/senior-ml-engineer/SKILL.md) | ML pipelines, model deployment, MLOps, RAG systems | 3 |
| [senior-prompt-engineer](../engineering/senior-prompt-engineer/SKILL.md) | Prompt optimization, LLM evaluation, agents | 3 |
| [senior-computer-vision](../engineering/senior-computer-vision/SKILL.md) | Object detection, image segmentation, model training | 3 |
| [aws-solution-architect](../engineering/aws-solution-architect/SKILL.md) | Serverless patterns, CloudFormation, cost optimization | 2 |
| [code-reviewer](../engineering/code-reviewer/SKILL.md) | PR analysis, code quality checking, review automation | 2 |
| [incident-commander](../engineering/incident-commander/SKILL.md) | Incident response, severity classification, RCA | 3 |
| [ms365-tenant-manager](../engineering/ms365-tenant-manager/SKILL.md) | Office 365/Azure AD administration | 2 |
| [tdd-guide](../engineering/tdd-guide/SKILL.md) | Test-driven development workflow | 2 |
| [tech-stack-evaluator](../engineering/tech-stack-evaluator/SKILL.md) | Framework comparison, TCO analysis | 2 |
| [claude-code-mastery](../engineering/claude-code-mastery/SKILL.md) | CLAUDE.md optimization, skill authoring, subagents, hooks | 3 |
| [codex-cli-specialist](../engineering/codex-cli-specialist/SKILL.md) | Cross-platform skill authoring, Codex CLI, conversion tools | 3 |
| [devops-workflow-engineer](../engineering/devops-workflow-engineer/SKILL.md) | GitHub Actions, CI/CD pipelines, deployment strategies | 3 |
| [qa-browser-automation](../engineering/qa-browser-automation/SKILL.md) | 11-phase browser QA, health scoring, WCAG audit, visual regression | 4 |
| [release-orchestrator](../engineering/release-orchestrator/SKILL.md) | Release pipeline, pre-flight checks, versioning, readiness scoring | 4 |
| [doc-drift-detector](../engineering/doc-drift-detector/SKILL.md) | Documentation drift analysis, staleness scoring, API doc validation | 4 |
| [design-auditor](../engineering/design-auditor/SKILL.md) | 12-category design audit, AI slop detection, color contrast checking | 4 |
## Advanced Engineering (33)
Enterprise-grade skills with sophisticated analysis tooling.
| Skill | Description | Tools |
|-------|-------------|-------|
| [agent-designer](../engineering/agent-designer/SKILL.md) | Multi-agent architecture, tool schema generation | 3 |
| [api-design-reviewer](../engineering/api-design-reviewer/SKILL.md) | REST API linting, breaking change detection, scoring | 3 |
| [database-designer](../engineering/database-designer/SKILL.md) | Schema analysis, ERD generation, index optimization | 3 |
| [dependency-auditor](../engineering/dependency-auditor/SKILL.md) | Multi-language dependency scanning, license compliance | 3 |
| [interview-system-designer](../engineering/interview-system-designer/SKILL.md) | Interview loop design, question banks, calibration | 3 |
| [migration-architect](../engineering/migration-architect/SKILL.md) | Zero-downtime migration planning, rollback strategies | 3 |
| [observability-designer](../engineering/observability-designer/SKILL.md) | SLO design, alert optimization, dashboard generation | 3 |
| [rag-architect](../engineering/rag-architect/SKILL.md) | RAG pipeline building, chunking optimization | 3 |
| [release-manager](../engineering/release-manager/SKILL.md) | Automated changelog, semantic versioning | 3 |
| [skill-tester](../engineering/skill-tester/SKILL.md) | Meta-skill validator, quality scoring | 3 |
| [tech-debt-tracker](../engineering/tech-debt-tracker/SKILL.md) | AST parsing, debt prioritization, trend analysis | 3 |
| [agent-protocol](../engineering/agent-protocol/SKILL.md) | AI agent communication protocols, MCP, A2A, tool schemas | - |
| [agent-workflow-designer](../engineering/agent-workflow-designer/SKILL.md) | Multi-agent orchestration, workflow DAGs, agent routing | - |
| [api-test-suite-builder](../engineering/api-test-suite-builder/SKILL.md) | API testing frameworks, contract testing, load testing | - |
| [ci-cd-pipeline-builder](../engineering/ci-cd-pipeline-builder/SKILL.md) | CI/CD design, GitHub Actions, GitLab CI, deployment strategies | - |
| [codebase-onboarding](../engineering/codebase-onboarding/SKILL.md) | New developer onboarding, codebase docs, architecture guides | - |
| [database-schema-designer](../engineering/database-schema-designer/SKILL.md) | Schema design, normalization, migration planning, ERD | - |
| [env-secrets-manager](../engineering/env-secrets-manager/SKILL.md) | Secrets management, .env security, Vault, rotation policies | - |
| [git-worktree-manager](../engineering/git-worktree-manager/SKILL.md) | Git worktree workflows, parallel development, branches | - |
| [mcp-server-builder](../engineering/mcp-server-builder/SKILL.md) | MCP server development, tool definition, transport protocols | - |
| [monorepo-navigator](../engineering/monorepo-navigator/SKILL.md) | Monorepo tooling, workspace management, build caching | - |
| [performance-profiler](../engineering/performance-profiler/SKILL.md) | Performance analysis, flame graphs, memory profiling | - |
| [playwright-pro](../engineering/playwright-pro/SKILL.md) | E2E testing with Playwright, page objects, CI integration | - |
| [changelog-generator](../engineering/changelog-generator/SKILL.md) | Automated changelogs, conventional commits, release notes | - |
| [pr-review-expert](../engineering/pr-review-expert/SKILL.md) | PR review best practices, automated checks, checklists | - |
| [runbook-generator](../engineering/runbook-generator/SKILL.md) | Operational runbooks, incident procedures, automation | - |
| [saas-scaffolder](../engineering/saas-scaffolder/SKILL.md) | SaaS boilerplate, auth, billing, multi-tenancy | - |
| [skill-security-auditor](../engineering/skill-security-auditor/SKILL.md) | Security audit for AI skills, prompt injection detection | - |
| [context-engine](../engineering/context-engine/SKILL.md) | Context management for AI agents, memory systems | - |
| [self-improving-agent](../engineering/self-improving-agent/SKILL.md) | Self-improving AI patterns, feedback loops, metrics | - |
| [prompt-engineer-toolkit](../engineering/prompt-engineer-toolkit/SKILL.md) | Prompt engineering frameworks, evaluation, optimization | - |
| [stripe-integration-expert](../engineering/stripe-integration-expert/SKILL.md) | Stripe API, payment flows, subscriptions, webhooks | - |
## C-Level Advisory (26)
Strategic decision-making for executive leadership.
| Skill | Description | Tools |
|-------|-------------|-------|
| [ceo-advisor](../c-level-advisor/ceo-advisor/SKILL.md) | Strategic planning, board governance, investor relations, M&A | 2 |
| [cto-advisor](../c-level-advisor/cto-advisor/SKILL.md) | Technical strategy, architecture decisions, engineering leadership | 2 |
| [cfo-advisor](../c-level-advisor/cfo-advisor/SKILL.md) | Financial planning, fundraising, unit economics, treasury | - |
| [cmo-advisor](../c-level-advisor/cmo-advisor/SKILL.md) | Brand strategy, demand generation, marketing leadership | - |
| [coo-advisor](../c-level-advisor/coo-advisor/SKILL.md) | Operations strategy, process optimization, scaling | - |
| [chief-of-staff](../c-level-advisor/chief-of-staff/SKILL.md) | Executive operations, cross-functional alignment, strategic initiatives | - |
| [chro-advisor](../c-level-advisor/chro-advisor/SKILL.md) | People strategy, org design, compensation, workforce planning | - |
| [ciso-advisor](../c-level-advisor/ciso-advisor/SKILL.md) | Security strategy, risk quantification, compliance roadmap | - |
| [cpo-advisor](../c-level-advisor/cpo-advisor/SKILL.md) | Product strategy, portfolio management, product-market fit | - |
| [cro-advisor](../c-level-advisor/cro-advisor/SKILL.md) | Revenue strategy, sales/CS alignment, NRR optimization | - |
| [culture-architect](../c-level-advisor/culture-architect/SKILL.md) | Company culture design, values, engagement, remote culture | - |
| [decision-logger](../c-level-advisor/decision-logger/SKILL.md) | Decision documentation, ADRs, decision frameworks | - |
| [executive-mentor](../c-level-advisor/executive-mentor/SKILL.md) | Executive coaching, leadership development, board prep | - |
| [founder-coach](../c-level-advisor/founder-coach/SKILL.md) | Founder coaching, fundraising, pivots, co-founder dynamics | - |
| [org-health-diagnostic](../c-level-advisor/org-health-diagnostic/SKILL.md) | Organization assessment, health scoring, alignment analysis | - |
| [board-deck-builder](../c-level-advisor/board-deck-builder/SKILL.md) | Board presentation design, investor updates, narrative structure | - |
| [board-meeting](../c-level-advisor/board-meeting/SKILL.md) | Board meeting facilitation, agenda, minutes, governance | - |
| [change-management](../c-level-advisor/change-management/SKILL.md) | Organizational change, ADKAR, Kotter's 8 steps, transformation | - |
| [company-os](../c-level-advisor/company-os/SKILL.md) | Operating system for companies, cadences, OKRs, rituals | - |
| [competitive-intel](../c-level-advisor/competitive-intel/SKILL.md) | Competitive analysis, battlecards, market intelligence | - |
| [intl-expansion](../c-level-advisor/intl-expansion/SKILL.md) | International expansion, market entry, localization | - |
| [ma-playbook](../c-level-advisor/ma-playbook/SKILL.md) | M&A strategy, due diligence, integration playbook | - |
| [strategic-alignment](../c-level-advisor/strategic-alignment/SKILL.md) | Strategy alignment, OKR cascade, cross-functional sync | - |
| [internal-narrative](../c-level-advisor/internal-narrative/SKILL.md) | Internal communications, all-hands, company narratives | - |
| [scenario-war-room](../c-level-advisor/scenario-war-room/SKILL.md) | Scenario planning, war gaming, crisis simulation | - |
| [cs-onboard](../c-level-advisor/cs-onboard/SKILL.md) | C-suite onboarding, first 90 days, stakeholder mapping | - |
## Marketing (35)
Data-driven marketing with Python automation tools.
| Skill | Description | Tools |
|-------|-------------|-------|
| [content-creator](../marketing/content-creator/SKILL.md) | Brand voice analyzer, SEO optimizer, content frameworks | 2 |
| [marketing-demand-acquisition](../marketing/marketing-demand-acquisition/SKILL.md) | Demand gen, paid media, SEO, partnerships | 1 |
| [marketing-strategy-pmm](../marketing/marketing-strategy-pmm/SKILL.md) | Positioning, GTM, competitive intelligence | - |
| [app-store-optimization](../marketing/app-store-optimization/SKILL.md) | ASO for iOS & Android | - |
| [campaign-analytics](../marketing/campaign-analytics/SKILL.md) | Multi-touch attribution, funnel analysis, ROI | 3 |
| [social-media-analyzer](../marketing/social-media-analyzer/SKILL.md) | Social media performance tracking, engagement metrics | - |
| [brand-strategist](../marketing/brand-strategist/SKILL.md) | Brand positioning, identity systems, brand architecture | - |
| [growth-marketer](../marketing/growth-marketer/SKILL.md) | Experimentation, funnel optimization, viral loops, retention | - |
| [marketing-analyst](../marketing/marketing-analyst/SKILL.md) | Attribution modeling, ROI analysis, campaign optimization | - |
| [seo-specialist](../marketing/seo-specialist/SKILL.md) | Technical SEO, keyword research, link building, analytics | - |
| [ad-creative](../marketing/ad-creative/SKILL.md) | Ad creative design, A/B testing, platform-specific formats | - |
| [ai-seo](../marketing/ai-seo/SKILL.md) | AI-powered SEO, SGE optimization, semantic search | - |
| [brand-guidelines](../marketing/brand-guidelines/SKILL.md) | Brand identity systems, style guides, voice & tone | - |
| [cold-email](../marketing/cold-email/SKILL.md) | Cold outreach, personalization, sequences, deliverability | - |
| [content-humanizer](../marketing/content-humanizer/SKILL.md) | Natural writing patterns, AI detection avoidance, authenticity | - |
| [content-production](../marketing/content-production/SKILL.md) | Content ops, editorial calendar, workflow management | - |
| [content-strategy](../marketing/content-strategy/SKILL.md) | Content pillars, audience research, funnel mapping | - |
| [copywriting](../marketing/copywriting/SKILL.md) | Persuasive writing, PAS, AIDA, BAB frameworks | - |
| [copy-editing](../marketing/copy-editing/SKILL.md) | Style consistency, grammar, editorial standards | - |
| [landing-page-generator](../marketing/landing-page-generator/SKILL.md) | Landing page design, conversion optimization, CTA strategy | - |
| [marketing-context](../marketing/marketing-context/SKILL.md) | Market research, customer insights, positioning context | - |
| [marketing-ideas](../marketing/marketing-ideas/SKILL.md) | Campaign ideation, creative brainstorming, trend analysis | - |
| [marketing-ops](../marketing/marketing-ops/SKILL.md) | Marketing automation, MarTech stack, data management | - |
| [marketing-psychology](../marketing/marketing-psychology/SKILL.md) | Behavioral psychology, cognitive biases, persuasion | - |
| [paid-ads](../marketing/paid-ads/SKILL.md) | PPC campaigns, Google/Meta/LinkedIn Ads, budget optimization | - |
| [social-content](../marketing/social-content/SKILL.md) | Social media content creation, platform-specific formats | - |
| [programmatic-seo](../marketing/programmatic-seo/SKILL.md) | Programmatic page generation, template-based SEO at scale | - |
| [schema-markup](../marketing/schema-markup/SKILL.md) | Structured data, JSON-LD, rich snippets, Knowledge Graph | - |
| [seo-audit](../marketing/seo-audit/SKILL.md) | Technical SEO audits, Core Web Vitals, crawl analysis | - |
| [site-architecture](../marketing/site-architecture/SKILL.md) | Information architecture, URL structure, internal linking | - |
| [analytics-tracking](../marketing/analytics-tracking/SKILL.md) | GTM, event tracking, conversion tracking, GA4 | - |
| [email-sequence](../marketing/email-sequence/SKILL.md) | Email automation, drip campaigns, nurture flows | - |
| [email-template-builder](../marketing/email-template-builder/SKILL.md) | Email HTML templates, responsive design, deliverability | - |
| [social-media-manager](../marketing/social-media-manager/SKILL.md) | Social media management, scheduling, community management | - |
| [launch-strategy](../marketing/launch-strategy/SKILL.md) | Product launch playbooks, pre/post-launch analysis | - |
## Product Team (8)
User-centered product development with automation tools.
| Skill | Description | Tools |
|-------|-------------|-------|
| [product-manager-toolkit](../product-team/product-manager-toolkit/SKILL.md) | RICE prioritizer, interview analyzer, PRD templates | 2 |
| [agile-product-owner](../product-team/agile-product-owner/SKILL.md) | User stories, sprint planning, velocity tracking | 1 |
| [product-strategist](../product-team/product-strategist/SKILL.md) | OKR cascade, market analysis, vision setting | 1 |
| [ui-design-system](../product-team/ui-design-system/SKILL.md) | Design tokens, component documentation, responsive design | 1 |
| [ux-researcher-designer](../product-team/ux-researcher-designer/SKILL.md) | Personas, journey mapping, usability research | 1 |
| [product-designer](../product-team/product-designer/SKILL.md) | UI/UX design, prototyping, user research, design systems | - |
| [design-system-lead](../product-team/design-system-lead/SKILL.md) | Design tokens, component libraries, documentation | - |
| [ab-test-setup](../product-team/ab-test-setup/SKILL.md) | A/B testing design, statistical significance, feature flags | - |
## Project Management (23)
Delivery excellence with discovery, execution frameworks, and Atlassian integration.
### Role-Based Skills (10)
| Skill | Description | Tools |
|-------|-------------|-------|
| [senior-pm](../project-management/senior-pm/SKILL.md) | Portfolio management, stakeholder mapping, risk analysis, WSJF | 4 |
| [scrum-master](../project-management/scrum-master/SKILL.md) | Sprint analytics, velocity forecasting, capacity planning, team health | 4 |
| [delivery-manager](../project-management/delivery-manager/SKILL.md) | Release management, deployment, incident response | - |
| [jira-expert](../project-management/jira-expert/SKILL.md) | JQL mastery, workflows, automation, dashboards | - |
| [confluence-expert](../project-management/confluence-expert/SKILL.md) | Knowledge management, space architecture | - |
| [atlassian-admin](../project-management/atlassian-admin/SKILL.md) | System administration, security, integrations | - |
| [atlassian-templates](../project-management/atlassian-templates/SKILL.md) | Template design, custom blueprints | - |
| [agile-coach](../project-management/agile-coach/SKILL.md) | Transformation, framework implementation, coaching | - |
| [program-manager](../project-management/program-manager/SKILL.md) | Multi-project coordination, portfolio governance | - |
| [sprint-retrospective](../project-management/sprint-retrospective/SKILL.md) | Data-driven sprint retros, velocity analytics, code churn, trend tracking | 4 |
### Discovery Skills (4)
| Skill | Description | Tools |
|-------|-------------|-------|
| [brainstorm-ideas](../project-management/discovery/brainstorm-ideas/SKILL.md) | Product Trio ideation, Opportunity Solution Trees | - |
| [brainstorm-experiments](../project-management/discovery/brainstorm-experiments/SKILL.md) | Lean experiment design, XYZ hypotheses | 1 |
| [identify-assumptions](../project-management/discovery/identify-assumptions/SKILL.md) | Assumption mapping across 4-8 risk categories | 1 |
| [pre-mortem](../project-management/discovery/pre-mortem/SKILL.md) | Tiger/Paper Tiger/Elephant risk classification | 1 |
### Execution Skills (8)
| Skill | Description | Tools |
|-------|-------------|-------|
| [create-prd](../project-management/execution/create-prd/SKILL.md) | PRD scaffolding with 8-section structure | 1 |
| [brainstorm-okrs](../project-management/execution/brainstorm-okrs/SKILL.md) | OKR brainstorming and validation (Wodtke) | 1 |
| [outcome-roadmap](../project-management/execution/outcome-roadmap/SKILL.md) | Output-to-outcome roadmap transformation | 1 |
| [prioritization-frameworks](../project-management/execution/prioritization-frameworks/SKILL.md) | Multi-framework scoring (RICE, ICE, MoSCoW) | 1 |
| [release-notes](../project-management/execution/release-notes/SKILL.md) | Release notes from tickets/changelogs | 1 |
| [summarize-meeting](../project-management/execution/summarize-meeting/SKILL.md) | Structured meeting summaries with action items | - |
| [job-stories](../project-management/execution/job-stories/SKILL.md) | JTBD When/Want/So backlog format | - |
| [wwas](../project-management/execution/wwas/SKILL.md) | Why-What-Acceptance structured backlog items | - |
## Regulatory Affairs, Quality Management & Compliance (20)
Enterprise compliance across 18 frameworks.
### Medical Device & Quality (12)
| Skill | Description | Tools |
|-------|-------------|-------|
| [regulatory-affairs-head](../ra-qm-team/regulatory-affairs-head/SKILL.md) | Regulatory strategy, FDA/EU pathways, market access | 1 |
| [quality-manager-qmr](../ra-qm-team/quality-manager-qmr/SKILL.md) | QMS effectiveness, compliance dashboards | 1 |
| [quality-manager-qms-iso13485](../ra-qm-team/quality-manager-qms-iso13485/SKILL.md) | ISO 13485 compliance, design control | 1 |
| [capa-officer](../ra-qm-team/capa-officer/SKILL.md) | CAPA management, root cause analysis | 1 |
| [quality-documentation-manager](../ra-qm-team/quality-documentation-manager/SKILL.md) | Document control, 21 CFR Part 11 | 1 |
| [risk-management-specialist](../ra-qm-team/risk-management-specialist/SKILL.md) | Risk register, FMEA, ISO 14971 | 1 |
| [information-security-manager-iso27001](../ra-qm-team/information-security-manager-iso27001/SKILL.md) | ISO 27001:2022 ISMS, 93 Annex A controls | 2 |
| [gdpr-dsgvo-expert](../ra-qm-team/gdpr-dsgvo-expert/SKILL.md) | GDPR/DSGVO compliance, DPIA, German BDSG | 3 |
| [mdr-745-specialist](../ra-qm-team/mdr-745-specialist/SKILL.md) | EU MDR 2017/745, GSPR, EUDAMED, UDI | 1 |
| [fda-consultant-specialist](../ra-qm-team/fda-consultant-specialist/SKILL.md) | FDA 510(k)/PMA, QSR/QMSR, HIPAA, cybersecurity | 3 |
| [qms-audit-expert](../ra-qm-team/qms-audit-expert/SKILL.md) | ISO 13485 audit planning, nonconformity management | 1 |
| [isms-audit-expert](../ra-qm-team/isms-audit-expert/SKILL.md) | ISO 27001 ISMS audits, security control testing | 1 |
### Information Security & Cybersecurity (3)
| Skill | Description | Tools |
|-------|-------------|-------|
| [soc2-compliance-expert](../ra-qm-team/soc2-compliance-expert/SKILL.md) | SOC 2 Type I/II, Trust Services Criteria, evidence collection | 3 |
| [nist-csf-specialist](../ra-qm-team/nist-csf-specialist/SKILL.md) | NIST CSF 2.0, 6 functions, maturity assessment | 2 |
| [pci-dss-specialist](../ra-qm-team/pci-dss-specialist/SKILL.md) | PCI-DSS v4.0, 12 requirements, CDE scoping, tokenization | 2 |
### AI Governance (2)
| Skill | Description | Tools |
|-------|-------------|-------|
| [eu-ai-act-specialist](../ra-qm-team/eu-ai-act-specialist/SKILL.md) | EU AI Act risk classification, GPAI, conformity assessment | 3 |
| [iso42001-ai-management](../ra-qm-team/iso42001-ai-management/SKILL.md) | ISO 42001:2023 AIMS, AI lifecycle governance | 2 |
### Privacy, Financial & Cybersecurity Directives (3)
| Skill | Description | Tools |
|-------|-------------|-------|
| [ccpa-cpra-privacy-expert](../ra-qm-team/ccpa-cpra-privacy-expert/SKILL.md) | CCPA/CPRA consumer privacy, data mapping, opt-out mechanisms | 2 |
| [dora-compliance-expert](../ra-qm-team/dora-compliance-expert/SKILL.md) | DORA 5 pillars, ICT risk management, resilience testing | 2 |
| [nis2-directive-specialist](../ra-qm-team/nis2-directive-specialist/SKILL.md) | NIS2 10 minimum measures, incident reporting, supply chain security | 2 |
## Business Growth (16)
Revenue optimization, CRO, pricing strategy, and customer success.
| Skill | Description | Tools |
|-------|-------------|-------|
| [customer-success-manager](../business-growth/customer-success-manager/SKILL.md) | Health scoring, churn prediction, expansion analysis | 3 |
| [revenue-operations](../business-growth/revenue-operations/SKILL.md) | Pipeline analytics, forecast accuracy, GTM efficiency | 3 |
| [sales-engineer](../business-growth/sales-engineer/SKILL.md) | RFP analysis, competitive positioning, POC planning | 3 |
| [form-cro](../business-growth/form-cro/SKILL.md) | Form optimization, field reduction, multi-step forms | - |
| [onboarding-cro](../business-growth/onboarding-cro/SKILL.md) | User onboarding optimization, activation, time-to-value | - |
| [page-cro](../business-growth/page-cro/SKILL.md) | Landing page CRO, above-the-fold, social proof | - |
| [paywall-upgrade-cro](../business-growth/paywall-upgrade-cro/SKILL.md) | Paywall optimization, upgrade triggers, pricing pages | - |
| [popup-cro](../business-growth/popup-cro/SKILL.md) | Exit-intent popups, timing optimization, frequency capping | - |
| [signup-flow-cro](../business-growth/signup-flow-cro/SKILL.md) | Registration optimization, SSO, progressive profiling | - |
| [churn-prevention](../business-growth/churn-prevention/SKILL.md) | Churn prediction, retention strategies, win-back campaigns | - |
| [competitive-teardown](../business-growth/competitive-teardown/SKILL.md) | Competitor analysis, feature comparison, positioning gaps | - |
| [competitor-alternatives](../business-growth/competitor-alternatives/SKILL.md) | Alternative positioning, comparison pages, switching guides | - |
| [free-tool-strategy](../business-growth/free-tool-strategy/SKILL.md) | Free tool marketing, product-led growth, conversion funnels | - |
| [pricing-strategy](../business-growth/pricing-strategy/SKILL.md) | Pricing models, value-based pricing, packaging | - |
| [referral-program](../business-growth/referral-program/SKILL.md) | Referral mechanics, viral loops, incentive design | - |
| [contract-and-proposal-writer](../business-growth/contract-and-proposal-writer/SKILL.md) | Contract templates, proposals, SOW, MSA | - |
## Finance (1)
Financial analysis and valuation.
| Skill | Description | Tools |
|-------|-------------|-------|
| [financial-analyst](../finance/financial-analyst/SKILL.md) | DCF valuation, ratio analysis, budget variance, forecasting | 4 |
## Data & Analytics (5)
Data-driven insights and ML operations.
| Skill | Description | Tools |
|-------|-------------|-------|
| [data-analyst](../data-analytics/data-analyst/SKILL.md) | SQL, visualization, statistical analysis, reporting | - |
| [data-scientist](../data-analytics/data-scientist/SKILL.md) | ML modeling, experimentation, statistical inference | - |
| [business-intelligence](../data-analytics/business-intelligence/SKILL.md) | Dashboard design, KPI development, data storytelling | - |
| [analytics-engineer](../data-analytics/analytics-engineer/SKILL.md) | dbt, data modeling, transformation, semantic layer | 4 |
| [ml-ops-engineer](../data-analytics/ml-ops-engineer/SKILL.md) | Model deployment, monitoring, feature stores, pipelines | - |
## Sales & Success (5)
Revenue generation and customer success.
| Skill | Description | Tools |
|-------|-------------|-------|
| [account-executive](../sales-success/account-executive/SKILL.md) | MEDDIC, pipeline management, negotiation, closing | - |
| [customer-success-manager](../sales-success/customer-success-manager/SKILL.md) | Onboarding, retention, health scoring, expansion | - |
| [sales-engineer](../sales-success/sales-engineer/SKILL.md) | Technical demos, POC design, RFP responses | - |
| [solutions-architect](../sales-success/solutions-architect/SKILL.md) | Solution design, integration architecture, technical sales | - |
| [sales-operations](../sales-success/sales-operations/SKILL.md) | CRM, territory planning, compensation, forecasting | - |
## HR & People (4)
People operations and workforce analytics.
| Skill | Description | Tools |
|-------|-------------|-------|
| [hr-business-partner](../hr-operations/hr-business-partner/SKILL.md) | Talent strategy, performance management, org design | - |
| [talent-acquisition](../hr-operations/talent-acquisition/SKILL.md) | Recruiting, sourcing, employer branding, hiring analytics | - |
| [operations-manager](../hr-operations/operations-manager/SKILL.md) | Process optimization, resource management, efficiency | - |
| [people-analytics](../hr-operations/people-analytics/SKILL.md) | Workforce analytics, predictive modeling, survey analysis | - |
docs/USAGE.md
+305
View File
@@ -0,0 +1,305 @@
# Usage Guide
Detailed examples for using Claude Skills across all supported platforms.
---
## Using Skills Directly
Skills give your AI assistant deep domain knowledge. Once a skill is available, the assistant automatically activates the right skill based on your request.
### Python CLI Tools
Every skill with a `scripts/` directory includes standalone Python CLI tools. Run them directly from the command line.
**Code Quality Analysis:**
```bash
python engineering/senior-fullstack/scripts/code_quality_analyzer.py /path/to/project
```
```
Code Quality Report
====================
Overall Score: 85/100
Security: 90/100 (2 medium issues)
Performance: 80/100 (3 optimization opportunities)
Test Coverage: 75% (target: 80%)
Documentation: 88/100
Recommendations:
1. Update lodash to 4.17.21 (CVE-2020-8203)
2. Optimize database queries in UserService
3. Add integration tests for payment flow
```
**Feature Prioritization (RICE):**
```bash
python product-team/product-manager-toolkit/scripts/rice_prioritizer.py features.csv --json
```
```json
{
"prioritized_features": [
{"name": "SSO Integration", "reach": 8, "impact": 9, "confidence": 7, "effort": 5, "rice_score": 100.8},
{"name": "Dark Mode", "reach": 9, "impact": 4, "confidence": 9, "effort": 3, "rice_score": 108.0},
{"name": "Export to PDF", "reach": 6, "impact": 5, "confidence": 8, "effort": 2, "rice_score": 120.0}
]
}
```
**CLAUDE.md Optimization:**
```bash
python engineering/claude-code-mastery/scripts/claudemd_optimizer.py CLAUDE.md
```
```
CLAUDE.md Optimization Report
==============================
File: CLAUDE.md
Lines: 142
Est. Tokens: ~1,850
Budget Used: 9.3% of 20,000 token budget
Section Completeness:
[ok] Project Overview
[ok] Architecture
[ok] Development Commands
[!!] Missing: Code Style (recommended)
[!!] Missing: Testing Strategy (recommended)
Redundancy Issues:
- Line 34: Generic instruction "Be careful with..." (remove or make specific)
- Lines 67-69: Duplicate of lines 12-14
Score: 72/100
```
**CI/CD Workflow Generation:**
```bash
python engineering/devops-workflow-engineer/scripts/workflow_generator.py --type ci --language python
```
```yaml
# Generated: CI Pipeline for Python
name: CI
on:
pull_request:
branches: [main, dev]
jobs:
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with: { python-version: '3.12' }
- run: pip install ruff && ruff check .
test:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ['3.10', '3.11', '3.12']
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with: { python-version: '${{ matrix.python-version }}' }
- run: pip install -e ".[test]" && pytest --cov
```
**Financial DCF Valuation:**
```bash
python finance/financial-analyst/scripts/dcf_valuation.py valuation_data.json
```
```
DCF Valuation Summary
======================
Revenue (Year 1): $2,400,000
Growth Rate: 25%
Discount Rate (WACC): 12%
Terminal Growth: 3%
Enterprise Value: $18,750,000
Net Debt: ($1,200,000)
Equity Value: $17,550,000
Sensitivity Analysis:
WACC \ Growth | 20% | 25% | 30%
------------- | ------- | ------- | -------
10% | $21.2M | $24.1M | $27.3M
12% | $16.8M | $18.8M | $21.0M
14% | $13.5M | $14.9M | $16.5M
```
**Mobile App Scaffolding:**
```bash
python engineering/senior-mobile/scripts/mobile_scaffold.py my-app --platform react-native --state zustand
```
```
Scaffolded: my-app (React Native + Expo Router)
================================================
Platform: React Native (Expo)
Navigation: Expo Router (file-based)
State: Zustand
TypeScript: Enabled
Created:
my-app/
├── app/ # Expo Router pages
│ ├── (tabs)/ # Tab navigation
│ ├── (auth)/ # Auth screens
│ └── _layout.tsx # Root layout
├── src/
│ ├── components/ # Reusable components
│ ├── hooks/ # Custom hooks
│ ├── services/ # API layer
│ ├── stores/ # Zustand stores
│ └── utils/ # Helpers
├── app.json
├── tsconfig.json
└── package.json
Next: cd my-app && npx expo start
```
---
## Using Agents
Agents are specialized AI personas that combine multiple skills with role-specific behavior. They live in the `agents/` directory and are invoked as Claude Code subagents.
**Code Review:**
```
> /agents/code-reviewer Review the last commit for security and quality issues
```
```markdown
## Code Review Summary
**Overall Score:** 7/10
**Risk Level:** Medium
### Critical Issues (Must Fix)
- [ ] **SQL Injection** at `src/db/queries.ts:45`
- Use parameterized queries: `db.query('SELECT * FROM users WHERE id = $1', [userId])`
- [ ] **Missing auth check** at `src/routes/admin.ts:12`
- Add `requireRole('admin')` middleware before handler
### Important (Should Fix)
- [ ] N+1 query in `src/services/orders.ts:78`
- Use `JOIN` or batch fetch with `WHERE id IN (...)`
### Scores
| Category | Score | Notes |
|-----------------|-------|--------------------------------|
| Correctness | 8/10 | Logic is sound |
| Security | 5/10 | SQL injection + missing auth |
| Performance | 7/10 | One N+1 query |
| Maintainability | 8/10 | Clean code, good naming |
```
**Security Audit:**
```
> /agents/security-auditor Audit all API endpoints for OWASP Top 10 vulnerabilities
```
```markdown
## Security Audit Report
**Risk Level:** High
**Findings:** 1 critical, 2 high, 3 medium
### Critical Findings
| # | Finding | File:Line | OWASP | Severity |
|---|----------------------|----------------------|-------|----------|
| 1 | Command injection | src/utils/exec.ts:23 | A03 | Critical |
### Recommendations
1. **Immediate:** Fix command injection, add JWT expiry
2. **Short-term:** Sanitize all error responses, add rate limiting
3. **Long-term:** Implement security headers (CSP, HSTS), add SAST to CI
```
**QA Analysis:**
```
> /agents/qa-engineer Analyze test coverage for the payment service
```
```markdown
## QA Report
**Quality Score:** 6/10
**Test Coverage:** ~45% (estimated)
### Coverage Map
| Module | Functions | Tested | Coverage | Priority |
|-----------------------|-----------|--------|----------|----------|
| src/services/payment | 12 | 5 | 42% | Critical |
| src/services/refund | 6 | 1 | 17% | Critical |
| src/validators/card | 4 | 4 | 100% | Done |
### Bugs Found
1. **[High]** Race condition in `processPayment` — double charge possible
```
**Documentation Generation:**
```
> /agents/doc-generator Generate API documentation for src/routes/
```
**Changelog Generation:**
```
> /agents/changelog-manager Generate changelog for the upcoming release
```
**Git Workflow:**
```
> /agents/git-workflow Prepare a release for v2.1.0
```
---
## Multi-Platform Usage
Claude Skills works with every major AI coding assistant. Each platform reads from its own config file.
| Platform | Config File | How to Use |
|----------|------------|------------|
| **Claude Code** | `CLAUDE.md` | Skills auto-activate. Use `/agents/name` for subagents |
| **OpenAI Codex** | `AGENTS.md` | Skills available via `.codex/` symlinks |
| **Cursor** | `.cursorrules` | Skills referenced in rules file |
| **GitHub Copilot** | `.github/copilot-instructions.md` | Skills available in workspace |
| **Windsurf** | `.windsurfrules` | Skills referenced in rules file |
| **Cline** | `.clinerules` | Skills referenced in rules file |
| **Goose** | `.goosehints` | Skills referenced in hints file |
| **Aider** | `AGENTS.md` | Skills available via AGENTS.md |
| **Jules** | `AGENTS.md` | Skills available via AGENTS.md |
| **RooCode** | `AGENTS.md` | Skills available via AGENTS.md |
### Direct Paste Method
For any platform, you can paste the content of any `SKILL.md` directly into a conversation:
```
[Paste the content of any SKILL.md into your AI assistant]
Now help me with: [your specific task]
```
### Manual Copy Method
```bash
# Copy a skill to Claude Code
cp -r engineering/senior-fullstack ~/.claude/skills/senior-fullstack
# Copy a skill to Cursor
cp -r marketing/content-creator .cursor/skills/content-creator
```
---
## CI/CD Workflow Usage
Copy sample workflows from `templates/workflows/` to your project:
```bash
# Copy all workflows
mkdir -p .github/workflows
cp templates/workflows/*.yml .github/workflows/
# Or copy individual workflows
cp templates/workflows/ci-quality-gate.yml .github/workflows/
```
Once installed, workflows trigger automatically based on events (PRs, pushes, labels). See [WORKFLOWS.md](WORKFLOWS.md) for the full list and setup guide.
docs/WORKFLOWS.md
+163
View File
@@ -0,0 +1,163 @@
# CI/CD Workflows
12 ready-to-use GitHub Actions workflow templates in [`templates/workflows/`](../templates/workflows/). Copy to your project's `.github/workflows/` directory to activate.
---
## Quick Setup
```bash
# Copy all workflows
mkdir -p .github/workflows
cp templates/workflows/*.yml .github/workflows/
# Or copy individual workflows
cp templates/workflows/ci-quality-gate.yml .github/workflows/
```
---
## Workflow Reference
| Workflow | Triggers On | What It Does |
|----------|------------|--------------|
| `ci-quality-gate.yml` | PR | YAML lint, Python syntax check, security audit |
| `qa-validation.yml` | PR with `*.py` changes | Flake8 lint, Bandit security scan, CLI standards check |
| `skill-validation.yml` | PR touching skills | Package structure validation, tier classification |
| `documentation-check.yml` | PR with `*.md` changes | YAML frontmatter validation, link checking, skill inventory |
| `changelog-enforcer.yml` | PR to main/dev | Ensures CHANGELOG.md is updated when code changes |
| `release-drafter.yml` | Push to main | Auto-generates release notes with full repo stats |
| `skill-auto-update.yml` | Daily + manual | Detects changed skills, generates update manifest |
| `claude-code-review.yml` | PR | AI-powered code review via Claude |
| `claude.yml` | @claude mentions | Interactive Claude Code in issues/PRs |
| `pr-issue-auto-close.yml` | PR merged | Auto-close linked issues on merge |
| `smart-sync.yml` | Issue label/state changes | Bidirectional issue/project board sync |
| `sync-codex-skills.yml` | SKILL.md changes | Codex compatibility sync |
---
## Workflow Details
### ci-quality-gate.yml
Runs on every pull request. Validates Python syntax, runs linting, and performs a security audit.
```
Example output:
[ok] Python Syntax Check -- 180/180 scripts compiled successfully
[ok] Flake8 Lint -- 0 errors (E9, F63, F7, F82)
[ok] Bandit Security Scan -- 0 high-severity issues
[ok] CLI Standards -- 180/180 scripts have argparse + --help
```
**Required secrets:** None
### qa-validation.yml
Triggers on PRs that include changes to `*.py` files. Runs Flake8 for linting, Bandit for security scanning, and checks CLI standards (argparse, --help).
**Required secrets:** None
### skill-validation.yml
Triggers on PRs that touch skill packages. Validates package structure and classifies skills into quality tiers.
```
Example output:
[ok] senior-fullstack -- SKILL.md (342 lines), 3 scripts, 2 refs, 1 asset -> Tier 1
[ok] claude-code-mastery -- SKILL.md (488 lines), 3 scripts, 3 refs, 2 assets -> Tier 1
[!!] senior-cloud-architect -- SKILL.md (89 lines), 0 scripts -> Tier 3 (needs upgrade)
```
**Required secrets:** None
### documentation-check.yml
Triggers on PRs with markdown changes. Validates YAML frontmatter in SKILL.md files, checks internal links, and counts skills.
**Required secrets:** None
### changelog-enforcer.yml
Triggers on PRs targeting main or dev. Warns when CHANGELOG.md is not updated alongside code changes. Suggests a changelog entry based on the changed files.
**Required secrets:** None
### release-drafter.yml
Triggers on push to main. Auto-generates release notes with repository stats, latest skills, and installation instructions.
**Required secrets:** `GITHUB_TOKEN` (automatically available)
### skill-auto-update.yml
Runs daily and on manual trigger. Detects changed skills since last run and generates an update manifest for downstream consumers.
**Required secrets:** None
### claude-code-review.yml
Triggers on pull requests. Runs an AI-powered code review using Claude Code, posting inline comments on the PR.
**Required secrets:** `ANTHROPIC_API_KEY`
### claude.yml
Triggers when @claude is mentioned in issues or PR comments. Enables interactive Claude Code conversations directly in GitHub.
**Required secrets:** `ANTHROPIC_API_KEY`
### pr-issue-auto-close.yml
Triggers when a PR is merged. Automatically closes any issues linked in the PR body (e.g., "Closes #123").
**Required secrets:** `GITHUB_TOKEN` (automatically available)
### smart-sync.yml
Triggers on issue label or state changes. Provides bidirectional sync between issues and project boards.
**Required secrets:** `GITHUB_TOKEN` (automatically available), project board configured
### sync-codex-skills.yml
Triggers when SKILL.md files change. Syncs skills to the `.codex/` directory for OpenAI Codex compatibility.
**Required secrets:** None
---
## Customization
### Modifying Triggers
Each workflow file has an `on:` section you can customize:
```yaml
on:
pull_request:
branches: [main, dev] # Change target branches
paths: ['engineering/**'] # Limit to specific paths
push:
branches: [main]
```
### Adding Required Secrets
For workflows that need API keys, add them in your repository settings:
1. Go to **Settings > Secrets and variables > Actions**
2. Click **New repository secret**
3. Add the required secret (e.g., `ANTHROPIC_API_KEY`)
### Disabling a Workflow
Either delete the workflow file from `.github/workflows/` or add a condition:
```yaml
jobs:
build:
if: false # Temporarily disabled
```
See [`templates/workflows/README.md`](../templates/workflows/README.md) and [`templates/workflows/SETUP_GUIDE.md`](../templates/workflows/SETUP_GUIDE.md) for additional setup instructions.