Skip to content

Instantly share code, notes, and snippets.

@kvenkatrajan
kvenkatrajan / condensed-sdk-references-analysis.md
Created February 20, 2026 16:03
Condensed SDK Reference — Change Analysis & CI/CD Pipeline
@kvenkatrajan
kvenkatrajan / plugin-rollup-proposal.md
Last active February 19, 2026 16:57
Plugin Rollup Proposal for microsoft/skills

Plugin Rollup for the Entire Repo

Proposal to reorganize 133 flat skills in microsoft/skills into curated plugin bundles for improved discoverability and install experience.


Problem

The current structure places all 133 skills in a single .github/skills/ directory. When users run npx skills add microsoft/skills, every skill appears in one flat list — a Python developer scrolls past Java, Rust, and .NET skills they will never use. Discovery is poor, installation is all-or-nothing, and the list will only grow.

@kvenkatrajan
kvenkatrajan / condensed-sdk-references-gist.md
Last active February 12, 2026 13:21
Condensed SDK Reference Addition Strategy: microsoft/skills → plugin skills (84 files, 12 consumer skills)

Condensed SDK Reference Addition to Azure Skills

Strategy for adding SDK references from microsoft/skills into plugin skills using the Hybrid Inline approach.


1. Problem

Skills are sandboxed — a skill's SKILL.md can only reference files within its own folder tree. Cross-skill file references do not work per the agentskills.io specification. Plugin skills (e.g., azure-storage, azure-ai) need SDK code patterns from microsoft/skills source skills (e.g., azure-storage-blob-py, azure-search-documents-ts) but cannot link to them directly.