agent-development

Generate YAML frontmatter and system prompts for Claude Code plugin agents.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/angrybeagles/weather-dashboard --skill agent-development-angrybeagles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-development
Source: https://github.com/angrybeagles/weather-dashboard/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/agent-development
Command: npx skills add https://github.com/angrybeagles/weather-dashboard --skill agent-development-angrybeagles

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill helps developers design robust, autonomous agents for Claude Code plugins, covering frontmatter structure, triggering examples, system prompts, and best practices for agent governance.

Core Features & Use Cases

  • Define precise agent identifiers (name) and descriptions that trigger correctly
  • Generate YAML frontmatter, including model, color, and optional tools
  • Craft comprehensive system prompts with responsibilities, processes, and quality standards
  • Create diverse triggering examples (explicit, proactive, and edge cases) and proper commentary
  • Validate agent configuration against project guidelines (CLAUDE.md) and safety considerations

Quick Start

Start by outlining the agent's goal, providing triggering examples, and specifying the desired system prompt, then convert this specification into a Markdown agent file.

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 system prompt for a Claude Code plugin agent?

To create a system prompt for a Claude Code plugin agent, define the agent's responsibilities, processes, and quality standards. This ensures the autonomous agent operates effectively within the plugin environment and adheres to project guidelines.

What is the correct frontmatter structure for an autonomous Claude Code agent?

The correct frontmatter structure for an autonomous Claude Code agent requires name, description, model, and color fields. Optional components like scripts, references, and assets can be added to extend the agent's functionality within the plugin.

How do I write triggering examples for a Claude Code plugin?

Writing triggering examples for a Claude Code plugin involves documenting explicit, proactive, and edge-case scenarios. Providing diverse examples with proper commentary ensures the agent activates correctly based on user intent.

Can I validate my Claude Code agent configuration against project guidelines?

Yes, you can validate your Claude Code agent configuration against project guidelines. The design process checks agent configurations for alignment with CLAUDE.md and runs a toxicity check to prevent unsafe configurations.

What components can I include when designing an agent for Claude Code?

When designing an agent for Claude Code, you can include scripts and references as optional components. These components are defined in the YAML frontmatter to provide additional context and executable actions for the autonomous agent.

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

A Claude Code plugin agent may fail to trigger if its description lacks precision or triggering examples are missing. Defining precise identifiers and providing diverse explicit and proactive triggering examples ensures correct activation.