skills.rest
steleman
stelemanCOMMUNITY
Explore all skills by this author →
GitHub

skill-writer

Guides creation of Claude Skills with proper frontmatter and directory structure.

1|Updated Apr 5, 2026
Search Tags:#documentation#markdown#yaml#claude-code#frontmatter#skill-discovery#skill-writing
One-click install
npx skills add https://github.com/steleman/pytorch-cuda-2.11.0 --skill skill-writer-steleman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/steleman/pytorch-cuda-2.11.0/tree/main/.claude/skills/skill-writer
Command: npx skills add https://github.com/steleman/pytorch-cuda-2.11.0 --skill skill-writer-steleman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create and structure well-formed Agent Skills for Claude Code by guiding users through proper SKILL.md frontmatter, naming conventions, and a consistent directory layout to ensure discovery and reliable activation.

Core Features & Use Cases

  • Validates and enforces a single Skill per directory with a SKILL.md frontmatter containing name and description.
  • Guides progressive disclosure with optional resources like scripts/, references/, and assets/ to organize supporting content.
  • Provides step-by-step guidance for drafting SKILL.md, validating YAML, testing activation, and troubleshooting discovery issues.

Quick Start

Create a new Skill directory named skill-name, add SKILL.md with valid frontmatter, and structure any optional resources as needed.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I structure a Claude Skill for proper discovery and activation?▼

To structure a Claude Skill for discovery, create a dedicated directory containing a SKILL.md file with valid YAML frontmatter specifying the name and description fields. This directory layout ensures reliable activation.

What is the correct frontmatter format required for SKILL.md files?▼

The correct frontmatter format for SKILL.md files requires valid YAML with mandatory name and description fields. Proper frontmatter validation ensures the Skill can be indexed and reliably activated by Claude Code.

How do I organize supporting scripts and references when creating Claude Skills?▼

Organize supporting scripts and references using progressive disclosure with optional subdirectories like scripts/, references/, and assets/ within the Skill directory to manage content without cluttering the main SKILL.md file.

Why does my Claude Skill fail to activate during testing?▼

Claude Skill activation fails during testing when the SKILL.md frontmatter contains invalid YAML, the directory structure houses multiple skills, or mandatory name and description fields are incorrectly formatted or missing.

Can I include multiple Agent Skills in a single directory?▼

No, you cannot include multiple Agent Skills in a single directory. The structural requirement enforces a single Skill per directory to ensure proper frontmatter validation and reliable skill discovery.

Related Skills

Explore More Content & Communication Skills→
louloulinlouloulin
19

skill-md-validator

Validate SKILL.md files for YAML frontmatter, required fields, and content.

Community
Basic
Odiabackend099Odiabackend099

skill-writer

Generate SKILL.md frontmatter and validate Claude Code Skill structures.

Community
Advanced
otrebuotrebu
4

skill-creator

Create standardized Claude Skill scaffolds with YAML frontmatter validation.

Community
Intermediate
lbliiilbliii
41

bengal-content-migration

Migrates static site and Markdown content to Bengal format.

Community
Intermediate