skill-creation

Create and structure Gaia skills with type-based frontmatter and line budgets.

3|1|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/metraton/gaia --skill skill-creation-metraton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creation
Source: https://github.com/metraton/gaia/tree/main/skills/skill-creation
Command: npx skills add https://github.com/metraton/gaia --skill skill-creation-metraton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a practical framework for creating, refining, and structuring Gaia skills so that agents have a clear, reusable policy layer.

Core Features & Use Cases

  • Type-based design: choose a skill type (Discipline, Technique, Reference, Domain, Protocol) and apply a consistent structure.
  • Stepwise authoring: define how to write frontmatter, body content, and references to artifacts (examples, rules, and guidelines) so skills stay discoverable and maintainable.
  • Judgment-focused guidance: emphasize reasoning, guardrails, and examples rather than rigid, brittle commands to improve agent reasoning and reliability.
  • Use-case alignment: documents how the skill will be loaded and used by agents across governance, safety, and workflow scenarios.

Quick Start

Choose a skill type, apply the type structure, and document the rules and examples in SKILL.md.

Frequently Asked Questions about skill-creation

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

FAQPage Schema
How do I create and structure Gaia skills with a clear process?

To write Gaia skills, define frontmatter rules, body content, and references to artifacts so skills stay discoverable. This stepwise authoring approach ensures agents receive a clear, reusable policy layer for governance, safety, and workflow scenarios.

What is the best way to structure agent guidelines and frontmatter for skill-writing?

The best way to structure agent guidelines is using a type-based design system. You choose a skill type like Discipline or Protocol, apply consistent structure, and document rules and examples in SKILL.md to maintain concise, discovery-friendly definitions that improve agent reasoning.

How does a line-budget approach maintain concise instructional-design for agent skills?

A line-budget approach maintains concise instructional-design by limiting skill length, ensuring definitions stay discovery-friendly and maintainable. This framework prevents rigid, brittle commands and emphasizes reasoning, guardrails, and examples to improve agent reliability.

When do I need a type-based design for refining existing Gaia skills?

You need a type-based design when refining existing Gaia skills to ensure they maintain a consistent structure. Choosing a skill type like Domain or Reference lets you apply frontmatter rules and organize content so skills remain maintainable and discoverable by agents.

Why emphasize judgment-focused guidance and examples over rigid commands in skill-writing?

Emphasizing judgment-focused guidance over rigid commands prevents brittle agent behavior. Documenting reasoning, guardrails, and examples in SKILL.md improves agent reasoning and reliability across governance, safety, and workflow scenarios.