skills.rest
AgentWorkforce
AgentWorkforceOFFICIAL
Explore all skills by this author →
Website𝕏@agent_relayGitHub

creating-agent-skills-skill

Create SKILL.md agent skill packages following the agentskills.io specification.

812|65|Updated Dec 17, 2025
Search Tags:#specification#skill.md#Validation#Agent Skills#FrontMatter#Codex CLI#gitHub copilot
One-click install
npx skills add https://github.com/AgentWorkforce/relay --skill creating-agent-skills-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: creating-agent-skills-skill
Source: https://github.com/AgentWorkforce/relay/tree/main/.agents/skills/creating-agent-skills-skill
Command: npx skills add https://github.com/AgentWorkforce/relay --skill creating-agent-skills-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing portable AI agent skills requires knowing the exact SKILL.md frontmatter rules, directory layout, and validation constraints, which differ subtly across tools and are easy to get wrong.

Core Features & Use Cases

  • Specification Reference: Provides the agentskills.io frontmatter spec including required fields, optional fields, and name validation rules.
  • Cross-Tool Layouts: Documents installation directories for Codex CLI, GitHub Copilot, and Amp, plus migration commands between them.
  • Validation Checklist: Includes a quick checklist and the skills-ref validate command to verify skill packages before publishing.
  • Use Case: When scaffolding a new reusable capability for an AI coding agent, follow this guide to produce a compliant SKILL.md with correct naming, description, and supporting directories.

Quick Start

Create a new agent skill package for code review following the agentskills.io specification with valid frontmatter and directory structure.

Frequently Asked Questions about creating-agent-skills-skill

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

FAQPage Schema
How do I create a SKILL.md file for an AI agent?▼

Create a directory matching your skill name and add a SKILL.md file with YAML frontmatter containing name and description fields, followed by Markdown instructions. The name must be 1-64 lowercase alphanumeric characters with hyphens.

What frontmatter fields are required in an agent skill?▼

Only name and description are required. Optional fields include license, compatibility, allowed-tools, and metadata for categorization and versioning.

Does the SKILL.md format work with GitHub Copilot and Codex CLI?▼

Yes, the SKILL.md format is identical across Codex CLI, GitHub Copilot, and Amp. Only the installation directory differs: .agents/skills for Codex and Amp, .github/skills for Copilot.

How do I validate an agent skill package?▼

Run the skills-ref validate command against your skill directory, for example skills-ref validate ./my-skill. It checks frontmatter constraints, naming rules, and directory structure.

What are common SKILL.md naming mistakes?▼

Invalid names include uppercase letters, leading hyphens, and consecutive hyphens. The directory name must exactly match the frontmatter name field, using only lowercase alphanumeric characters and single hyphens.

Related Skills

Explore More Software Engineering Skills→
vstorm-covstorm-co
1.0k

skill-creator

Convert conversational task descriptions into reusable SKILL.md scaffolds with YAML frontmatter.

Official
Intermediate
AzureAzure
15

azure-functions-e2e-tests

Automate end-to-end testing of Azure Functions Skills across GitHub Copilot, Claude Code, and Codex.

Official
Advanced
haryelramalhoharyelramalho

writing-skills

Creates, edits, and verifies SKILL.md agent documentation with pressure testing and loophole hardening.

Community
Advanced
evatt-harvey-salingerevatt-harvey-salinger

portable-agents

Standardizes YAML frontmatter and Markdown system prompts for portable agents across Claude Code, Cursor, OpenCode, and Cline.

Community
Advanced