skill-writer

Author and validate Claude Code Skills with SKILL.md frontmatter.

Updated Mar 10, 2026

Search Tags:#documentation #validation #best-practices #claude-code #frontmatter #skill-structure #skill-writing

Ready to run

npx skills add https://github.com/Palbahngmiyine/harness --skill skill-writer-palbahngmiyine

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/Palbahngmiyine/harness/tree/main/skills/skill-writer
Command: npx skills add https://github.com/Palbahngmiyine/harness --skill skill-writer-palbahngmiyine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users author and validate Claude Code Skills by guiding the creation of SKILL.md frontmatter and a proper directory structure, ensuring consistency, discoverability, and adherence to best practices.

Core Features & Use Cases

Guided Skill authoring: Walks users through naming, frontmatter, and structure for new Skills.
Frontmatter validation: Checks for required fields and naming conventions, offering recommendations to improve clarity and discoverability.
Best-practice templates: Provides a compliant layout for single-file and multi-file Skills, including sections like Quick Start, Instructions, and Examples.

Quick Start

Describe your intended Skill and let this guide you through creating SKILL.md and the proper directory structure.

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 Code Skill with proper frontmatter and directory structure?▼

To create a Claude Code Skill, you need to author a SKILL.md file with valid frontmatter and a proper directory structure. This involves defining required fields like name and description, then organizing single-file or multi-file layouts according to best practices for discoverability.

What is the correct frontmatter format for validating a SKILL.md file?▼

Validating SKILL.md frontmatter requires checking for mandatory fields such as name and description, alongside optional metadata. It ensures your Claude Code Skill follows naming conventions and structure rules, making the skill discoverable and safe for execution.

When do I need a multi-file Skill layout instead of a single-file format?▼

You need a multi-file Skill layout when your Claude Code Skill requires supporting files for progressive disclosure. Single-file formats work for simple instructions, while multi-file structures accommodate complex best-practice templates, separating Quick Start, Instructions, and Examples.

Does Claude Code skill structure require specific naming conventions for discoverability?▼

Claude Code skill structure requires specific naming conventions to ensure discoverability and safe execution. Validating frontmatter checks that your project name and description fields adhere to these rules, improving clarity across new and restructured skill projects.

What are the best practices for writing actionable instructions in Claude Code Skills?▼

Best practices for writing Claude Code Skills include structuring SKILL.md with clear Quick Start, Instructions, and Examples sections. This progressive disclosure approach ensures instructions are safe, actionable, and easily discoverable by users navigating the skill structure.