← ClaudeAtlas

skill-authorlisted

Create and refine high-quality Agent Skills (SKILL.md + bundled resources). Use when the user wants to create a new skill, improve an existing one, or turn a workflow into a reusable skill package. Covers structure, progressive disclosure, conciseness, feedback loops, and the quality checklist. Do NOT use for skill validation (use skill-check) or for prompt engineering (use prompt-craft).
VictorGjn/agent-skills · ★ 1 · AI & Automation · score 70
Install: claude install-skill VictorGjn/agent-skills
# Skill Author Create skills that Claude can discover and use reliably. Based on Anthropic's official Agent Skills best practices (April 2026). ## Core Philosophy 1. **Claude is already smart** — only add context it doesn't have 2. **Context window is a shared resource** — every token competes with conversation, other skills, and system prompt 3. **Test with real usage, not assumptions** — iterate based on observed agent behavior ## Skill Creation Workflow 1. **Identify the pattern**: Complete a task manually with Claude. Note what context you repeatedly provided (schemas, rules, conventions, sequences). 2. **Draft SKILL.md**: Write frontmatter + body following the structure below. 3. **Apply conciseness pass**: For every paragraph, ask "Does Claude need this?" Remove what it already knows. 4. **Set degrees of freedom**: Match specificity to task fragility (see Freedom Levels below). 5. **Bundle resources**: Move detailed references and scripts to separate files. Keep SKILL.md as the table of contents. 6. **Test with fresh context**: Use the skill on a real task in a new session. Observe what Claude misses, over-reads, or ignores. 7. **Iterate**: Refine based on observed behavior, not assumptions. 8. **Validate**: Run `skill-check` to catch structural issues. ## SKILL.md Structure ```yaml --- name: lowercase-hyphenated # 3-64 chars, no reserved words description: "Action verb + what it does + 'Use when...' trigger. Max 1024 chars." requiredApps: [app-slug] #