skills.rest
yanochka11
yanochka11COMMUNITY
Explore all skills by this author →
GitHub

skill-authoring

Create and refine SKILL.md files with valid YAML frontmatter and structured instructions.

Updated May 5, 2026
Search Tags:#claude code#yaml#metadata#skill authoring#skill.md#ai workflows
One-click install
npx skills add https://github.com/yanochka11/harness_bro --skill skill-authoring-yanochka11
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/yanochka11/harness_bro/tree/main/.claude/skills/ported/skill-authoring
Command: npx skills add https://github.com/yanochka11/harness_bro --skill skill-authoring-yanochka11

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers create and refine SKILL.md files correctly, avoiding invalid metadata, unclear triggers, and inconsistent skill structures.

Core Features & Use Cases

  • Skill Metadata Authoring: Guides the creation of valid YAML frontmatter with required names, descriptions, versions, and metadata conventions.
  • Structure Optimization: Provides patterns for organizing skill instructions, usage triggers, validation steps, and supporting resources.
  • Use Case: When building a reusable AI workflow for a repository, use this Skill to design a discoverable SKILL.md entry point that follows established conventions.

Quick Start

Use the skill-authoring skill to create or improve a SKILL.md file for a new repository workflow.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I create a SKILL.md file with valid YAML frontmatter for AI workflows?▼

To create a SKILL.md file with valid YAML frontmatter, you must define required metadata fields like name, description, and version. The file needs organized operational guidance and must adhere to skill loader formatting requirements for proper AI skill discovery.

What is the best way to structure AI skill instructions in a repository?▼

The best way to structure AI skill instructions is by organizing operational guidance, usage triggers, validation steps, and supporting resources within your SKILL.md file to ensure reliable and discoverable AI workflows.

How do I validate metadata conventions in an existing SKILL.md file?▼

You validate metadata conventions in an existing SKILL.md file by checking its YAML frontmatter against established skill loader formatting requirements and ensuring all operational guidance and triggers are clearly structured.

Why does my AI workflow fail to trigger from repository skill discovery?▼

Your AI workflow fails to trigger when the SKILL.md file contains invalid metadata, unclear triggers, or inconsistent skill structures that do not adhere to required skill loader formatting conventions.

Can I use skill-authoring to improve existing AI skills instead of starting from scratch?▼

Yes, you can use this approach to improve existing AI skills by refining the SKILL.md file, optimizing YAML metadata, and reorganizing operational instructions to meet validation and formatting standards.

Related Skills

Explore More Software Engineering Skills→
pradeepmoulipradeepmouli
2

speckit-baseline

Generate baseline-spec.md and current-state.md from repository analysis.

Community
Advanced
DeDuvaDeDuva
1

{skill-name}

Load and validate SKILL.md frontmatter metadata for agent discovery.

Community
Basic
MiniMax-AIMiniMax-AI
13.3k

pr-review

Validate pull requests for YAML frontmatter, directory parity, and secrets.

Official
Intermediate
DriveConnect-alphaDriveConnect-alpha
1

documentation-templates

Generate standardized markdown documentation templates for new projects.

Official
Intermediate