Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Instruções da origem · Visualização somente leitura
name
skill-creator
description
Create effective skills for AI agents — Azure SDK patterns, progressive disclosure, acceptance criteria, test scenarios
tier
standard
applyTo
**/*skill*,**/*SKILL*,**/skills/**
Skill Creator
Guide for creating skills that extend AI agent capabilities, with emphasis on Azure SDKs and external APIs
Related: See skill-building for Alex-specific skill creation workflow and promotion to Master Alex.
Core Principles
1. Concise is Key
The context window is a shared resource. Challenge each piece: "Does this justify its token cost?"
Default assumption: Agents are already capable. Only add what they don't already know.
2. Fresh Documentation First
Azure SDKs change constantly. Skills should instruct agents to verify documentation:
## Before Implementation
Search `microsoft-docs` MCP for current API patterns:
- Query: "[SDK name] [operation] python"
- Verify: Parameters match your installed SDK version
3. Degrees of Freedom
Match specificity to task fragility:
Freedom
When
Example
High
Multiple valid approaches
Text guidelines
Medium
Preferred pattern with variation
Pseudocode
Low
Must be exact
Specific scripts
4. Progressive Disclosure
Skills load in three levels:
Metadata (~100 words) — Always in context
SKILL.md body (<5k words) — When skill triggers
References (unlimited) — As needed
Keep SKILL.md under 500 lines. Split into reference files when approaching this limit.
config:model:gpt-4max_tokens:2000temperature:0.3scenarios:-name:basic_client_creationprompt:|
Create a basic example using the Azure SDK.
Include proper authentication and client initialization.
expected_patterns:-"DefaultAzureCredential"-"MyClient"forbidden_patterns:-"api_key="-"hardcoded"tags:-basic-authenticationmock_response:|
import os
from azure.identity import DefaultAzureCredential
from azure.ai.mymodule import MyClient
credential=DefaultAzureCredential()client=MyClient(endpoint=os.environ["AZURE_ENDPOINT"],credential=credential)# ... rest of working example
Scenario design principles:
Each scenario tests ONE specific pattern or feature
expected_patterns — patterns that MUST appear
forbidden_patterns — common mistakes that must NOT appear
mock_response — complete, working code that passes all checks
tags — for filtering (basic, async, streaming, tools)
Progressive Disclosure Patterns
Pattern 1: High-Level Guide with References
# SDK Name## Quick Start
[Minimal example]
## Advanced Features-**Streaming**: See [references/streaming.md](references/streaming.md)
-**Tools**: See [references/tools.md](references/tools.md)
