skills.rest
aspiers
aspiersCOMMUNITY
Explore all skills by this author →
Website𝕏@adamspiersGitHub

skill-authoring

Create, refactor and audit Claude Code skills with Anthropic's SKILL.md standards.

15|2|Updated Aug 16, 2025
Search Tags:#documentation#metadata#structure#progressive-disclosure#skill-authoring#anthropic-best-practices
One-click install
npx skills add https://github.com/aspiers/ai-config --skill skill-authoring-aspiers
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/aspiers/ai-config/tree/main/.claude/skills/skill-authoring
Command: npx skills add https://github.com/aspiers/ai-config --skill skill-authoring-aspiers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create, maintain, and audit Claude Code skills to ensure consistency with Anthropic's best practices, improving discoverability and maintainability across Skill Units.

Core Features & Use Cases

  • Establish metadata standards (name, description) and progressive disclosure guidelines to enable reliable discovery and loading.
  • Provide a repeatable Skill Structure, including the mandatory SKILL.md frontmatter and optional resources (scripts/, references/, assets/).
  • Facilitate auditing and refactoring of existing skills to ensure alignment with official guidelines for structure, naming, progressive disclosure, and testing.

Quick Start

Follow the guide to create or refactor Claude Code skills using Anthropic best practices.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I structure Claude Code skills to follow Anthropic best practices?▼

To structure Claude Code skills, use the mandatory SKILL.md frontmatter and optional directories like scripts/, references/, and assets/. This ensures reliable discovery and loading.

What is progressive disclosure in skill authoring and when is it needed?▼

Progressive disclosure in skill authoring is an architecture that layers metadata and skill resources to enable reliable discovery. It is needed when creating or refactoring skills for maintainability.

How do I audit existing skills for proper structure and naming conventions?▼

You audit existing skills by checking them against official Skill Unit guidelines for structure, naming, progressive disclosure, and testing. This ensures alignment with Anthropic best practices.

Can I refactor an existing Skill Unit without breaking frontmatter validation?▼

Yes, you can refactor existing Skill Units while satisfying frontmatter validation. The process ensures metadata standards and progressive disclosure guidelines are maintained during updates.

What metadata is required in the SKILL.md frontmatter for skill discovery?▼

The SKILL.md frontmatter requires metadata standards like name and description to enable reliable discovery and loading of Skill Units across the system.

Does this skill authoring guide support coupling optional resources like scripts and references?▼

Yes, the skill authoring guide supports optional resource coupling. You can include scripts/, references/, and assets/ directories alongside the SKILL.md file for extended functionality.

Related Skills

Explore More Software Engineering Skills→
yangliu2060yangliu2060
39

youtube-video-analyzer

Extract YouTube transcripts and captions into structured summaries with key points.

Community
Basic
Marcus-Mok-GHMarcus-Mok-GH

Skill Builder

Guide Claude Code Skill development with YAML frontmatter and directory structure.

Community
Intermediate
kitaekattkitaekatt
3

md-domain

Audit and author SKILL.md, CLAUDE.md, and project documentation for cohesion and cross-reference integrity.

Community
Advanced
LetPeopleWorkLetPeopleWork
16

architecture-patterns

Document architecture decisions and patterns using ADR templates.

Official
Basic