builder

name: "builder" description: "A skill for building and maintaining Agent Skills" author: "Andrew Howden" version: "0.1.0"

Builder Skill

This skill provides instructions for creating, building, and maintaining Agent Skills using the skr tool.

Concepts

An Agent Skill is a directory containing standardized knowledge and capabilities for an AI agent. It is packaged as an OCI artifact (like a Docker image) and distributed via container registries.

Directory Structure

A valid skill directory must contain a SKILL.md file at its root.

my-skill/
├── SKILL.md          (Required) Entry point and instructions.
├── references/       (Optional) Supporting documentation.
├── scripts/          (Optional) Executable tools.
└── assets/           (Optional) Static files.

SKILL.md Format

The SKILL.md file is the core of the skill. It MUST strictly follow this format:

1. Frontmatter: YAML block defining metadata.
2. Body: Markdown content defining the skill's capabilities.

---
name: "my-skill"
description: "A brief description of the skill."
---

# My Skill

Detailed instructions on how to use this skill...

Frontmatter Rules:

• name: [Required] 1-64 characters, lowercase alphanumeric and hyphens. Should match the directory name.
• description: [Required] 1-1024 characters.

Capabilities

Create a New Skill

To create a new skill, create a directory and a SKILL.md file.

1. Create directory: mkdir path/to/skill-name
2. Create SKILL.md with appropriate frontmatter.

Build a Skill

To package a skill into an artifact:

skr build path/to/skill-name --tag my-skill:v1

Best Practices

• Inlined SOPs: Include Standard Operating Procedures (SOPs) directly in SKILL.md for zero-latency execution.
• Atomic Skills: Keep skills focused on a single domain or capability.
• References: Use the references/ directory for deep-dive technical documentation to keep SKILL.md concise.