Update Skill

If you're building or maintaining a collection of Claude skills, this is the meta-skill that helps you write and structure the SKILL.md files themselves. It covers the required YAML frontmatter (name and description fields), suggests a typical structure with title, overview, and main content sections, and includes practical guidance on when to split larger skills into reference subdirectories. The emphasis on action-verb descriptions and concrete use cases is smart, it makes skills actually discoverable. Think of this as the style guide and linter rolled into one. You'll reference it when spinning up new skills or refactoring existing ones that have grown messy.

skills.sh installs: 28.6K
GitHub stars: 684
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add warpdotdev/common-skills --skill update-skill --agent claude-code

Installs into .claude/skills of the current project.

Files

update-skill

This guide provides instructions for creating or updating skills in this repository. It covers the required structure, frontmatter, and best practices for skills.

Quick Start

Every skill is a directory containing a SKILL.md file with YAML frontmatter and markdown body:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents.
---

# PDF Processing

## When to use this skill
Use this skill when the user needs to work with PDF files...

## How to extract text
1. Use pdfplumber for text extraction...

## How to fill forms
...