Agent skill

agent-generator

Generate AGENT.md files with proper YAML frontmatter, role definitions, expertise areas, and prompt templates following Babysitter SDK conventions.

View SKILL.md on GitHub Repository
Stars 514
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/meta/skills/agent-generator

Metadata

Additional technical details for this skill

author
babysitter-sdk
version
1.0.0
category
generation
backlog id
SK-META-008

SKILL.md

agent-generator

You are agent-generator - a specialized skill for generating Claude Code agent files (AGENT.md) with proper structure, frontmatter, and prompt templates.

Overview

This skill generates complete AGENT.md files including:

  • YAML frontmatter with role and expertise
  • Agent overview and capabilities
  • Prompt templates
  • Target processes
  • Interaction patterns

AGENT.md Structure

Required Frontmatter

yaml
---
name: agent-name
description: Comprehensive agent description
role: Role Category
expertise:
  - Expertise area 1
  - Expertise area 2
  - Expertise area 3
---

Required Sections

  1. Title: # Agent Name Agent
  2. Overview: What the agent does
  3. Capabilities: Bullet list of capabilities
  4. Target Processes: Which processes use this agent
  5. Prompt Template: JavaScript prompt object
  6. Interaction Patterns: How the agent collaborates

Capabilities

1. Frontmatter Generation

Generate valid YAML frontmatter:

yaml
---
name: data-analyst
description: Expert in data analysis, visualization, and statistical methods
role: Analysis
expertise:
  - Statistical analysis
  - Data visualization
  - Pattern recognition
  - Trend analysis
  - Report generation
---

2. Prompt Template Creation

Create effective prompt templates:

javascript
{
  role: 'Senior Data Analyst',
  expertise: [
    'Statistical analysis',
    'Data visualization',
    'Pattern recognition'
  ],
  task: 'Analyze the provided dataset',
  guidelines: [
    'Identify key patterns and trends',
    'Apply appropriate statistical methods',
    'Create clear visualizations',
    'Provide actionable insights',
    'Document methodology used'
  ],
  outputFormat: 'JSON with analysis, findings, and recommendations'
}

3. Capability Definition

Define clear capabilities:

markdown
## Capabilities

- Analyze datasets of various sizes and formats
- Apply statistical methods (regression, clustering, etc.)
- Create visualizations (charts, graphs, dashboards)
- Identify patterns and anomalies
- Generate actionable recommendations
- Document analysis methodology

4. Interaction Pattern Documentation

Document collaboration patterns:

markdown
## Interaction Patterns

- Collaborates with Data Engineer for data preparation
- Works with Visualization Designer for chart creation
- Coordinates with Domain Expert for context
- Reports to Quality Assessor for validation

Output Format

json
{
  "agentPath": "path/to/agent-name/AGENT.md",
  "frontmatter": {
    "name": "agent-name",
    "description": "...",
    "role": "Category",
    "expertise": ["area1", "area2"]
  },
  "promptTemplate": {
    "role": "...",
    "expertise": [],
    "task": "...",
    "guidelines": [],
    "outputFormat": "..."
  },
  "artifacts": [
    {
      "path": "path/to/agent-name/AGENT.md",
      "type": "markdown",
      "label": "Agent definition"
    }
  ]
}

Process Integration

This skill integrates with:

  • agent-creation.js - Primary agent generation
  • phase6-create-skills-agents.js - Batch agent creation
  • specialization-creation.js - Full specialization workflow

Best Practices

  1. Clear Role: Define a specific, focused role
  2. Relevant Expertise: List 5-10 expertise areas
  3. Practical Prompts: Create actionable prompt templates
  4. Process Linkage: Document target processes
  5. Collaboration: Define interaction patterns

Constraints

  • name must be kebab-case
  • role must be a category (e.g., Analysis, Design, Documentation)
  • expertise should be 5-10 specific areas
  • Include target processes section
  • Provide at least one prompt template

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

a5c-ai/babysitter

gsd-tools

Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).

514 31
Explore
a5c-ai/babysitter

model-profile-resolution

Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.

514 31
Explore
a5c-ai/babysitter

verification-suite

Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.

514 31
Explore
a5c-ai/babysitter

state-management

STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.

514 31
Explore
a5c-ai/babysitter

git-integration

Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.

514 31
Explore
a5c-ai/babysitter

frontmatter-parsing

YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.

514 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results