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 4168f6c 15 files · 18.6 KB Updated

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/tree/main/skills/white-paper-writing/blastum-skill-authoring commit 4168f6c764

Frequently asked questions

npx skillmds@latest add ever-just/skill-authoring