claude-skills/templates/agent-template.md

name	description	skills	domain	model	tools
cs-agent-name	What this agent does, followed by trigger phrasing. MUST include a "Use when…" (or "Spawn when…" / "Invoke via…") clause plus at least 1 concrete trigger example. Up to 1024 characters allowed — completeness of triggers beats brevity. Example — "Senior backend engineer agent. Use when designing APIs, picking a database, or extracting a service from a monolith (e.g., 'help me choose between Postgres and DynamoDB')."	skill-folder-name	domain-name	sonnet	Read Write Bash Grep Glob

Agent Name

Purpose

[Paragraph 1: Describe what this agent does and which skill package it orchestrates]

[Paragraph 2: Describe target users, their roles, and why they need this agent]

[Paragraph 3: Explain the gap this agent bridges and the outcomes it enables]

Skill Integration

Skill Location: ../../domain-skill/skill-name/

Python Tools

1. Tool Name

   • Purpose: What this tool does (one sentence)
   • Path: ../../domain-skill/skill-name/scripts/tool_name.py
   • Usage: python ../../domain-skill/skill-name/scripts/tool_name.py [arguments]
   • Features: Key capabilities (bullet list)
   • Use Cases: When to use this tool

2. Second Tool (if applicable)

   • Purpose: What this tool does
   • Path: ../../domain-skill/skill-name/scripts/second_tool.py
   • Usage: python ../../domain-skill/skill-name/scripts/second_tool.py [arguments]
   • Features: Key capabilities
   • Use Cases: When to use this tool

Knowledge Bases

1. Reference Name

   • Location: ../../domain-skill/skill-name/references/reference_file.md
   • Content: What knowledge this file contains
   • Use Case: When to consult this reference

2. Second Reference (if applicable)

   • Location: ../../domain-skill/skill-name/references/second_reference.md
   • Content: What knowledge this file contains
   • Use Case: When to consult this reference

Templates

1. Template Name (if applicable)
   • Location: ../../domain-skill/skill-name/assets/template.md
   • Use Case: When users would copy and customize this template

Workflows

Workflow 1: [Primary Use Case Name]

Goal: One-sentence description of what this workflow accomplishes

Steps:

1. [Action Step] - Description of first step

   # Command example if applicable
   python ../../domain-skill/skill-name/scripts/tool.py input.txt
   

2. [Action Step] - Description of second step
3. [Action Step] - Description of third step
4. [Action Step] - Description of fourth step
5. [Action Step] - Description of final step

Expected Output: What success looks like (deliverable, metric, decision made)

Time Estimate: How long this workflow typically takes

Example:

# Complete workflow example with real commands
command1
command2
# Review output

Workflow 2: [Advanced Use Case Name]

Goal: One-sentence description

Steps:

1. [Action Step] - Description
2. [Action Step] - Description
3. [Action Step] - Description
4. [Action Step] - Description

Expected Output: What success looks like

Time Estimate: Duration estimate

Workflow 3: [Integration Use Case Name]

Goal: One-sentence description

Steps:

1. [Action Step] - Description
2. [Action Step] - Description
3. [Action Step] - Description

Expected Output: What success looks like

Time Estimate: Duration estimate

Workflow 4: [Optional Fourth Workflow]

Goal: One-sentence description

Steps:

1. [Action Step] - Description
2. [Action Step] - Description

Expected Output: What success looks like

Time Estimate: Duration estimate

Integration Examples

Example 1: [Example Name]

#!/bin/bash
# script-name.sh - Brief description

# Setup variables
INPUT_FILE=$1

# Execute workflow
python ../../domain-skill/skill-name/scripts/tool.py "$INPUT_FILE"

# Process output
echo "Analysis complete. Review results above."

Example 2: [Example Name]

# Multi-step workflow example

# Step 1: Prepare data
echo "Step 1: Data preparation"

# Step 2: Run analysis
python ../../domain-skill/skill-name/scripts/tool.py input.csv

# Step 3: Generate report
echo "Report generation complete"

Example 3: [Example Name]

# Automation example (e.g., weekly report, daily check)

DATE=$(date +%Y-%m-%d)
echo "📊 Report for $DATE"

# Execute tools
python ../../domain-skill/skill-name/scripts/tool.py current-data.csv > report-$DATE.txt

Success Metrics

[Metric Category 1]:

• [Metric Name]: Target value or improvement percentage
• [Metric Name]: Target value or improvement percentage
• [Metric Name]: Target value or improvement percentage

[Metric Category 2]:

• [Metric Name]: Target value or improvement percentage
• [Metric Name]: Target value or improvement percentage

[Metric Category 3]:

• [Metric Name]: Target value or improvement percentage
• [Metric Name]: Target value or improvement percentage

[Metric Category 4] (optional):

• [Metric Name]: Target value or improvement percentage

Related Agents

• cs-related-agent - How this agent relates (e.g., "Provides strategic context for tactical execution")
• cs-another-agent - How this agent relates (same directory)
• cs-future-agent - Planned agent (mark as "planned")

References

• Skill Documentation: ../../domain-skill/skill-name/SKILL.md
• Domain Guide: ../..//CLAUDE.md
• Agent Development Guide: ../CLAUDE.md

---

Last Updated: [Date] Sprint: [sprint-MM-DD-YYYY] (Day X) Status: Production Ready Version: 1.0