writing-skills

Name: writing-skills
Availability: InStock
Author: beyondwen

Draft YAML-based SKILL.md units with standardized frontmatter for Claude-like agents.

Updated Mar 30, 2026

Search Tags:#documentation #guidelines #frontmatter #skill-writing #ttd #searchability

Ready to run

npx skills add https://github.com/beyondwen/track-record-new --skill writing-skills-beyondwen

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/beyondwen/track-record-new/tree/main/.gemini/skills/writing-skills
Command: npx skills add https://github.com/beyondwen/track-record-new --skill writing-skills-beyondwen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to creating consistent, discoverable skill documents for Claude-like agents, enabling teams to craft high-quality SKILL.md units that are easy to find and test.

Core Features & Use Cases

Establishes a standard frontmatter with name and description and a concise body for guidance.
Enables progressive disclosure with linked references and scripts/assets when needed.
Improves discoverability and quality assurance by enforcing CSO-friendly descriptions and TDD-aligned validation.

Quick Start

Draft a minimal SKILL.md with required frontmatter and a short usage guide.

Frequently Asked Questions about writing-skills

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

FAQPage Schema

How do I write a SKILL.md file that Claude agents can discover and use?▼

To write a discoverable SKILL.md file, draft a YAML frontmatter with a name, CSO-friendly description, and clear keywords. This standardizes the structure for Claude-like agents and optimizes it for search and recall.

What is progressive disclosure in skill documentation and when should I use it?▼

Progressive disclosure in skill documentation is the practice of keeping the SKILL.md body concise while linking to optional scripts, references, and assets. Use it when you need to provide detailed guidance without exceeding token-safe metadata limits.

What's the best way to structure YAML frontmatter for agent skill files?▼

The best way to structure YAML frontmatter for agent skill files is to include a name and a concise description, supported by clear keywords. This enforces token-safe metadata limits and ensures the skill is testable.

Does writing skill documentation require any external dependencies or scripts?▼

Writing skill documentation does not require external dependencies. The skill unit standardizes SKILL.md frontmatter and guidance, allowing you to optionally link scripts and assets only when progressive disclosure is needed.

How do I make my Claude skill documentation easy to find in search?▼

To make your Claude skill documentation easy to find in search, enforce CSO-friendly descriptions and clear keywords in the YAML frontmatter. This approach optimizes the SKILL.md unit for searchability and recall.

Are there limitations on the size or format of skill metadata?▼

Yes, skill metadata has token-safe limits. The skill enforces token-safe metadata limits to ensure efficient processing, requiring a standardized YAML frontmatter and a concise body for guidance.