Skip to content

Remove "When to Use" sections from skill content#1548

Draft
Copilot wants to merge 2 commits intomainfrom
copilot/fix-skill-content-mentioning-when-to-use
Draft

Remove "When to Use" sections from skill content#1548
Copilot wants to merge 2 commits intomainfrom
copilot/fix-skill-content-mentioning-when-to-use

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 27, 2026

Skill invocation depends solely on the frontmatter description field. ## When to Use This Skill sections in skill content bodies are redundant with the description and add unnecessary tokens.

Changes

Skill authoring guidelines

  • Removed When to Use This Skill from the Required Sections list in .github/instructions/skill-files.instructions.md

SKILL.md files (12 files) — removed ## When to Use This Skill / ## Skill Activation Triggers sections:

  • azure-compliance, azure-kubernetes, azure-compute, azure-aigateway, azure-cost-optimization, azure-enterprise-infra-planner, appinsights-instrumentation, azure-resource-lookup, azure-quotas, azure-messaging
  • microsoft-foundry/models/deploy-model/customize — section removed; Comparison: customize vs preset table preserved under its own heading
  • microsoft-foundry/models/deploy-model/capacity

Reference/workflow files (11 files) — same removal applied to non-SKILL.md content that followed the same pattern:

  • vm-recommender.md, create.md (foundry-agent), deploy.md, create-foundry-resource.md, trace.md, troubleshoot.md, invoke.md, eval-datasets.md, observe.md, aks-troubleshooting.md, rbac.md
  • Warning/tip callouts that followed these sections (e.g., ⚠️ DO NOT manually call...) are preserved in place

Unit tests — updated assertions in 11 test files to remove checks for the deleted sections; a few tests updated to assert on equivalent content that remains (e.g., policy category table references instead of governance category labels that only existed in the removed sections)

Version bumps on all modified SKILL.md files per authoring conventions.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • centralus-2.in.applicationinsights.azure.com
    • Triggering command: /home/REDACTED/.npm/_npx/6027471c64e54353/node_modules/@azure/mcp-linux-x64/dist/azmcp /home/REDACTED/.npm/_npx/6027471c64e54353/node_modules/@azure/mcp-linux-x64/dist/azmcp server start git /.bin/npx ning-when-to-use --global /home/REDACTED/.cargo/bin/git -cost-optimizatiwatchman (dns block)
  • https://api.github.com/copilot_internal/user
    • Triggering command: /opt/hostedtoolcache/node/24.14.0/x64/bin/node /opt/hostedtoolcache/node/24.14.0/x64/bin/node /home/REDACTED/work/GitHub-Copilot-for-Azure/GitHub-Copilot-for-Azure/tests/node_modules/@github/copilot/index.js --yolo --headless --no-auto-update --log-level error --stdio (http block)

If you need me to access, download, or install something from one of these locations, you can either:


📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.

Copilot AI changed the title [WIP] Fix skill content to remove usage guidelines Remove "When to Use" sections from skill content Mar 27, 2026
Copilot AI requested a review from kvenkatrajan March 27, 2026 19:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Some skill content mentions when to use the skill

2 participants