creating-agent-skills

Create, improve, evaluate, and package Agent Skills per the agentskills.io specification.

121|10|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/sortie-ai/sortie --skill creating-agent-skills-sortie-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-agent-skills
Source: https://github.com/sortie-ai/sortie/tree/main/.github/skills/creating-agent-skills
Command: npx skills add https://github.com/sortie-ai/sortie --skill creating-agent-skills-sortie-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

It enables teams to create, improve, compare, evaluate, and package Agent Skills that conform to the agentskills.io specification, ensuring consistent structure, discoverability, and portable deployment.

Core Features & Use Cases

  • Guides SKILL.md authoring, frontmatter optimization, and description writing to improve activation accuracy.
  • Provides progressive disclosure patterns and cross-platform compatibility guidance for multiple runtimes and tools.
  • Enables clean packaging of skills with optional scripts, references, and assets, plus validation tooling.

Quick Start

Create a new Skill directory, populate SKILL.md with frontmatter and body, add optional scripts/references/assets as needed, and validate with the provided tooling.

Frequently Asked Questions about creating-agent-skills

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

FAQPage Schema
How do I create an Agent Skill that follows the agentskills.io specification?

To create an Agent Skill, populate a SKILL.md file with proper frontmatter and body content, add optional scripts, references, and assets, then validate the package using validation tooling for reliable deployment.

What is progressive disclosure in Agent Skills and when should I use it?

Progressive disclosure in Agent Skills is a structural pattern that controls information visibility for activation accuracy. Use it to optimize SKILL.md descriptions and ensure cross-platform compatibility across multiple runtimes.

How do I validate frontmatter and structure for an Agent Skill directory?

Validate Agent Skill frontmatter and directory structure by running the provided validation tooling, which checks SKILL.md formatting, optional components like scripts and references, and ensures specification compliance before deployment.

Can I package Agent Skills with custom scripts and reference files for cross-platform compatibility?

Yes, you can package Agent Skills with optional scripts, references, and assets. The creation process provides cross-platform compatibility guidance to ensure portable deployment across multiple runtimes and tools.

What's the best way to compare and evaluate different Agent Skills?

The best way to compare and evaluate Agent Skills is to assess their SKILL.md frontmatter optimization, description accuracy, and structural conformity to the agentskills.io specification using integrated validation tooling.

Why does my Agent Skill fail validation during packaging?

Agent Skill validation fails when SKILL.md frontmatter is malformed, required structural elements are missing, or directory contents do not conform to the agentskills.io specification for portable deployment.