skill-authoring

Create, test, and validate agent skills conforming to the agentskills.io spec.

1|Updated Apr 28, 2026

Search Tags:#workflow #validation #frontmatter #agentskills #skill-authoring

Ready to run

npx skills add https://github.com/naramore/dotai --skill skill-authoring-naramore

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/naramore/dotai/tree/main/claude/skills/skill-authoring
Command: npx skills add https://github.com/naramore/dotai --skill skill-authoring-naramore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams create and validate agent skills that conform to the agentskills.io specification, ensuring consistent frontmatter and structure.

Core Features & Use Cases

Guides on frontmatter: name, description, license, compatibility, and metadata
Explains required directory structure: SKILL.md, scripts/, references/, assets/ (when present)
Demonstrates testing and validation workflows, including progressive disclosure and iteration
Useful when creating a new skill, updating an existing one, or auditing an existing skill for compliance

Quick Start

Create SKILL.md with frontmatter and actionable instructions using the starter template.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema

What frontmatter is required to create an agentskills.io skill?▼

Required frontmatter for agentskills.io skills includes name, description, license, compatibility, and metadata fields. These fields ensure the skill conforms to the specification and is discoverable.

How do I validate an agent skill for specification compliance?▼

You validate an agent skill by checking its frontmatter, directory structure, and testing workflows against the agentskills.io spec. This process ensures consistent structure and compliance before deployment.

What directory structure is needed for an agentskills.io skill?▼

The required directory structure includes a SKILL.md file, plus optional scripts/, references/, and assets/ directories when present. This structure organizes the skill's actionable instructions and supporting files.

Can I use this skill to audit an existing agent skill for compliance?▼

Yes, you can audit existing skills for compliance. The skill guides you through checking frontmatter requirements, validating directory structure, and running testing workflows to ensure specification conformity.

How do I test and iterate on a new agent skill?▼

You test and iterate on agent skills using progressive disclosure and validation workflows. This involves drafting actionable instructions in SKILL.md, validating frontmatter, and refining the structure.

What is progressive disclosure in agent skill authoring?▼

Progressive disclosure in skill authoring is a testing workflow that iteratively reveals skill details and instructions. It helps structure actionable content in SKILL.md while validating conformity to the agentskills.io specification.