skill-design

What problem does it solve?

Designing effective AI skills can be complex, leading to inefficient context usage, unreliable execution, or poor discoverability. This Skill provides a comprehensive guide to building high-quality, production-ready skills that are robust, efficient, and easy to use.

Core Features & Use Cases

• Skill Anatomy & Types: Understand the structure of a skill, including scripts/, references/, and assets/, and choose between Knowledge, Hybrid, or Tool skills based on task complexity and fragility.
• Progressive Disclosure: Optimize context usage by structuring SKILL.md and leveraging references for on-demand information loading.
• Tool Restrictions & Trigger Phrases: Learn to define appropriate tool access and craft effective trigger phrases for automatic skill activation.
• Use Case: When creating a new skill for "PDF processing," use this skill to determine whether it should be a "Tool Skill" (due to deterministic file manipulation), how to structure its scripts/ and references/ directories, and what trigger phrases to include in its description.

Quick Start

To get best practices for structuring a new skill, ask: Explain the different types of skills and when to use scripts, references, or assets.