Creating Skills
Write discoverable, scannable Claude skills with proper structure and CSO optimization
What You Can Do
You can create new Claude skills from scratch or improve existing ones by following proven structural patterns, frontmatter standards, and discoverability best practices. This skill teaches you how to write skills that future Claude instances can quickly locate, scan, and effectively apply to real problems—ensuring your techniques get reused instead of forgotten.
Features
write YAML headers with proper naming conventions, descriptions, and tag structures that make skills discoverable
follow the proven layout of Overview, When to Use, Quick Reference, Implementation, and Common Mistakes sections
craft titles and descriptions that help Claude find and evaluate your skill efficiently
use gerund forms and avoid reserved words to keep skill names scannable and consistent
see working examples of well-structured skills across different domains and complexity levels
learn to distinguish between skills (broad patterns) and project conventions so you create the right artifact type
organize common operations in tables or bullet lists for fast evaluation by future Claude instances
Example Output
Well-Structured Skill Output
Frontmatter:
---
name: analyzing-performance-metrics
description: Use when debugging slow endpoints or tracking system bottlenecks - breaks down analysis patterns, common bottleneck sources, and measurement techniques
tags: performance, debugging, optimization
---
Quick Reference Table:
| Metric Type | What It Measures | Red Flag Threshold |
|---|---|---|
| Response Time | End-to-end latency | >500ms for user requests |
| Memory Usage | Heap allocation | >80% capacity |
| CPU Utilization | Processing load | >85% sustained |
Implementation Section: Shows 3-4 concrete code patterns or analysis approaches with inline examples, then links to a detailed reference document if needed.
What's Included
- SKILL.md instruction file with complete frontmatter and structure standards:
- Naming conventions checklist for gerund forms and reserved-word avoidance:
- When-to-use decision framework distinguishing skills from project conventions:
- Frontmatter template ready to copy for new skills:
- Document structure template with section guidelines and formatting examples:
- CSO optimization guide for crafting discoverable titles and descriptions:
Who It's For
- Claude skill authors and maintainers building reusable reference guides
- Engineering team leads establishing skill documentation standards across projects
- Documentation specialists improving discoverability and structure of existing skills
- AI workflow designers creating skill libraries for multi-agent systems
- Technical architects standardizing patterns and techniques across codebases
Best For
- Writing new skills from scratch with proper structure and frontmatter
- Auditing and improving existing skills for discoverability and clarity
- Establishing skill documentation standards within teams or organizations
- Creating skill naming conventions and tagging systems
- Distinguishing between skills, project conventions, and one-off solutions
You might also like
You get a structured decision framework that guides salary negotiations, cap optimization, and contract valuation in professional sports. The skill helps you analyze market comparables, model cap scenarios, design multi-year deal structures, and develop data-driven negotiation strategies that maximize player value while maintaining team financial flexibility.
by pr-pm
You can generate comprehensive licensing agreements tailored to sports partnerships, automatically calculate royalty structures based on various metrics, and verify compliance with jurisdiction-specific regulations. This skill ensures your licensing documents are legally sound, financially transparent, and audit-ready.
by pr-pm
You can develop comprehensive promotion strategies that segment audiences, coordinate messaging across digital and traditional channels, activate sponsorship opportunities, and measure campaign performance. This skill helps you create data-driven campaigns that maximize attendance, engage sponsors effectively, and track every promotion dollar spent across your sports event.
by pr-pm
You can systematically evaluate biomechanical data from motion capture systems, force plates, and sensor networks to identify performance bottlenecks and injury risk factors. The framework processes kinematic angles, ground reaction forces, and movement asymmetries to generate actionable coaching insights and training recommendations that enhance athletic performance while reducing injury likelihood.
by pr-pm
This skill helps you evaluate sponsorship opportunities, assess deal terms, and identify the best partners for your brand or event. Claude analyzes contracts, calculates ROI projections, identifies sponsorship gaps, and generates data-driven recommendations to maximize partnership value and revenue potential.
by pr-pm
Transform raw performance data into comprehensive analytics reports that reveal trends, strengths, and improvement areas. This skill processes workout metrics, competition results, and fitness data to generate detailed performance summaries with visual insights, statistical analysis, and personalized recommendations. You get actionable intelligence to optimize training, track progress, and make informed decisions about athlete development.
by pr-pm
Use Claude to generate comprehensive technical documentation for APIs, services, and libraries while enforcing consistency across hundreds of pages. You can audit existing docs against your style guide and best practices, then restructure the navigation for better developer discoverability. This skill transforms documentation from a maintenance burden into a scalable, developer-first asset that stays current as your product evolves.
You can evaluate licensing opportunities for sports brands and athletes, assess partnership fit against your business goals, and generate customized agreement frameworks tailored to your specific terms and protections. This skill helps you navigate the complex legal and commercial landscape of sports licensing while ensuring compliance with league regulations and industry standards.
by pr-pm