Aigent builder

Skill wkusnierczyk/aigent-skills/skills/aigent-builder

AI agent skill builder and validator

Install

npx -y skills add wkusnierczyk/aigent-skills --skill aigent-builder

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Generates AI agent skill definitions from natural language descriptions. This skill creates complete SKILL.md files with valid YAML frontmatter and structured Markdown body following Anthropic best practices. Use when the user asks to "create a skill", "build a skill", "generate a skill", or describes a new skill they want to create.

SKILL.md

3.6 KB, as published. Nobody here has run it

AIgent Builder

Generates complete AI agent skill definitions from natural language purpose descriptions. Produces a valid SKILL.md file with YAML frontmatter and structured Markdown body following the Anthropic agent skill best practices.

When to Use

Use this skill when:

The user asks to create, build, or generate a new agent skill
The user describes functionality they want to package as a skill
The user wants to scaffold a new SKILL.md file

Instructions

Step 1: Detect aigent availability

Run the following to check if the aigent CLI is installed:

command -v aigent

Step 2a: With aigent (primary mode)

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

Build the skill:
```
aigent build "<purpose>" --dir .claude/skills
```
Additional options:
- --name <name> — override the derived skill name
- --license <license> — set a license (e.g., MIT)
- --compatibility <platform> — set compatibility (e.g., claude)
- --allowed-tools <tools> — set allowed tools (e.g., Bash, Read, Write)
- --no-llm — force deterministic mode (no API key required)
If ANTHROPIC_API_KEY is set, aigent build uses Claude to generate richer names, descriptions, and body content. Without an API key, it falls back to deterministic generation automatically.
Validate the output:
```
aigent validate .claude/skills/<skill-name>
```
Exit code 0 means valid. Any errors are printed to stderr.
Report the output directory path and any warnings to the user.

Step 2b: Without aigent (fallback mode)

If aigent is not available, generate the skill manually using the Anthropic spec:

Derive a skill name from the user's purpose:
- Convert to kebab-case (lowercase, hyphens between words)
- Use gerund form for the verb (e.g., "process" becomes "processing")
- Maximum 64 characters
- Must not contain reserved words: anthropic, claude
- No leading, trailing, or consecutive hyphens

Write the SKILL.md with this structure:

---
name: <derived-name>
description: <third-person description>. Use when <trigger conditions>.
---
# <Title Case Name>

<Overview paragraph describing what the skill does.>

## When to Use

Use this skill when:
- <Trigger condition 1>
- <Trigger condition 2>

## Instructions

1. <Step 1>
2. <Step 2>
3. <Step 3>

Rules for the description:

Write in third person ("This skill processes..." not "Process...")
Include a "Use when..." clause for auto-invocation triggers
Maximum 1024 characters
No XML-like tags (<tag>)

Write to .claude/skills/<name>/SKILL.md using the Write tool (or a user-specified directory).
Inform the user that validation was not run because aigent is not installed. Recommend installing it for authoritative validation.

Output location

The default output directory is .claude/skills/<name>/ (project-local skills). The user may specify an alternative directory. Both CLI mode and fallback mode use the same default.