skills.rest
ingbyr
ingbyrCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-skills

Document the process for creating self-contained Skill units with SKILL.md frontmatter and optional resources.

2|Updated Apr 3, 2026
Search Tags:#workflow#tdd#documentation#discovery#patterns#frontmatter#skill-writing
One-click install
npx skills add https://github.com/ingbyr/lzcode --skill writing-skills-ingbyr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/ingbyr/lzcode/tree/main/packages/desktop/src-tauri/lz-assets/skills/writing-skills
Command: npx skills add https://github.com/ingbyr/lzcode --skill writing-skills-ingbyr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing and maintaining Skills is error-prone without a formal structure. This guide helps teams create self-contained Skill units with a consistent SKILL.md frontmatter, discovery metadata, and optional resource directories (scripts/, references/, assets/).

Core Features & Use Cases

  • Defines a flat namespace for Skills with SKILL.md as the entry point and minimal inline guidance.
  • Enforces YAML frontmatter requirements (name and description) and standard structure for reusability and discovery.
  • Outlines optional resource layouts (scripts/, references/, assets/) to house tooling, references, and media for on-demand loading.
  • Use cases include creating new Skills, updating existing ones, and validating Skill deployment workflows.

Quick Start

Create a new Skill by adding SKILL.md with proper frontmatter and, if needed, optional directories scripts/, references/, and assets/.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create reusable documentation that agents can discover and load?▼

Structure reusable documentation by writing a SKILL.md file with required YAML frontmatter like name and description, organizing content within a flat namespace to ensure agents can easily discover and load the unit.

What is the SKILL.md frontmatter format and what fields are required?▼

SKILL.md frontmatter is YAML metadata where name and description are required fields, while keywords, dependencies, components, and safety checks are captured to ensure reusability, safety, and correctness.

How do I organize scripts and reference files when writing a skill?▼

Organize scripts and reference files using optional resource directories like scripts/, references/, and assets/ to house tooling, references, and media for on-demand loading by agents.

Does this skill writing workflow include validation for correctness?▼

Yes, the skill writing workflow includes a validation process that verifies safety and correctness by checking exact requirements, dependencies, components, and safety checks before deployment.

When should I use test-driven development for skill documentation?▼

Use test-driven development for skill documentation when you need disciplined, repeatable techniques, applying validation workflows to ensure the documented requirements and safety checks function correctly.

Related Skills

Explore More Content & Communication Skills→
iamcapoteiamcapote

create-skill

Generate a standards-compliant SKILL.md file with required metadata fields.

Community
Intermediate
caobingshengcaobingsheng
1

skill-creator

Scaffold new Gemini Skill units with SKILL.md, scripts, references, and assets.

Community
Intermediate
Tx1207Tx1207
5

agent-identifier

Validates and standardizes Claude Skills agent frontmatter in SKILL.md files.

Community
Basic
dt418dt418

Docs Pack

Build documentation platforms with versioned docs, search, navigation, code highlighting, and API reference generation.

Community
Intermediate