What is the most important part of a skill?

The description is the most critical element. It determines discovery; if the agent cannot find the skill based on the metadata, the instructions in the body will never be executed.

Why isn't my skill triggering?

Skills trigger based on metadata pattern-matching. If your frontmatter description is too vague or lacks the specific keywords a user actually says, the agent will not recognize it as relevant and won't load the body.

What is a Claude Code Skill?

A skill is a specialized onboarding document that provides an agent with domain-specific knowledge, workflows, and best practices not found in the base model, effectively acting as institutional memory.

How do I manage large skill files?

Use progressive disclosure. Keep the primary SKILL.md under 500 lines for context efficiency and move detailed technical documentation or execution scripts into separate /references or /scripts directories.

Agent Skill Authoring

Name: Agent Skill Authoring
Author: joshuadavidthomas

byjoshuadavidthomas

•

학습 및 문서화

Guides the creation, refinement, and troubleshooting of specialized agentic LLM skills using standardized SKILL.md patterns.

The Agent Skill Authoring skill provides a comprehensive framework for building 'institutional memory' into LLM agents. It equips Claude with the expertise to design high-performance skills by focusing on optimized metadata for discovery, clear instructional hierarchies, and progressive disclosure patterns. This skill is essential when building new agent capabilities from scratch, fixing skills that fail to trigger, or refining agent behavior based on session learnings to ensure your AI assistants operate with domain-specific precision and efficiency.

주요 기능

01Best practices for teaching agents through orienting, instructing, and showing

02Standardized SKILL.md structure and YAML frontmatter syntax guidance

03Metadata optimization techniques for reliable skill discovery and triggering

04Troubleshooting protocols for non-responsive or misbehaving agent skills

054 GitHub stars

06Progressive disclosure strategies to maximize context window efficiency

사용 사례

01Optimizing context usage by splitting large skills into manageable reference layers

02Onboarding a new agent to a proprietary codebase or custom team workflow

03Debugging why an agent is ignoring specific instructions or failing to load a skill

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joshuadavidthomas/agent-skills skill-authoring

For use in Claude.ai and ChatGPT

Download Skill