agents-standards

Enforce standardized agent definitions with required YAML frontmatter and self-containment rules.

39|3|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/LiorCohen/sdd --skill agents-standards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-standards
Source: https://github.com/LiorCohen/sdd/tree/main/.claude/skills/agents-standards
Command: npx skills add https://github.com/LiorCohen/sdd --skill agents-standards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standards for authoring SDD plugin agents to ensure consistent role definitions, clear boundaries, and safe, predictable behavior.

Core Features & Use Cases

  • Enforces frontmatter requirements (name, description) and a dedicated role statement.
  • Enforces self-containment rules (no cross-agent file references, explicit working directory, explicit delegation).
  • Covers CLI delegation, no-user-interaction constraints, and explicit Skill References, Staleness, and Agent Structure guidelines.

Quick Start

Write or audit a plugin agent to include the required frontmatter and self-contained architecture, then adjust the agent to conform to the no-user-interaction rule.

Frequently Asked Questions about agents-standards

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

FAQPage Schema
What are the required YAML frontmatter fields for plugin agent definitions?

Plugin agent definitions require mandatory YAML frontmatter fields including name and description. These fields ensure consistent role definitions, clear boundaries, and safe, predictable behavior across all plugin agents.

How do I audit a plugin agent for self-containment and no-user-interaction rules?

Audit a plugin agent for self-containment by verifying no cross-agent file references, explicit working directory declarations, and explicit delegation. The agent must also conform strictly to no-user-interaction constraints during execution.

What is the 'You are...' role statement convention in SDD plugin agents?

The 'You are...' role statement is a mandatory convention in SDD plugin agents that defines the specific role. It works with the 'Skills' reference convention and 'Rules' section placement to ensure standardized, safe agent definitions.

Does my plugin agent need explicit guidance on working directory and delegation?

Yes, plugin agents require explicit guidance on working directory and delegation. These requirements are placed in the Rules section to enforce self-contained architecture and ensure safe, predictable behavior without user interaction.

Why do plugin agents need standardized role definitions and boundaries?

Plugin agents need standardized role definitions and boundaries to ensure safe, self-contained behavior and predictable execution. Enforcing consistent agent definitions across the plugin prevents unsafe actions and maintains clear operational scope.