agent.define

Validate agent.yaml manifests and register them in the Betty Framework registry.

2|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/epieczko/betty --skill agent-define
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent.define
Source: https://github.com/epieczko/betty/tree/main/skills/agent.define
Command: npx skills add https://github.com/epieczko/betty --skill agent-define

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML.

What problem does it solve?

Validate agent manifests (agent.yaml) for schema compliance, verify skill references, and update the central Agent Registry, ensuring agents are well-formed and trackable.

Core Features & Use Cases

  • Validate agent manifest structure and required fields
  • Verify agent name and version formats
  • Validate reasoning mode enum values
  • Check referenced skills exist in the skill registry
  • Register valid agents in /registry/agents.json and update entries

Quick Start

python skills/agent.define/agent_define.py agents/api.designer/agent.yaml

Frequently Asked Questions about agent.define

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

FAQPage Schema
How do I validate agent YAML manifests for the Betty Framework?

Agent manifest validation checks agent.yaml files for schema compliance, required fields, correct name and version formats, valid reasoning_mode values, non-empty capabilities and skills lists, and ensures all referenced skills exist in the skill registry before registration.

What happens when I register an agent with agent.define?

Registration updates the central /registry/agents.json with validated agent entries. The Skill performs cross-reference checks against the skill registry, applies atomic updates, and returns standardized success or error responses.

Can I use agent.define to check if my skills are properly registered?

Yes. During agent validation, agent.define verifies that all skills referenced in your agent manifest exist in the skill registry, catching missing or misconfigured skill dependencies before registration.

What format does my agent manifest need to follow?

Agent manifests use YAML format (agent.yaml) with required fields including agent name, version, reasoning_mode, non-empty capabilities list, and skills list. The Skill validates structure and enum values against the schema.

How do I run agent manifest validation from the command line?

Use the CLI interface: python skills/agent.define/agent_define.py [path/to/agent.yaml]. The Skill processes the manifest, validates all fields and skill references, and outputs success or detailed error messages.

What errors should I expect if my agent manifest is invalid?

Validation fails if required fields are missing, name or version formats are incorrect, reasoning_mode is invalid, capabilities or skills lists are empty, or referenced skills don't exist in the skill registry.