Create Your First Agent

Build a Claude Code agent, skill, or command and prepare it for deployment

What Are Claude Code Agents?

Claude Code agents are markdown files (.md) that define autonomous AI workflows. They live in your repository and can be deployed to run on schedules or webhooks.

There are three types:

Type	Location	Purpose
Agent	.claude/agents/	Autonomous workflows that can use tools, create PRs, send notifications
Skill	.claude/skills/	Reusable capabilities that can be invoked by agents or users
Command	.claude/commands/	Quick actions triggered by slash commands

Create an Agent

Run /agents in Claude Code to create a new agent, or create the file manually at .claude/agents/{agent-name}.md:

---
name: Weekly Report Generator
description: Generates a weekly summary of GitHub activity and posts to Slack
tools:
  - mcp_GitHub_list_pull_requests
  - mcp_Slack_chat_postMessage
---

You are a weekly report generator. Every time you run:

1. Fetch all merged PRs from the past 7 days using the GitHub tool
2. Summarize the changes by category (features, fixes, docs)
3. Post the summary to the #engineering Slack channel

Format the report with clear sections and bullet points.
Keep the tone professional but concise.

The frontmatter (between ---) defines metadata. The body is the prompt that tells the agent what to do.

Create a Skill

Skills are directories with a SKILL.md file and optional supporting files. Create .claude/skills/enrich-lead/SKILL.md:

---
name: Enrich Lead
description: Enriches a company lead with LinkedIn and web data
tools:
  - mcp_LinkedIn_get_company_profile
  - mcp_Perplexity_search
---

Given a company name and domain, enrich the lead with:
1. Company size, industry, and funding from LinkedIn
2. Recent news and product launches from web search
3. Key decision makers and their titles

Return structured JSON with all findings.

You can add supporting files alongside SKILL.md (scripts, reference data, etc.):

.claude/skills/enrich-lead/
  SKILL.md          # Skill definition
  criteria.md       # Enrichment criteria
  scripts/
    validate.py     # Helper script

Create a Command

Commands are quick actions. Create .claude/commands/check-pr.md:

---
name: Check PR
description: Reviews the latest open PR and posts feedback
---

Find the most recent open pull request, review the code changes,
and post constructive feedback as a PR comment.

Guided Build (Optional)

For a more structured approach, run the guided workflow in Claude Code:

/datagen:build-agent

This walks you through defining your agent’s purpose, connecting tools, and writing the agent file.

Next Step

Deploy Your Agent

Push your agent to DataGen cloud and set up webhooks or schedules