Skill Authoring

Write and refactor agent skills using published best practices (Anthropic and others), emphasizing token efficiency and progressive disclosure. Use when authoring new skills, merging learning from other skills into one organized skill, or restructuring skills sensibly.

ever-just Updated 6 repo stars

File contents

Skill Authoring

Write skills according to best practices published by Anthropic and others. The focus is token efficiency and progressive disclosure: small, high-signal roots that load deeper material only when needed.

Use this skill to refactor existing skills without bloat, and to integrate new learning (or several related skills) into a single, organized skill set. Most of the skills in this repository were written or refactored with these patterns.

Structure

Level 1 (this file): Frontmatter + pointers only
Level 2: Core skill content OR index to Level 3
Level 3: Detailed topic files (for complex skills)

Quick Reference

Skill Complexity Structure
Simple L1 → L2 (single file)
Complex L1 → L2 (index) → L3 (topic files)

Resources

  • Core principles
  • Structure patterns
  • Templates
  • Anti-patterns

ever-just/agentskills commit 4168f6c764

Frequently asked questions

npx get-skill add ever-just/skill-authoring