Azure-Skills Plugin: Docs Site, README, Claude Plugin Directory, and skills.sh Strategy

[spboyer]

Overview

The azure-skills plugin (18 sub-skills for Azure infrastructure management) is merged and syncing from microsoft/github-copilot-for-azure. It needs visibility updates across the README, GitHub Pages site, and Claude Code's official plugin directory.

Current State

• ✅ Plugin exists at .github/plugins/azure-skills/ with 18 sub-skills
• ✅ marketplace.json lists azure-skills alongside deep-wiki
• ✅ Automated sync PRs from microsoft/github-copilot-for-azure
• ✅ .claude-plugin/plugin.json and .mcp.json are in place
• ❌ README Plugins section only lists deep-wiki
• ❌ GitHub Pages site has no azure-skills install card/modal
• ❌ Plugin not submitted to Anthropic's official Claude plugin directory
• ❌ plugin.json homepage points to upstream repo instead of distribution path

Tasks

• Add azure-skills to README Plugins section -- Add to Plugins table with install command (/plugin install azure@skills). Currently only deep-wiki is listed.
• Add azure-skills plugin card + modal to GitHub Pages -- Add card button and install modal to docs-site/src/pages/index.astro (same pattern as deep-wiki). Include install instructions and list of 18 sub-skills.
• Rebuild docs site and deploy -- Run npm run build in docs-site/, commit output to docs/. GitHub Pages workflow deploys from docs/.
• Fix stale skill counts in README -- '125 Skills' in What's Inside and '131 skills' in catalog header are outdated. Update to actual count.
• Fix plugin.json homepage + add missing fields -- Update homepage in plugin.json and both marketplace.json files from microsoft/github-copilot-for-azure to https://github.com/microsoft/skills/tree/main/.github/plugins/azure-skills. Add missing repository and license fields. Pattern: homepage -> this repo (distribution), repository -> upstream source repo (attribution).
• Submit azure-skills to anthropics/claude-plugins-official -- Submit via the plugin directory submission form. No Microsoft/Azure plugin exists in the directory yet (current externals: asana, context7, firebase, github, gitlab, etc.). Plugin structure already matches requirements.

skills.sh Strategy (Decision Made)

The azure-skills plugin's 18 sub-skills will not be submitted to skills.sh. The two mechanisms serve different purposes:

• npx skills add = copy individual SKILL.md files (for the 133 SDK skills in .github/skills/)
• /plugin install = install curated plugin with MCP servers, agents, and commands (for azure-skills)

Mixing them would be confusing. The 133 SDK skills remain on skills.sh; the azure-skills plugin is distributed via Copilot CLI plugin system and Claude plugin directory.

Files to Change

File	Change
README.md	Add azure-skills to Plugins table, fix skill counts
docs-site/src/pages/index.astro	Add azure-skills plugin card + install modal
docs/	Rebuilt site output
.github/plugins/azure-skills/.claude-plugin/plugin.json	Fix homepage, add repository/license
marketplace.json	Fix homepage URL
.github/plugin/marketplace.json	Fix homepage URL

[spboyer]

FYI @thegovind — we're planning to submit azure-skills to the Anthropic Claude plugins official directory as an external plugin. The plugin structure is already in place. Also updating the docs site and README to give azure-skills proper visibility alongside deep-wiki.

[spboyer]

@JasonYeMSFT , @kvenkatrajan - FYI, these are some tasks here to get this complete.