adv-skill-author

Standardize agent skill creation with YAML frontmatter and progressive disclosure.

4|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/Sharper-Flow/Advance --skill adv-skill-author
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adv-skill-author
Source: https://github.com/Sharper-Flow/Advance/tree/main/skills/adv-skill-author
Command: npx skills add https://github.com/Sharper-Flow/Advance --skill adv-skill-author

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of inconsistent, poorly documented, or unstructured agent capabilities by providing a rigorous framework for creating and maintaining new skills.

Core Features & Use Cases

  • Standardized Templating: Ensures every new skill includes essential instructions, metadata, and resource structures.
  • Progressive Disclosure: Promotes clean, readable SKILL.md files by offloading deep-dive documentation to external reference files.
  • Use Case: When building a new domain-specific agent, use this skill to generate the required directory structure and documentation templates to ensure the agent can effectively discover and utilize the new capability.

Quick Start

Use the adv-skill-author skill to generate a new skill template for a custom domain named data-analysis.

Frequently Asked Questions about adv-skill-author

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

FAQPage Schema
How do I standardize agent skill creation and documentation?

Standardizing agent skill creation requires enforcing mandatory YAML frontmatter, clear trigger descriptions, and appropriate resource organization. This ensures every new capability contains essential instructions and metadata for optimal agent discovery and utilization.

What is progressive disclosure for agent skill documentation?

Progressive disclosure for agent documentation is a pattern that keeps core SKILL.md files clean and readable by offloading deep-dive technical details to external reference files. This allows agents to quickly parse primary instructions without processing unnecessary context.

How do I generate a documentation template for a new domain-specific agent?

Generating a documentation template for a domain-specific agent involves using an automation skill to scaffold the required directory structure. This enforces structural requirements and produces standardized templates containing essential metadata for the new capability.

Does my agent skill need YAML frontmatter to be discoverable?

Yes, your agent skill needs mandatory YAML frontmatter to be discoverable. Enforcing this metadata structure ensures the agent can effectively parse the skill's trigger descriptions and resource organization to find and utilize the new capability.

What's the best way to structure a bundled agent skill?

The best way to structure a bundled agent skill is to enforce a standardized template with mandatory YAML frontmatter and progressive disclosure. This organizes resources appropriately and offloads deep-dive documentation to external files for optimal agent discovery.

Why does my agent fail to discover newly created skills?

Your agent fails to discover newly created skills when they lack mandatory YAML frontmatter, clear trigger descriptions, or appropriate resource organization. Standardizing the skill structure ensures the agent can effectively find and utilize the new capabilities.