skills.rest
rust-works
rust-worksOFFICIAL
Explore all skills by this author →
GitHub

skill-writing

Create and maintain Claude Code skills with a standardized SKILL.md template.

51|3|Updated Dec 25, 2025
Search Tags:#documentation#guidelines#best-practices#claude-code#frontmatter#skill-structure#skill-writing
One-click install
npx skills add https://github.com/rust-works/succinctly --skill skill-writing-rust-works
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writing
Source: https://github.com/rust-works/succinctly/tree/main/.claude/skills/skill-writing
Command: npx skills add https://github.com/rust-works/succinctly --skill skill-writing-rust-works

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clear guidance and structure for creating and maintaining Claude Code skills, ensuring consistent SKILL.md documents and effective onboarding for contributors.

Core Features & Use Cases

  • Standardized Skill File Structure: provides a consistent SKILL.md frontmatter and body layout to accelerate skill creation and review.
  • Optional Resource Organization: explains how to use scripts/, references/, and assets/ directories to store supporting materials.
  • Onboarding and Collaboration: helps teams share knowledge and align skill quality across projects.

Quick Start

Create a new skill directory, add a SKILL.md with a concise frontmatter (name and description), then follow the body guidance to structure content and add optional supporting files if needed.

Frequently Asked Questions about skill-writing

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

FAQPage Schema
How do I structure a Claude Code skill file for consistent documentation?▼

To structure a Claude Code skill file, you need a SKILL.md document with concise frontmatter (name and description) followed by a structured body. This standardized skill structure enforces consistent documentation and accelerates review.

What is the required frontmatter for a SKILL.md file?▼

The required frontmatter for a SKILL.md file includes name and description fields. Enforcing these frontmatter requirements ensures your Claude Code skills are properly documented and easily understood by contributors.

How do I organize supporting scripts and references when writing Claude Code skills?▼

You organize supporting scripts and references by using optional scripts/, references/, and assets/ directories within your skill folder. This resource organization keeps extended content separate from the main SKILL.md file.

What is the best way to onboard collaborators to write Claude Code skills?▼

The best way to onboard collaborators to write Claude Code skills is providing a standardized SKILL.md template with clear guidance. This ensures consistent skill documentation and aligns quality across projects.

Do I need to create separate directories for every Claude Code skill?▼

You need to create a new skill directory for each skill, but supporting directories like scripts/, references/, and assets/ are optional. Add them only if your skill requires extended content beyond the core SKILL.md file.

Related Skills

Explore More Software Engineering Skills→
masa-codehubmasa-codehub

bootstrapping-skills

Generate Gemini CLI agent skill scaffolds with SKILL.md templates.

Community
Intermediate
takashabetakashabe
4

review-skill

Assess Claude Code skills against official best-practice guidelines.

Community
Intermediate
sambersamber
2.9k

golang-code-style

Enforce Go code style, formatting, and conventions across a codebase.

Community
Intermediate
windyskywindysky

moai-docs-generation

Generate documentation patterns from code for Sphinx, MkDocs, TypeDoc, and Nextra.

Community
Advanced