skills.rest
MomoDaviluke
MomoDavilukeCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Design Claude skills with YAML frontmatter and progressive disclosure for structured knowledge capture.

2|Updated Mar 3, 2026
Search Tags:#workflow#documentation#skills#frontmatter#progressive-disclosure#agent-skills#skill-design
One-click install
npx skills add https://github.com/MomoDaviluke/star-citizen-promotion --skill writing-skills-momodaviluke
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/MomoDaviluke/star-citizen-promotion/tree/main/.trae/skills/writing-skills
Command: npx skills add https://github.com/MomoDaviluke/star-citizen-promotion --skill writing-skills-momodaviluke

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps teams design, validate, and maintain high-quality Claude Skill units by applying a TDD-inspired workflow to documentation, ensuring skills are discoverable, safe, and reusable.

Core Features & Use Cases

  • Defines the structure of SKILL.md with a YAML frontmatter including name and description.
  • Explains skill types (discipline, technical, pattern, reference) and progressive disclosure with cross-file references.
  • Recommends a modular directory structure (scripts/, references/, assets/) for scalable skills.
  • Provides quality checks, testing guidelines, and CSO considerations for searchability and safety.
  • Use cases include creating new skills, extending existing ones, and validating them before deployment.

Quick Start

Read the SKILL.md frontmatter and draft the rest of the file following the guidelines.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I structure a SKILL.md file with YAML frontmatter for Claude agent skills?▼

Claude skills use progressive disclosure with cross-file references to manage token efficiency. This approach separates detailed content into modular directories like scripts/ and references/, exposing only essential information initially.

What are the different types of Claude skills I can create using this documentation workflow?▼

A TDD-inspired documentation workflow validates skills through quality checks and testing guidelines before deployment. This ensures agent skills remain discoverable, safe, and reusable across evolving domains.

How do I validate Claude skill documentation before deployment?▼

Validate Claude skills by applying quality checks, testing guidelines, and CSO considerations to the SKILL.md file. This process verifies frontmatter compliance, searchability, and safe deployment readiness.

What is progressive disclosure in agent skill design and when do I need it?▼

Progressive disclosure in agent skill design uses cross-file references to load modular directory structures on demand. You need it when building scalable skills that must remain token-efficient and safe.

Related Skills

Explore More Content & Communication Skills→
lostitonce420-beeplostitonce420-beep

ai-secretary

Draft emails, manage calendar scheduling, and prepare meeting agendas.

Community
Intermediate
cedanlcedanl

simplify-ceda

Review R and Python code diffs against CEDA standards for reuse and quality.

Official
Advanced
third774third774
5

agent-skills

Author and improve Agent Skills following the agentskills.io specification.

Community
Basic
I-OnlabsI-Onlabs
3

writing-skills

Automate SKILL.md creation and verification with TDD-inspired practices.

Community
Advanced