skill-creator

Run init_skill.py with the skill name and target path to scaffold a directory containing SKILL.md plus example scripts, references, and assets. Then edit the SKILL.md frontmatter description and body, following the section order and conciseness guidelines.

You must provide the SDK package name, a Microsoft Learn documentation URL or GitHub repository reference, and the target language. The skill cannot be created without this context because Azure SDK APIs change frequently.

Run quick_validate.py against the skill directory. It checks that SKILL.md exists, the YAML frontmatter contains name and description, the name is hyphen-case under 64 characters, and the description has no angle brackets and stays under 1024 characters.

Skills should recommend DefaultAzureCredential for local development and a specific credential such as ManagedIdentityCredential or WorkloadIdentityCredential for production. Rust skills use DeveloperToolsCredential locally since Rust has no DefaultAzureCredential.

Run package_skill.py with the skill folder path and an optional output directory. It validates the skill first, then bundles all files into a zip-format .skill file named after the skill directory.

Split content into references/ files when SKILL.md approaches 500 lines or 5k words. Detailed API patterns, migration guides, and streaming documentation belong in references so the main body stays concise.