agent-development

Design and validate autonomous Claude Code agents with structured prompts and metadata.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill agent-development-nsalvacao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-development
Source: https://github.com/nsalvacao/nsalvacao-claude-code-plugins/tree/main/plugins/plugin-dev/skills/agent-development
Command: npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill agent-development-nsalvacao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables developers to design, document, validate, and govern autonomous Claude Code agents, ensuring consistency across plugins and teams.

Core Features & Use Cases

  • Frontmatter validation: enforce required fields (name, description, model, color) and proper formats.
  • System prompt design: provide a clear, structured prompt template aligned with CLAUDE.md.
  • Triggering patterns: include <example> blocks to illustrate explicit, proactive, and edge-case triggers.
  • Metadata generation: produce structured metadata (dependencies, components, categories, keywords).

Quick Start

Define a new agent-development skill.md from your requirements and validate it with the included agent validator.

Frequently Asked Questions about agent-development

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

FAQPage Schema
How do I validate Claude Code agent frontmatter structure?

Frontmatter validation enforces required fields such as name, description, model, and color to ensure proper formats and consistency across Claude Code plugins. This process aligns agent metadata with CLAUDE.md patterns for scalable ecosystems.

What is the best way to design system prompts for autonomous Claude Code agents?

Designing system prompts for autonomous Claude Code agents requires a structured template aligned with CLAUDE.md. This approach incorporates best-practice prompting, tooling definitions, and governance patterns to ensure reliable execution.

How do I configure triggering patterns for Claude Code plugins?

Configuring triggering patterns for Claude Code plugins involves defining explicit, proactive, and edge-case triggers. This is achieved by adding example blocks that illustrate exactly when and how the agent should activate.

Does this approach support generating metadata for scalable agent ecosystems?

Yes, generating metadata for scalable agent ecosystems is supported by producing structured definitions. It extracts dependencies, components, categories, and keywords to maintain consistency across large plugin environments.

Why does my autonomous agent need toxicity checks and component discovery?

Autonomous agents need toxicity checks and component discovery to enforce safety governance and validate operational boundaries. These validation patterns prevent harmful outputs and ensure correct interaction with available system components.