Skip to content

Instantly share code, notes, and snippets.

@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.

@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-analysis.md
Created February 20, 2026 16:03
Condensed SDK Reference — Change Analysis & CI/CD Pipeline
@kvenkatrajan
kvenkatrajan / skill-description-analysis.md
Created February 26, 2026 00:12
Analysis: Why Azure skills invoke unreliably in Claude Sonnet vs Opus, and how to fix skill descriptions

Why Azure Skills Invoke Unreliably in Claude Sonnet vs Opus 4.6

Analysis of skill description patterns across 24 Azure skills, with concrete recommendations for improving invocation reliability on Sonnet.


5 Root Causes (in order of impact)

1. Description Length Overload

@kvenkatrajan
kvenkatrajan / ai-comms-plan.md
Last active March 5, 2026 01:04
AI Initiatives Communication Plan

AI Initiatives Communication Plan

Problem

AI initiatives across the org lack a unified communication mechanism, leading to siloed awareness and limited cross-team collaboration. Teams working on Copilot CLI, Copilot SDK, VSCode, and other AI efforts need a structured way to share updates, learnings, and collaborate.

Goals

  • Awareness: Keep all teams informed of AI progress, releases, and learnings
  • Collaboration: Drive cross-team contribution and reduce duplication
  • Discoverability: Make AI resources, investments, and knowledge easy to find
@kvenkatrajan
kvenkatrajan / agent-metadata-2026-02-24T23-29-53-049Z.md
Created March 5, 2026 21:31
Agent metadata: azure-deploy creates event-driven function app (Run #45)

Test comments

⚠️ azure-deploy skill was expected to be used but was not used. ⚠️ azure-validate skill was expected to be used but was not used. ⚠️ azure-prepare skill was expected to be used but was not used.

User Prompt

Create an event-driven function app to process messages and deploy to Azure Functions using my current subscription in eastus2 region.

@kvenkatrajan
kvenkatrajan / azure-agent-skills-ecosystem-analysis.md
Last active March 12, 2026 17:44
Azure Agent Skills Ecosystem: Three-Repo Analysis (githubcopilotforAzure vs microsoft/skills vs MicrosoftDocs/Agent-Skills)

Azure Agent Skills Ecosystem: Three-Repo Analysis (githubcopilotforAzure vs microsoft/skills vs MicrosoftDocs/Agent-Skills)

Azure Agent Skills Ecosystem: Three-Repo Analysis

Date: March 11, 2026 Scope: azure-skills | microsoft/skills | MicrosoftDocs/Agent-Skills Purpose: Strategic comparison, contribution flows, automation gaps, and convergence plan


@kvenkatrajan
kvenkatrajan / azure-skills-agent-skills-convergence.md
Last active March 11, 2026 14:16
azure-skills + MicrosoftDocs/Agent-Skills Convergence: Diagnostics & Troubleshooting Strategy

azure-skills + MicrosoftDocs/Agent-Skills Convergence: Diagnostics & Troubleshooting Strategy

azure-skills + MicrosoftDocs/Agent-Skills Convergence: Diagnostics & Troubleshooting

Date: March 11, 2026 Context: Should azure-skills reference MicrosoftDocs/Agent-Skills content? Should diagnostics be split into diagnostics + troubleshooting?


1. The Problem Today

@kvenkatrajan
kvenkatrajan / azure-skills-agent-skills-full-overlap-analysis.md
Created March 11, 2026 14:10
azure-skills + MicrosoftDocs/Agent-Skills: Full Overlap Analysis — Security, Cost, Monitoring, Storage, Compliance, Messaging, Deployment

azure-skills + MicrosoftDocs/Agent-Skills: Full Overlap Analysis

Date: March 11, 2026 Context: Beyond diagnostics/troubleshooting, where else do azure-skills and Agent-Skills overlap? What content from Agent-Skills should azure-skills reference?


1. Overlap Map Summary

There are 6 major overlap areas between azure-skills (24 operational skills) and MicrosoftDocs/Agent-Skills (193 service documentation skills):

@kvenkatrajan
kvenkatrajan / azure-prepare-progressive-disclosure.md
Created March 12, 2026 14:54
azure-prepare: Progressive Disclosure Flow — How recipes, runtimes, and service references are loaded on demand

azure-prepare: Progressive Disclosure Flow

Date: March 12, 2026 Scope: How azure-prepare uses recipes, runtimes, and service references through progressive disclosure Walkthrough prompt: "Create a Node.js Express API with Cosmos DB that I can deploy to Azure Container Apps"


1. What Is Progressive Disclosure in azure-prepare?