New advertisers: 50% off your first month with code FIRSTMONTHSee slots
agentworkforce avatar

Creating Agent Skills Skill

Reference for building portable Agent Skills packages with SKILL.md frontmatter, directory layout, and validation rules.

GitHub stars
1.1K
last updated
Jun 11, 2026
View on GitHub

What it does

  • Covers the agentskills.io spec: required and optional frontmatter fields, name and description constraints, and progressive disclosure tiers
  • Includes installation paths for Codex CLI, GitHub Copilot, and Amp, plus a quick checklist and a skills-ref validate step
  • Enforces a name of 1 to 64 lowercase alphanumeric characters and hyphens, matching the parent directory, with SKILL.md kept under 500 lines
  • Designed for authors who need one SKILL.md format that moves between Codex, Copilot, and Amp without changes

Install

$ npx -y skills add agentworkforce/relay --skill creating-agent-skills-skill -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

Overview

Agent Skills is an open standard for portable AI agent capabilities. One SKILL.md file works across Codex CLI, GitHub Copilot, and Amp.

Official Spec: https://agentskills.io/specification

Installation Directories

ToolLocation
Codex CLI.agents/skills/{skill-name}/SKILL.md
GitHub Copilot.github/skills/{skill-name}/SKILL.md
Amp.agents/skills/{skill-name}/SKILL.md

Directory Structure

```
my-skill/                 # Must match frontmatter `name`
├── SKILL.md              # Required - main definition
├── scripts/              # Optional - executable code
├── references/           # Optional - additional docs
└── assets/               # Optional - static resources

Frontmatter Specification

Required Fields
---
name: skill-name
description: What it does and when to use it
---
Optional Fields

Details

Repository
github.com/agentworkforce/relay
Categories
Git & Pull Requests, AI & Agent Building, CLI & Terminal
License
Apache-2.0
First seen
Jun 11, 2026

More from agentworkforce/relay

All 17

Similar to Creating Agent Skills Skill

More Git & Pull Requests