skills.rest
naramore
naramoreCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/naramore/dotai --skill skill-authoring-naramore
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
dbowm91dbowm91

skills

Load and activate markdown-defined agent skills from project directories.

Community
Intermediate
raw-labsraw-labs
2

skill-creator

Create, validate, and package Claude Skills with Python scripts.

Official
Intermediate
scottopellscottopell
1

allium

Capture domain behaviour as Allium Skill units with YAML frontmatter and markdown guidance.

Community
Advanced
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate