Localized reading guide
skill-creatorPurpose, usage and source
Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.
Source retrieved:
- Source repository
- microsoft/skills
- SKILL.md
.github/skills/skill-creator/SKILL.md- Repository stars
- 3,157
- Repository updated
- 2026-10-31
- Categories
- Agent workflows
- Last collected
License: MIT
Workflow excerpts are reading aids, not executable instructions from Codez. No third-party Skill was run to produce this page.
The purpose and workflow passages below are upstream material, organized and translated for reading. They are distinct from the separately labeled Codez editorial analysis.
What this Skill does
Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.
How the upstream workflow works
Core Workflow Discipline (REQUIRED)
Every Azure SDK skill must clarify which workflow(s) it documents. Case 1: Single clear "core workflow" (majority of services) If one pattern handles ~80% of use cases: Designate it as the core workflow
Upstream passage · L151 ↗Skill Creation Process
Gather SDK Context — User provides SDK/API reference (REQUIRED) Understand — Research SDK patterns from official docs Plan — Identify reusable resources and product area category Create — Write SKILL.md in .github/skills//
Regeneration Workflow Step 3: Validate Regenerated Skill Behavior
If the skill has a Vally scenario, run that eval as well (locally or in CI) before finalizing. Rust regeneration gate (required for Rust skills): When regenerating any Rust skill, verify the generated ## Best Practices section contains these exact first two rules: Use cargo add to manage dependencies, never edit Cargo.toml directly
## Before Implementation
Search `microsoft-docs` MCP for current API patterns:
- Query: "[SDK name] [operation] python"
- Verify: Parameters match your installed SDK versionRequirements and setup
No short requirements passage was selected from this file. This does not mean the Skill has no dependencies. Check the repository setup instructions and referenced files.
Limits and quality checks
No separate limits passage was selected from this file. This does not mean the Skill is safe for every input or environment. Review the complete source and validate your own result.
Start with a safe trial
- Check the supported host and the repository installation instructions. Keep the Skill directory and its referenced scripts, assets and documentation together; SKILL.md alone may omit dependencies.
- Give the agent your real input, desired output and acceptance criteria. Invocation syntax and available tools depend on the host; this site does not assume a universal install command.
- Try the source workflow in a disposable project or on a copy. Review operations that change files, remote services or billable resources before allowing them.
- Validate the output against the source quality checks and your own requirements. A successful trigger or a high repository Star count does not establish a correct result.
Read further in the source
- Skill Creator
- About Skills
- 1. Concise is Key
- 2. Fresh Documentation First
- 3. Degrees of Freedom
- 4. Progressive Disclosure
- Skill Structure
- SKILL.md Essentials
- Creating Azure SDK Skills
- Token Budget Guidelines (REQUIRED)
- Reference Extraction Guide (REQUIRED)
- Core Workflow Discipline (REQUIRED)
- Skill Section Order
- Required Authentication & Lifecycle Callout (Python)
- Authentication Pattern (All Languages)
- Anti-Patterns: What NOT to Do (REQUIRED Reading)
- Anti-Pattern 1: "Exhaustive API Reference"
- Anti-Pattern 2: "Multiple Ways to Solve One Problem"
- Anti-Pattern 3: "Beginner + Intermediate + Advanced in One Skill"
- Anti-Pattern 4: "Restating Official Documentation"
- Anti-Pattern 5: "Verbose Explanation When Example Suffices"
- Efficiency Validation (REQUIRED - Phase 2)
- Standard Verb Patterns
- Language-Specific Patterns
- Python, .NET, Java, TypeScript, and Go languages
- Rust Language
- Example Effective Skills (Benchmark Only Structure-Compliant Skills)
- Handling Deprecated or Rebranded SDKs
- Skill Creation Process
- Step 1: Gather SDK Context (REQUIRED)
Related Skills
Translation and scope
This reading guide selects passages from the pinned upstream SKILL.md. Translation is assisted. It is not a complete manual or a claim of tested compatibility. Read the original and its referenced files before use.
This introduction refers to the pinned version below; current repository activity and collection time are shown separately.
- Pinned source
- Read the original ↗
- Source retrieved
- Source commit
00d66a64919edca5bca2c673373444e36a4b5461- Source SHA-256
15ce951aec071c813150e6794628664725c164223108792e15bd3db18e959da0