Agents

March 21, 2026 ยท View on GitHub

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.

AgentWhat It DoesInvoke With
code-reviewerScores code across 5 categories (1-10), flags bugs, security holes, performance issues/agents/code-reviewer
security-auditorOWASP Top 10 audit, secrets scanning, infrastructure security checks/agents/security-auditor
qa-engineerTest coverage analysis, bug hunting, test generation, quality metrics/agents/qa-engineer
doc-generatorGenerates README, API docs, architecture docs, changelog entries from code/agents/doc-generator
changelog-managerBuilds Keep a Changelog entries from git history, determines semver/agents/changelog-manager
git-workflowConventional 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)

AgentRoleFile
cs-tech-leadTechnical leadership, architecture reviews, team mentoringagents/engineering/cs-tech-lead.md
cs-engineering-directorEngineering management, hiring, process optimizationagents/engineering/cs-engineering-director.md
cs-architecture-reviewerArchitecture review, system design validationagents/engineering/cs-architecture-reviewer.md
cs-code-auditorDeep code audit, quality analysis, refactoring recommendationsagents/engineering/cs-code-auditor.md
cs-doc-writerTechnical documentation, API docs, architecture guidesagents/engineering/cs-doc-writer.md
cs-security-engineerSecurity engineering, threat modeling, vulnerability assessmentagents/engineering/cs-security-engineer.md

C-Level (3)

AgentRoleFile
cs-ceo-advisorStrategic planning, board governance, investor relationsagents/c-level/cs-ceo-advisor.md
cs-cto-advisorTechnical strategy, architecture decisions, engineering leadershipagents/c-level/cs-cto-advisor.md
cs-cfo-advisorFinancial planning, fundraising, unit economicsagents/c-level/cs-cfo-advisor.md

Compliance (2)

AgentRoleFile
cs-compliance-auditorMulti-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-advisorSecurity strategy, risk quantification, compliance roadmapagents/compliance/cs-ciso-advisor.md

Marketing (3)

AgentRoleFile
cs-content-creatorContent strategy, brand voice, SEO optimizationagents/marketing/cs-content-creator.md
cs-demand-gen-specialistDemand generation, paid media, lead nurturingagents/marketing/cs-demand-gen-specialist.md
cs-seo-analystTechnical SEO, keyword research, analyticsagents/marketing/cs-seo-analyst.md

Product (1)

AgentRoleFile
cs-product-managerProduct strategy, roadmap planning, user researchagents/product/cs-product-manager.md

Cross-Functional (4)

AgentRoleFile
cs-cmo-advisorMarketing leadership, brand strategy, demand generationagents/cs-cmo-advisor.md
cs-design-leadDesign leadership, design systems, UX strategyagents/cs-design-lead.md
cs-growth-leadGrowth strategy, experimentation, product-led growthagents/cs-growth-lead.md
cs-privacy-officerData privacy, GDPR/CCPA compliance, privacy engineeringagents/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