skills.rest
Takfes
TakfesCOMMUNITY
Explore all skills by this author →
GitHub

agent-development

Create Claude Code agent files with YAML frontmatter and structured system prompts.

Updated May 6, 2026
Search Tags:#validation#agents#plugins#claude-code#frontmatter#triggering#system-prompt
One-click install
npx skills add https://github.com/Takfes/indie-scaffolder --skill agent-development-takfes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-development
Source: https://github.com/Takfes/indie-scaffolder/tree/main/components/agent-skills-commands/.agents/skills/agent-development
Command: npx skills add https://github.com/Takfes/indie-scaffolder --skill agent-development-takfes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you design clear, reliable Claude Code agents without guessing at the file format, trigger logic, or system-prompt structure. It turns vague agent ideas into production-ready agent definitions that are easier to trigger, validate, and maintain.

Core Features & Use Cases

  • Agent File Design: Defines the required frontmatter fields, naming rules, model choice, color selection, and optional tool restrictions for a Claude Code agent.
  • Triggering Guidance: Explains how to write strong description text with concrete examples so the right agent is activated at the right time.
  • System Prompt Crafting: Provides patterns for writing structured second-person instructions with responsibilities, process steps, quality standards, and output formats.
  • Validation and Testing: Includes guidance for validating agent files and testing whether descriptions and prompts behave as intended.
  • Use Case: A builder wants to add a code-review agent to a plugin and needs help creating the agent file, trigger examples, and behavior instructions in the right format.

Quick Start

Use the agent-development skill to create a complete Claude Code agent definition for your task, including frontmatter, triggering examples, and a structured system prompt.

Frequently Asked Questions about agent-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Claude Code agent file with the correct frontmatter and triggers?▼

To create a Claude Code agent file, define valid YAML frontmatter with naming rules, model choice, color selection, and tool restrictions. Add strong description text with concrete examples so the right agent is activated at the right time.

What is the best way to write a system prompt for a custom plugin agent?▼

The best way to write a system prompt for a plugin agent is using structured second-person instructions. Include responsibilities, process steps, quality standards, and output formats to ensure reliable behavior for review, generation, or analysis tasks.

How do I validate a Claude Code agent file structure and test its triggering behavior?▼

Validate a Claude Code agent file by checking its YAML frontmatter structure, naming rules, and instruction body. Test triggering behavior by verifying description text and example blocks activate the intended agent during plugin workflows.

Does my Claude Code agent need tool restrictions defined in the frontmatter?▼

Tool restrictions are optional in Claude Code agent frontmatter. You should define them when an agent needs limited capabilities for specific tasks, ensuring the agent only accesses tools necessary for its designated review, generation, or analysis functions.

Why does my Claude Code agent fail to trigger correctly in plugin workflows?▼

An agent fails to trigger correctly when its description text lacks concrete examples or clear use-case scenarios. Improve activation by writing strong descriptions with explicit examples that match the intended tasks and plugin workflow contexts.

Can I use a Claude Code agent for code review tasks within a plugin?▼

Yes, you can use a Claude Code agent for code review tasks within a plugin. Define the agent file with appropriate frontmatter, trigger examples, and structured second-person behavior instructions formatted for review, generation, documentation, or analysis.

Related Skills

Explore More Software Engineering Skills→
stencilastencila
900

agent-creation

Create Stencila agents with AGENT.md files and YAML frontmatter.

Official
Intermediate
dmedina-devdmedina-dev
1

Agent Development

Create and validate Claude Code plugin agent configurations with YAML frontmatter.

Community
Advanced
victorjoshi9victorjoshi9
1

agent-development

Create Claude Code agent files with YAML frontmatter and validation scripts.

Community
Advanced
terrazul-aiterrazul-ai

create-agent

Create Claude agent definitions with YAML frontmatter, system prompts, and templates.

Official
Advanced