skills.rest
lespaceman
lespacemanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-skills

Author and validate SKILL.md entries with YAML frontmatter and triggering rules.

4|1|Updated Feb 3, 2026
Search Tags:#tdd#documentation#skills#quality#frontmatter#triggering#skill-authoring
One-click install
npx skills add https://github.com/lespaceman/athena-workflow-marketplace --skill writing-skills-lespaceman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/lespaceman/athena-workflow-marketplace/tree/main/plugins/superpowers/skills/writing-skills
Command: npx skills add https://github.com/lespaceman/athena-workflow-marketplace --skill writing-skills-lespaceman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users to author high-quality SKILL.md entries and ensures proper frontmatter and triggering, reducing errors and inconsistencies.

Core Features & Use Cases

  • Standardized SKILL.md template with frontmatter validation and a consistent triggering model.
  • Structured guidance for writing CSO-aligned descriptions, keywords, and safe development workflows (RED-GREEN-REFACTOR).
  • Use cases include creating new skills, editing existing skills, and validating invocations before publishing.

Quick Start

Follow the Skill authoring template to create a new SKILL.md and validate it with the RED-GREEN-REFACTOR cycle.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I author and validate new Skills with proper YAML frontmatter?▼

To author and validate new Skills, you enforce YAML frontmatter, triggering rules, and structured documentation within SKILL.md entries, ensuring consistent discovery, invocation, and testing workflows before deployment.

What is the RED-GREEN-REFACTOR cycle for skill development?▼

The RED-GREEN-REFACTOR cycle is a structured safe development workflow for testing SKILL.md entries: write a failing test, make it pass, then refine the skill to ensure proper invocation and quality before publishing.

How do I write CSO-aligned descriptions and keywords for skill triggering?▼

Writing CSO-aligned descriptions requires specifying concise keyword coverage and following structured guidance for SKILL.md entries, ensuring proper triggering rules are met for consistent discovery and invocation across the repository.

What are the requirements for safety checks and optional resources directories in SKILL.md?▼

Safety checks govern Skill deployment by validating frontmatter and triggering rules, while optional resources directories can be included alongside SKILL.md entries to provide supplementary materials and maintain consistent repository structure.

Why does my SKILL.md entry fail invocation and discovery tests?▼

SKILL.md entries fail invocation tests when YAML frontmatter is missing or improperly structured, triggering rules lack CSO-aligned descriptions, or concise keyword coverage is insufficient for consistent discovery and safety check validation.

Related Skills

Explore More Content & Communication Skills→
AvaTar-ArTsAvaTar-ArTs

agent-creation-guidance

Design autonomous agent blueprints with standardized frontmatter and system-prompt templates.

Community
Intermediate
EmaRimoldiEmaRimoldi

command-development

Automate creation and validation of Claude Code Skill Units with SKILL.md frontmatter.

Community
Advanced
RBozydarRBozydar

skill-creator

Generate Claude Skill skeletons and validate SKILL.md structure.

Community
Advanced
zzafergokzzafergok
1

markdown-to-html-skill

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

Community
Intermediate