skills.rest
Herxinsasa
HerxinsasaCOMMUNITY
Explore all skills by this author →
GitHub

write-a-skill

Create agent skills with standardized structure and YAML frontmatter.

1|Updated Apr 22, 2026
Search Tags:#best-practices#workflow-automation#skill-creation#progressive-disclosure#agent-skills#skill-structure#task-automation
One-click install
npx skills add https://github.com/Herxinsasa/Skills-Collector --skill write-a-skill-herxinsasa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/Herxinsasa/Skills-Collector/tree/main/mattpocock-skills/skills/productivity/write-a-skill
Command: npx skills add https://github.com/Herxinsasa/Skills-Collector --skill write-a-skill-herxinsasa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating new agent skills often leads to inconsistent structure, poor discoverability, and missing bundled resources, making them hard to maintain, share, and use effectively for real-world tasks.

Core Features & Use Cases

  • Guided Creation Workflow: Walks you through requirement gathering, drafting, and user review to ensure the skill meets actual use cases.
  • Best Practice Enforcement: Implements standards for progressive disclosure, concise YAML frontmatter, and appropriate use of scripts, references, and assets.
  • Templates and Checklists: Provides ready-to-use SKILL.md templates and post-draft review checklists to avoid common mistakes.
  • Use Case: For example, if you want to build a skill to automate weekly code quality checks for your team, this skill will guide you to structure it with clear trigger descriptions, split detailed linting rules into reference files, and add validation scripts for common code style issues.

Quick Start

Use the write-a-skill skill to create a new skill that automates extracting key sales metrics from CSV files and generates weekly performance summary reports.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema
How do I structure an agent skill for task automation?▼

To structure an agent skill for task automation, you need a standardized SKILL.md template with concise YAML frontmatter, progressive content disclosure, and bundled executable scripts to ensure maintainability and proper discovery.

What is progressive disclosure in agent skill creation?▼

Progressive disclosure in agent skill creation is a best practice that structures content so agents receive high-level guidance first, splitting detailed rules into reference files to avoid overwhelming the context window.

How do I create a skill to automate workflow guidance?▼

You create a skill to automate workflow guidance through a guided creation workflow that gathers requirements, drafts trigger descriptions, bundles validation scripts, and performs post-draft reviews for your specific domain.

Do I need YAML frontmatter for agent skill discovery?▼

Yes, you need concise YAML frontmatter for agent skill discovery, as it provides the standardized metadata required for platforms to identify, categorize, and properly route tasks to your custom skills.

What is the best way to bundle scripts in custom skills?▼

The best way to bundle scripts in custom skills is to include executable validation scripts alongside reference materials within the skill package, ensuring the automation logic is directly accessible for domain-specific tasks.

Why does my custom agent skill fail to trigger consistently?▼

Your custom agent skill fails to trigger consistently due to poor discoverability from missing or inconsistent YAML frontmatter, or lacking clear trigger descriptions within the SKILL.md structure.

Related Skills

Explore More Software Engineering Skills→
KenKaiiiKenKaiii
28

workflow-builder

Create and validate workflow automation JSON configurations.

Community
Intermediate
PlagueHOPlagueHO
1

skill-creator

Scaffold Agent Skill directories with YAML frontmatter and optional assets.

Community
Intermediate
tmorrowdevtmorrowdev
1

data-context-extractor

Extract analyst knowledge into company-specific data skills with schema discovery.

Community
Advanced
JohnWebb4JohnWebb4

create-skill

Design and document Cursor Skills with required frontmatter and structure.

Community
Intermediate