skills.rest
TorchedHat
TorchedHatOFFICIAL
Explore all skills by this author →
GitHub

skill-writer

Create and validate Claude Code Agent Skill definitions with SKILL.md structure.

6|8|Updated May 7, 2026
Search Tags:#validation#claude code#agent skills#prompt design#skill authoring#yaml frontmatter
One-click install
npx skills add https://github.com/TorchedHat/ai-marketplace --skill skill-writer-torchedhat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/TorchedHat/ai-marketplace/tree/main/ai-writer/skills/skill-writer
Command: npx skills add https://github.com/TorchedHat/ai-marketplace --skill skill-writer-torchedhat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users turn ideas, prompts, and workflows into well-structured Claude Code Agent Skills that are discoverable, focused, and compliant with SKILL.md requirements.

Core Features & Use Cases

  • Skill Design Guidance: Clarifies scope, naming, structure, and the appropriate supporting resources for a new Skill.
  • Frontmatter and Content Authoring: Creates specific descriptions, actionable instructions, examples, and optional tool restrictions.
  • Validation and Troubleshooting: Checks naming conventions, YAML frontmatter, file organization, activation behavior, and common discovery issues.

Quick Start

Use the skill-writer skill to design and validate a new Claude Code Skill for a specific capability.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I create and validate Claude Code agent skills?▼

Authoring agent skills requires structuring SKILL.md files with YAML frontmatter, naming conventions, and actionable instructions. Validate the design to ensure focused scope and proper supporting-file organization for reliable Claude Code activation.

What is required in YAML frontmatter for Claude Code skills?▼

YAML frontmatter for Claude Code skills requires specific metadata fields to satisfy discovery and validation requirements. Proper frontmatter ensures the agent skill is correctly identified and activated within the Claude Code environment.

Why does my Claude Code skill not activate during prompt execution?▼

Activation issues occur when SKILL.md files violate naming conventions, lack required YAML frontmatter, or contain unfocused scope. Troubleshoot by validating file organization and improving discovery descriptions.

How do I design the structure for a new Claude Code skill?▼

Designing a new Claude Code skill involves clarifying scope, defining a specific name, organizing supporting resources, and writing actionable instructions. Include examples and testing guidance to ensure the prompt design performs reliably.

Can I update existing SKILL.md files to improve skill discovery?▼

Existing SKILL.md files can be updated to improve skill discovery by refining descriptions, ensuring focused scope, and validating YAML frontmatter. Correctly structuring supporting files and examples enhances agent skill activation.

Related Skills

Explore More Software Engineering Skills→
unfinishablemapunfinishablemap
3

expand-topic

Generate a publish-ready article draft from a topic prompt.

Community
Intermediate
IncomeStreamSurferIncomeStreamSurfer
25

agent-skills-guide

Guide users through creating and managing Claude Code Agent Skills.

Community
Basic
nanorepublicananorepublica
61

Global Commenting

Apply standardized file headers and module-level comments across codebases.

Community
Basic
danielmiesslerdanielmiessler
17.4k

prompting

Optimize AI agent prompts with structured Markdown and context engineering principles.

Community
Basic