skill-writer

Guide creation of Claude Code Agent Skills with SKILL.md structure.

Updated Jun 5, 2025
One-click install
npx skills add https://github.com/wangzitian0/finance_report --skill skill-writer-wangzitian0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/wangzitian0/finance_report/tree/main/.opencode/skills/meta/skill-writer
Command: npx skills add https://github.com/wangzitian0/finance_report --skill skill-writer-wangzitian0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation of Agent Skills for Claude Code, ensuring they are well-structured, discoverable, and adhere to best practices and validation requirements.

Core Features & Use Cases

  • Guided Skill Creation: Provides step-by-step instructions for building new Skills.
  • SKILL.md Optimization: Helps users write effective name and description frontmatter.
  • Structure & Validation: Guides users on file structure, naming conventions, and validation checklists.
  • Use Case: You have a great idea for a new Claude Skill but are unsure about the correct SKILL.md format, naming conventions, or how to structure the supporting files. Use this Skill to get expert guidance.

Quick Start

Use the skill-writer to help you create a new Agent Skill for Claude Code.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I create an Agent Skill for Claude Code?

To create an Agent Skill for Claude Code, you need to structure a SKILL.md file with proper YAML frontmatter, including name and description fields, and follow specific naming conventions and validation checklists to ensure discoverability and functionality.

What is the correct SKILL.md format for Claude agent skills?

The correct SKILL.md format requires YAML frontmatter with a name and description, followed by structured content sections. Adhering to these best practices ensures your Claude agent skill is properly discovered and functions as intended.

How do I write effective YAML frontmatter for Claude Code skills?

Writing effective YAML frontmatter for Claude Code skills involves crafting concise name and description fields that accurately represent the skill's purpose, directly impacting its discoverability and how the agent interprets the skill's functionality.

What are the validation requirements for Claude agent skills?

Validation requirements for Claude agent skills include meeting specific naming conventions, structuring the SKILL.md file correctly, and ensuring the supporting files and content organization adhere to best practices for functional discoverability.

Do I need any dependencies to build Claude Code skills?

No dependencies are required to build Claude Code skills. You only need to follow the step-by-step guidance for SKILL.md creation, YAML frontmatter optimization, and file structure validation to ensure your skill is properly structured and discoverable.

What's the best way to structure supporting files for a Claude skill?

The best way to structure supporting files for a Claude skill is to follow the guided organization practices provided, ensuring your file structure, naming conventions, and references align with the validation checklist for optimal agent functionality.