authoring-skills

Create and validate SKILL.md frontmatter and folder structure for Agent Skills.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/jeninh/ampskills-dotfile --skill authoring-skills-jeninh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-skills
Source: https://github.com/jeninh/ampskills-dotfile/tree/main/.agents/skills/authoring-skills
Command: npx skills add https://github.com/jeninh/ampskills-dotfile --skill authoring-skills-jeninh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams create and maintain consistent, well-structured Agent Skills by providing a standardized template, clear requirements, and a reusable reference model. It reduces onboarding time and promotes best practices when authoring or reviewing skills.

Core Features & Use Cases

  • Frontmatter scaffolding: Ensures name and description are defined and validated, with optional metadata preserved.
  • Folder structure guidance: Recommends the standard skill layout (SKILL.md, scripts/, references/, assets/) and progressive disclosure approach.
  • Quality assurance references: Provides checklists and reference files to verify naming, content, and consistency during creation or review.
  • Use Case: A developer creates a new skill and uses this guide to ensure naming, structure, and documentation follow the project-wide conventions.

Quick Start

Create a new skill directory named authoring-skills, add a SKILL.md frontmatter with name and description, and begin the body with concise, policy-aligned guidance for future skill authors.

Frequently Asked Questions about authoring-skills

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

FAQPage Schema
How do I structure agent skills to follow standard best practices?

To structure agent skills with best practices, use a standardized folder layout containing SKILL.md, scripts/, references/, and assets/ directories. This progressive disclosure approach ensures consistent skill creation and review.

What is frontmatter scaffolding for agent skills?

Frontmatter scaffolding for agent skills involves defining and validating the name and description metadata within the SKILL.md file. This ensures proper documentation standards are met while preserving any optional metadata.

How do I validate SKILL.md frontmatter and folder layout?

You validate SKILL.md frontmatter and folder layout by checking naming conventions, content consistency, and structure against the Agent Skills spec. Quality assurance reference files provide checklists to verify these elements during review.

Do I need external software to author and validate agent skills?

You do not need external software to author and validate agent skills. The process requires no installation beyond standard filesystem access to create directories and validate the SKILL.md structure.

What's the best way to organize reference materials when creating agent skills?

The best way to organize reference materials is placing them inside the references/ directory within your skill folder. This standardized layout promotes reuse and follows the progressive disclosure approach for skill documentation.