Browse / Learning Documentation / Skill Writing Guide

Skill Writing Guide

Provides standardized guidance, conventions, and best practices for creating new Claude Code skills.

SkillLearning DocumentationTechnical WritingDocs StandardsSkill Authoring

The source repository doesn't declare a license. Check its terms before reusing the code.

Key features

  • Provides best practices for writing effective skill descriptions and activation triggers.
  • Establishes naming conventions, including the underscore prefix for core skills.
  • Explains advanced features like using symlinks and accessing scripts.
  • Defines required directory structure and SKILL.md format.
  • Offers guidance on cross-referencing context to avoid content duplication.

Use cases

  • Developing a personal skill to help Claude remember specific information or perform a custom task.
  • Creating a new core utility skill for the Claude Autonomy Platform.
  • Structuring and documenting a new skill according to platform standards.

FAQ

What does the Skill Writing Guide do?

It provides standardized instructions, conventions, and best practices for creating new Claude Code Skills. It's the official manual for developers looking to extend Claude's capabilities with custom functions.

When should I use this skill?

Activate this skill whenever you are creating a new skill for Claude or need a reference on the required format. It's essential for ensuring your custom skills are recognized and function correctly within the platform.

How does this skill improve my workflow?

It streamlines the skill creation process by providing a clear, official template. By following its guidance on structure, naming, and activation triggers, you can build reliable and efficient skills much faster, avoiding common errors.

What key conventions does it establish?

This skill defines the required directory structure, the SKILL.md format, naming rules (like the underscore prefix for core skills), and best practices for writing effective activation triggers and cross-referencing context to avoid duplication.