Skip to content
Skill

authoring-skills

by diegosouzapw

AI Summary

Helps Claude developers write high-quality, discoverable skills by establishing clear structure, naming conventions, and progressive disclosure principles. Essential for anyone creating or maintaining Claude skills.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "authoring-skills" skill in my project.

Please run this command in my terminal:
# Install skill into the correct directory (2 files)
mkdir -p .claude/skills/authoring-skills && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/authoring-skills/SKILL.md "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/testing-security/authoring-skills/SKILL.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/authoring-skills/metadata.json "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/testing-security/authoring-skills/metadata.json"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Guides creation of effective Claude skills with proper structure, naming, and progressive disclosure. Use when creating new skills, improving existing SKILL.md files, reviewing skill quality, or when the user mentions writing skills, skill authoring, or SKILL.md.

Frontmatter requirements

`yaml --- name: processing-pdfs description: Extracts text and tables from PDF files. Use when working with PDFs or document extraction. --- ` name (required): • Max 64 characters • Lowercase letters, numbers, hyphens only • No reserved words: "anthropic", "claude" description (required): • Max 1024 characters • Third person ("Processes files" not "I can process files") • Include BOTH what it does AND when to use it • Include key trigger terms for discovery

Examples pattern

For quality-dependent output, provide input/output pairs: `markdown Example 1: Input: Added user authentication with JWT tokens Output: feat(auth): implement JWT-based authentication `

Skill Authoring

Create skills that Claude can discover and use effectively.

Conciseness is critical

The context window is shared. Only add what Claude doesn't already know. Challenge each piece of content: • "Does Claude really need this explanation?" • "Can I assume Claude knows this?" • "Does this justify its token cost?" Good (~50 tokens): `markdown

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 1mo ago
Active
AdoptionUnder 100 stars
0 ★ · Niche
DocsREADME + description
Well-documented

GitHub Signals

Issues0
Updated1mo ago
View on GitHub
No License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code