aigent-builder - SKILL.md Agent Skill

name: aigent-builder description: >- Generates AI agent skill definitions (SKILL.md files) from natural language descriptions. Creates complete skill directories with valid frontmatter and markdown body following the Anthropic agent skill specification. Use when creating new skills, generating SKILL.md files, or scaffolding skill directories. allowed-tools: Bash(aigent ), Bash(command -v ), Write, Read, Glob argument-hint: "[skill-description]" context: fork

Skill Builder

Setup

Check if aigent is available:

command -v aigent

With aigent CLI

If aigent is on $PATH, use the CLI for authoritative skill generation:

Build the skill:

aigent new "<purpose>" --dir .claude/skills/<name>/

Validate the result:
```
aigent validate .claude/skills/<name>/
```
If validation reports errors, fix the SKILL.md and re-validate.

Use --no-llm to force deterministic mode (no API keys needed). Use --name <name> to override the derived skill name.

The CLI defaults to outputting in ./<name>/ in the current directory. The --dir flag above overrides this to place skills in .claude/skills/, which is the standard Claude Code skill location.

Without aigent CLI

If aigent is not available, generate the SKILL.md directly.

Name rules

Lowercase letters, numbers, and hyphens only
Maximum 64 characters
Prefer gerund form: "processing-pdfs", "analyzing-data"
No reserved words: "anthropic", "claude"
No XML tags
Must match directory name

Description rules

Non-empty, maximum 1024 characters
Third person: "Processes PDFs..." not "I process PDFs..."
Include what the skill does AND when to use it
No XML tags

Body guidelines

Keep under 500 lines
Be concise — only add context Claude doesn't already have
Use ## headings for sections
Link to additional files for large content

Output

Write the SKILL.md to .claude/skills/<name>/SKILL.md with:

---
name: <kebab-case-name>
description: <what-it-does-and-when-to-use-it>
---

# <Title>

## Quick start

[Concise instructions]

## Usage

[Detailed usage]