skill-authoring

Enforce SKILL.md frontmatter and directory structure for Agent Skills.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/BNTang/Sa-Token-Demo --skill skill-authoring-bntang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/BNTang/Sa-Token-Demo/tree/main/.claude/skills/skill-authoring
Command: npx skills add https://github.com/BNTang/Sa-Token-Demo --skill skill-authoring-bntang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes the creation of Agent Skills by ensuring each Skill directory contains a valid SKILL.md with mandatory metadata (name and description) and a clear, actionable guide for usage.

Core Features & Use Cases

  • Enforces the required frontmatter: name and description, and supports optional fields like license, compatibility, and metadata.
  • Defines the recommended directory structure (skill-name/, SKILL.md, scripts/, references/, assets/) to promote consistency and discoverability.
  • Provides guidance for auditing, teaching, and transferring Skill authoring practices to teams or new contributors.

Quick Start

Create a new Skill directory named after the Skill. Add a SKILL.md containing the frontmatter with name and description and a body describing usage. Optionally add scripts/, references/, and assets/ directories to support the Skill development and runtime.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
What is a SKILL.md file and why do I need it for agent skills?

A SKILL.md file standardizes agent skill creation by providing mandatory name and description frontmatter. It ensures reliable activation, consistent directory structure, and clear actionable usage guides for integration.

How do I structure an agent skill directory to ensure discoverability?

Structure your agent skill directory by creating a root folder named after the skill, adding a SKILL.md file, and optionally including scripts, references, and assets subdirectories to support development and runtime operations.

What frontmatter is required when authoring a SKILL.md file?

Authoring a SKILL.md requires name and description fields in the frontmatter. Optional fields include license, compatibility, and metadata to support auditing, teaching, and transferring practices to contributors.

Does agent skill standardization require any specific dependencies or environments?

Agent skill standardization requires no external dependencies. It relies solely on defining a valid directory structure and a SKILL.md file with mandatory metadata to ensure consistency and reliable integration.

Why does my agent skill fail to activate reliably without standardization?

Agent skills fail to activate without standardization due to missing SKILL.md metadata validation. Enforcing actionable body content and mandatory name and description frontmatter supports reliable activation and discoverability.

What is the best way to document agent skills for team handoff?

The best way to document agent skills for team handoff is using a standardized SKILL.md. It codifies directory structure, frontmatter rules, and actionable guides to transfer authoring practices to new contributors.