skill-writer

Creates and validates Claude Code Skill documentation with required frontmatter and structure.

2|Updated May 9, 2025
One-click install
npx skills add https://github.com/linjunhui/cuda-learning --skill skill-writer-linjunhui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/linjunhui/cuda-learning/tree/main/Pytorch学习/pytorch/.claude/skills/skill-writer
Command: npx skills add https://github.com/linjunhui/cuda-learning --skill skill-writer-linjunhui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the complex process of creating and validating Agent Skills for Claude Code, ensuring your AI tools are always well-structured and discoverable. It eliminates guesswork and reduces the time spent on debugging skill definition issues.

Core Features & Use Cases

  • Guided Skill Creation: Provides step-by-step instructions for defining skill scope, structure, and content.
  • Frontmatter & Description Optimization: Helps write effective SKILL.md frontmatter, including name and description for optimal AI discovery.
  • Validation & Troubleshooting: Offers a checklist and debugging tips to ensure your Skills meet all requirements and activate correctly.
  • Use Case: You want to create a new Claude Skill to automate a specific data analysis workflow. Instead of manually figuring out the file structure and YAML syntax, you use this Skill to guide you through each step, from defining the skill's purpose to writing its SKILL.md and testing its activation.

Quick Start

I want to create a new Claude Skill. Guide me through the process of defining its scope, structure, and writing the SKILL.md file.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I create a Claude Skill with proper frontmatter and structure?

Creating a Claude Skill requires defining frontmatter fields like name and description in your SKILL.md file, organizing your skill directory structure, and validating that all required elements are present. This Skill guides you through each step, from scope definition to testing activation, ensuring your skill meets Claude Code standards.

What should I include in my SKILL.md frontmatter for AI discovery?

SKILL.md frontmatter must include metadata fields like name, description, and other required attributes that enable Claude Code to index and discover your skill. This Skill provides templates and validation checklists to ensure your frontmatter is complete and optimized for visibility.

How do I validate that my skill meets Claude Code requirements?

Skill validation involves checking directory structure, confirming all required frontmatter fields are present, verifying content quality, and testing skill activation. This Skill offers a detailed checklist and debugging tips to catch issues before deployment.

Can I convert an existing prompt into a Claude Skill?

Yes, existing prompts can be converted into Skills by restructuring them with proper frontmatter, organizing files according to Skill standards, and validating the resulting specification. This Skill guides the conversion process step-by-step.

Why isn't my skill appearing in Claude Code discovery?

Skills fail to activate in discovery when frontmatter is incomplete, directory structure is incorrect, or required validation steps are skipped. This Skill provides troubleshooting guidance to diagnose and resolve discovery issues.