skills.rest
bingeli1379
bingeli1379COMMUNITY
Explore all skills by this author →
GitHub

skill-authoring-guidelines

Standardize SKILL.md frontmatter, structure, and description rules for eureka-sdd Skill Units.

2|Updated Apr 6, 2026
Search Tags:#templates#documentation#validation#frontmatter#skill-discovery#skill-authoring
One-click install
npx skills add https://github.com/bingeli1379/eli-claude-marketplace --skill skill-authoring-guidelines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring-guidelines
Source: https://github.com/bingeli1379/eli-claude-marketplace/tree/main/plugins/eureka-sdd/skills/skill-authoring-guidelines
Command: npx skills add https://github.com/bingeli1379/eli-claude-marketplace --skill skill-authoring-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes the creation and maintenance of SKILL.md files to ensure consistent frontmatter, structure, and quality across all Skills in the eureka-sdd ecosystem.

Core Features & Use Cases

  • Defines mandatory frontmatter fields such as name and description and requires a proper YAML frontmatter block.
  • Specifies the required SKILL.md at the root of each Skill Unit and outlines optional directories (scripts/, references/, assets/) for extended content.
  • Establishes cross-skill referencing norms and SOURCES.yaml registrations to enable reliable discovery and linking.

Quick Start

Follow these guidelines when authoring or editing SKILL.md files to ensure consistency and discoverability.

Frequently Asked Questions about skill-authoring-guidelines

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

FAQPage Schema
What are the mandatory frontmatter fields required in a SKILL.md file?▼

Mandatory frontmatter fields for a SKILL.md file include name and description, which must be defined within a valid YAML frontmatter block to ensure proper skill discovery and validation.

How do I structure directories when authoring a new Skill Unit?▼

To structure a Skill Unit, place a SKILL.md file at the skill root directory, and optionally add scripts/, references/, and assets/ directories for extended content and resources.

How do I register a new Skill for cross-referencing and discovery?▼

To register a Skill for cross-referencing and discovery, you must add an entry to the SOURCES.yaml file, enabling reliable linking and validation across the eureka-sdd plugin ecosystem.

Why does my skill fail validation during the authoring process?▼

Skill validation fails when the SKILL.md file lacks mandatory YAML frontmatter fields like name and description, or is not properly registered in the SOURCES.yaml file.

Can I use custom directories outside of scripts, references, and assets?▼

The guidelines specify optional scripts/, references/, and assets/ directories for extended content. Custom directories outside of these are not covered by the standard skill authoring structure.

What is the purpose of standardizing SKILL.md entries?▼

Standardizing SKILL.md entries ensures consistent frontmatter, structure, and quality across all Skills, enabling reliable discovery, linking, and maintenance within the ecosystem.

Related Skills

Explore More Education & Research Skills→
huyhung9630huyhung9630
1

omc-skill

Manage local Codex skills with list, add, edit, and validate commands.

Community
Intermediate
cuiosscuioss
4

table-references-test

Execute scripts referenced in Markdown tables to verify workflow outcomes.

Official
Intermediate
can1357can1357
23.2k

different-name

Detect mismatches between SKILL.md frontmatter names and parent directory names.

Community
Basic
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate