Skill Define

Validate and register skill manifests against the official schema.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires registry.update, and includes scripts (resource) components.

What problem does it solve?

Ensuring that new skills adhere to a consistent structure, define their inputs/outputs correctly, and declare dependencies is crucial for a healthy skill ecosystem. This Skill acts as the quality gate, validating skill manifests before they are registered.

Core Features & Use Cases

  • Schema Validation: Automatically checks skill.yaml files against the official schema for correctness, preventing malformed skill definitions.
  • Required Field Enforcement: Ensures all mandatory fields like name, version, description, inputs, outputs, dependencies, and status are present.
  • Registry Integration: Delegates to registry.update to add the validated skill to the central registry, making it discoverable and usable.
  • Use Case: A developer creates a new skill. Before it can be used or discovered, they run skill.define on its manifest. If any fields are missing or incorrectly formatted, the skill provides detailed errors, guiding the developer to fix the issues.

Quick Start

Validate and register a new skill manifest

python skills/skill.define/skill_define.py skills/my.new.skill/skill.yaml

Frequently Asked Questions about Skill Define

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

FAQPage Schema
How do I validate skill manifests before registering them?

Skill manifests (.skill.yaml) are validated against the official schema to check structure, required fields, inputs, outputs, and dependencies. Run the validation to catch formatting errors and missing mandatory fields like name, version, description, inputs, outputs, dependencies, and status before registration.

What happens if my skill.yaml file has missing or incorrect fields?

The validator detects missing required fields and format violations, then provides detailed error messages guiding you to fix issues. This prevents malformed skill definitions from entering the registry and breaking downstream workflows.

Can I use skill validation in CI/CD workflows?

Yes, skill manifest validation integrates into Betty Framework development and deployment workflows, including local contexts, CI pipelines, and automated workflow environments for continuous quality gates.

How does skill validation connect to the registry?

After validation passes, the skill automatically delegates to registry.update to register the validated manifest in the central registry, making the skill discoverable and usable across your ecosystem.

What file format does the skill validator accept?

The validator processes YAML-formatted skill manifest files (.skill.yaml) using safe YAML parsing to prevent injection vulnerabilities while extracting skill metadata and dependency declarations.