Agent Specification

Write agent specifications with role, inputs, outputs, and templates.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/MarkusDegen/multi-agent-skill --skill agent-specification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Agent Specification
Source: https://github.com/MarkusDegen/multi-agent-skill/tree/main/skills/agent-specification
Command: npx skills add https://github.com/MarkusDegen/multi-agent-skill --skill agent-specification

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill guides teams to craft precise agent specifications and discovery frameworks, reducing MAS failures by standardizing role definitions, inputs/outputs, and governance.

Core Features & Use Cases

  • Provides discovery questions and formal spec templates for agent roles, inputs, and outputs.
  • Includes best-practice patterns from the 12 Factor Agents framework and comprehensive reference materials.

Quick Start

Create a formal agent specification for a Planner that details its role, inputs, outputs, and success criteria, and outputs a JSON plan template.

Frequently Asked Questions about Agent Specification

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

FAQPage Schema
How do I write an agent specification to prevent multi-agent system failures?

Defining an agent role requires specifying its explicit responsibilities, inputs, outputs, and forbidden actions. This skill provides discovery questions and formal spec templates to standardize role definitions and reduce multi-agent system (MAS) failures.

What are the best discovery questions to ask when defining an agent role?

The best discovery questions target the agent's explicit role, expected inputs, required outputs, and forbidden actions. Using structured templates aligned with the 12 Factor Agents framework ensures comprehensive coverage and reduces multi-agent system (MAS) failures.

How does the 12 Factor Agents framework guide agent system design?

The 12 Factor Agents framework guides system design by providing best-practice patterns for formalizing agent specifications. It enforces explicit definitions for roles, inputs, outputs, and versioning to standardize governance and prevent multi-agent system failures.

Can I generate a formal template with inputs and outputs for a Planner agent?

Yes, you can generate a formal template for a Planner agent that details its role, inputs, outputs, and success criteria. The skill outputs structured JSON plan templates aligned with the 12 Factor Agents guidelines for comprehensive system design.

What should I include in an agent specification template to handle human-in-the-loop workflows?

An agent specification template for human-in-the-loop workflows must include explicit role definitions, input/output boundaries, forbidden actions, and versioning. These components ensure standardized governance and clear interaction protocols within the multi-agent system.