skills.rest
EvaLok
EvaLokCOMMUNITY
Explore all skills by this author →
GitHub

writing-skills

Author Claude Code skills with required YAML frontmatter and SKILL.md structure.

1|Updated Apr 10, 2024
Search Tags:#skill development#best practices#documentation#claude skills#code structure#yaml frontmatter
One-click install
npx skills add https://github.com/EvaLok/schema-org-json-ld --skill writing-skills-evalok
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/EvaLok/schema-org-json-ld/tree/main/.claude/skills/writing-skills
Command: npx skills add https://github.com/EvaLok/schema-org-json-ld --skill writing-skills-evalok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides clear guidelines and best practices for creating, structuring, and maintaining Claude Code skills within this project, ensuring consistency and discoverability.

Core Features & Use Cases

  • Skill Structure: Defines the required directory and file naming conventions (.claude/skills/<skill-name>/SKILL.md).
  • Frontmatter Requirements: Details essential YAML frontmatter fields (name, description) and optional ones (disable-model-invocation, user-invocable, etc.).
  • Content Guidelines: Offers advice on structuring SKILL.md content, writing effective descriptions, and keeping skills focused.
  • Use Case: When developing a new feature that requires a specific AI interaction, use this skill to understand how to package that interaction as a discoverable and usable Claude skill.

Quick Start

Follow the directory structure and frontmatter requirements outlined in this skill to create a new skill.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I structure a Claude Code skill for discoverability?▼

To structure a Claude Code skill, create a directory at `.claude/skills/<skill-name>/` and place a `SKILL.md` file inside. This mandatory file structure ensures the AI-driven functionality is discoverable and maintainable within the project.

What YAML frontmatter is required for Claude skills?▼

Required YAML frontmatter for Claude skills includes the `name` and `description` fields. Optional fields like `disable-model-invocation` and `user-invocable` are also available to control skill behavior and invocation methods.

What are the best practices for writing Claude skill descriptions?▼

Best practices for writing Claude skill descriptions involve keeping skills focused and organizing content clearly within `SKILL.md`. Writing effective descriptions ensures the AI interaction is easily discoverable and usable.

When do I need to create a custom Claude skill?▼

You need to create a custom Claude skill when developing a new feature that requires a specific AI interaction. Packaging this interaction as a skill provides clear guidelines and ensures consistency and discoverability within your project.

Can I disable model invocation for a specific Claude skill?▼

Yes, you can disable model invocation for a specific Claude skill by using the `disable-model-invocation` field in the YAML frontmatter. This is an optional configuration available for skill authors.

Related Skills

Explore More Software Engineering Skills→
oaustegardoaustegard
137

versioning-skills

Initialize Git repositories and commit changes for skill directories.

Community
Basic
kettleofketchupkettleofketchup
13

inv-runner

Orchestrate Python Invoke commands across development, testing, and production environments.

Community
Advanced
LamseyahEliasLamseyahElias

hermes-agent-skill-authoring

Define in-repo Hermes-Agent skills with SKILL.md and YAML frontmatter.

Community
Intermediate
znc15znc15

trellis-meta

Document local Trellis project architecture and customization entry points.

Community
Advanced