skill-creator

Topics in the source

• Skill Creator
• About Skills
• Core Principles
• 1. Concise is Key
• 2. Fresh Documentation First
• 3. Degrees of Freedom
• 4. Progressive Disclosure
• Skill Structure

Guide for creating skills that extend AI agent capabilities, with emphasis on Azure SDKs and Microsoft Foundry. Required Context: When creating SDK or API skills, users MUST provide the SDK package name, documentation URL, or repository reference for the skill to be based on. Skills are modular knowledge packages that transform general-purpose agents into specialized experts: 1. Procedural knowledge — Multi-step workflows for specific domains 2. SDK expertise — API patterns, authentication, error handling for Azure services 3. Domain context — Schemas, business logic, company-specific patterns 4. Bundled resources — Scripts, references, templates for complex tasks -- The context window is a shared resource. Challenge each piece: "Does this justify its token cost?" For domain/procedural skills: Agents are already capable. Only add what they don't already know. For SDK/API skills: Users MUST provide SDK package name, documentation URL, or repository reference. The skill cannot be created without this context. Azure SDKs change constantly. Skills should instruct agents to verify documentation: Match specificity to implementation constraints. High freedom when approaches vary; low free

This is an excerpt. Refer to the complete source and its current requirements.