Create skill-fixer agent to provide basic guidelines

[Fan Yang (fanyang-mono)]

Create skill-fixer agent to provide basic guidelines. Currently, it includes skill bumping rule.

[github-actions]

Details

# 🔍 Token Analysis Report

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts compare --base origin/main --head HEAD --markdown

fatal: path '.github/agents/skill-fixer.agent.md' exists on disk, but not in 'origin/main'

📊 Token Change Report

Comparing origin/main → HEAD

Summary

Metric	Value
📈 Total Change	+111 tokens (0%)
Before	0 tokens
After	111 tokens
Files Changed	1

Changed Files

File	Before	After	Change
.github/agents/skill-fixer.agent.md	-	111	+111

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts check --markdown

📊 Token Limit Check Report

Checked: 536 files
Exceeded: 70 files

⚠️ Files Exceeding Token Limits

File	Tokens	Limit	Over By
.github/skills/analyze-test-run/SKILL.md	2471	500	+1971
.github/skills/file-test-bug/SKILL.md	628	500	+128
.github/skills/sensei/README.md	3531	2000	+1531
.github/skills/sensei/SKILL.md	2796	500	+2296
.github/skills/sensei/references/EXAMPLES.md	3701	2000	+1701
.github/skills/sensei/references/LOOP.md	4181	2000	+2181
.github/skills/sensei/references/SCORING.md	3917	2000	+1917
.github/skills/skill-authoring/SKILL.md	817	500	+317
plugin/skills/appinsights-instrumentation/SKILL.md	908	500	+408
plugin/skills/azure-ai/SKILL.md	817	500	+317
plugin/skills/azure-aigateway/SKILL.md	1258	500	+758
plugin/skills/azure-aigateway/references/policies.md	2342	2000	+342
plugin/skills/azure-cloud-migrate/references/services/functions/lambda-to-functions.md	2600	2000	+600
plugin/skills/azure-cloud-migrate/references/services/functions/runtimes/javascript.md	2181	2000	+181
plugin/skills/azure-compliance/SKILL.md	1185	500	+685
plugin/skills/azure-compute/SKILL.md	755	500	+255
plugin/skills/azure-compute/workflows/vm-recommender/vm-recommender.md	2393	2000	+393
plugin/skills/azure-compute/workflows/vm-troubleshooter/references/cannot-connect-to-vm.md	7308	2000	+5308
plugin/skills/azure-cost/SKILL.md	1861	500	+1361
plugin/skills/azure-deploy/SKILL.md	1562	500	+1062
plugin/skills/azure-diagnostics/SKILL.md	1132	500	+632
plugin/skills/azure-diagnostics/aks-troubleshooting/networking.md	2147	2000	+147
plugin/skills/azure-diagnostics/aks-troubleshooting/node-issues.md	2003	2000	+3
plugin/skills/azure-enterprise-infra-planner/SKILL.md	991	500	+491
plugin/skills/azure-enterprise-infra-planner/references/constraints/compute-apps.md	2022	2000	+22
plugin/skills/azure-hosted-copilot-sdk/SKILL.md	608	500	+108
plugin/skills/azure-kubernetes/SKILL.md	2266	500	+1766
plugin/skills/azure-kusto/SKILL.md	2149	500	+1649
plugin/skills/azure-messaging/SKILL.md	967	500	+467
plugin/skills/azure-prepare/SKILL.md	2607	500	+2107
plugin/skills/azure-prepare/references/aspire.md	2991	2000	+991
plugin/skills/azure-prepare/references/plan-template.md	2559	2000	+559
plugin/skills/azure-prepare/references/recipes/azd/terraform.md	3012	2000	+1012
plugin/skills/azure-prepare/references/research.md	2076	2000	+76
plugin/skills/azure-prepare/references/resources-limits-quotas.md	3322	2000	+1322
plugin/skills/azure-prepare/references/security.md	2092	2000	+92
plugin/skills/azure-prepare/references/services/functions/bicep.md	3065	2000	+1065
plugin/skills/azure-prepare/references/services/functions/templates/SPEC-composable-templates.md	6187	2000	+4187
plugin/skills/azure-prepare/references/services/functions/templates/recipes/composition.md	4649	2000	+2649
plugin/skills/azure-prepare/references/services/functions/terraform.md	3358	2000	+1358
plugin/skills/azure-quotas/SKILL.md	3445	500	+2945
plugin/skills/azure-quotas/references/commands.md	2644	2000	+644
plugin/skills/azure-resource-lookup/SKILL.md	1288	500	+788
plugin/skills/azure-resource-visualizer/SKILL.md	2054	500	+1554
plugin/skills/azure-storage/SKILL.md	1180	500	+680
plugin/skills/azure-upgrade/SKILL.md	1001	500	+501
plugin/skills/azure-upgrade/references/services/functions/automation.md	3463	2000	+1463
plugin/skills/azure-upgrade/references/services/functions/consumption-to-flex.md	2773	2000	+773
plugin/skills/azure-validate/SKILL.md	906	500	+406
plugin/skills/entra-app-registration/SKILL.md	2067	500	+1567
plugin/skills/entra-app-registration/references/api-permissions.md	2545	2000	+545
plugin/skills/entra-app-registration/references/cli-commands.md	2211	2000	+211
plugin/skills/entra-app-registration/references/console-app-example.md	2752	2000	+752
plugin/skills/entra-app-registration/references/oauth-flows.md	2375	2000	+375
plugin/skills/microsoft-foundry/SKILL.md	2870	500	+2370
plugin/skills/microsoft-foundry/foundry-agent/create/create.md	3016	2000	+1016
plugin/skills/microsoft-foundry/foundry-agent/deploy/deploy.md	5511	2000	+3511
plugin/skills/microsoft-foundry/foundry-agent/eval-datasets/eval-datasets.md	2342	2000	+342
plugin/skills/microsoft-foundry/foundry-agent/eval-datasets/references/trace-to-dataset.md	4268	2000	+2268
plugin/skills/microsoft-foundry/foundry-agent/observe/observe.md	2547	2000	+547
plugin/skills/microsoft-foundry/foundry-agent/trace/references/kql-templates.md	2701	2000	+701
plugin/skills/microsoft-foundry/models/deploy-model/SKILL.md	1640	500	+1140
plugin/skills/microsoft-foundry/models/deploy-model/capacity/SKILL.md	1739	500	+1239
plugin/skills/microsoft-foundry/models/deploy-model/customize/SKILL.md	2235	500	+1735
plugin/skills/microsoft-foundry/models/deploy-model/customize/references/customize-workflow.md	3335	2000	+1335
plugin/skills/microsoft-foundry/models/deploy-model/preset/SKILL.md	1226	500	+726
plugin/skills/microsoft-foundry/models/deploy-model/preset/references/preset-workflow.md	5534	2000	+3534
plugin/skills/microsoft-foundry/quota/quota.md	2129	2000	+129
plugin/skills/microsoft-foundry/quota/references/capacity-planning.md	2029	2000	+29
plugin/skills/microsoft-foundry/references/sdk/foundry-sdk-py.md	2162	2000	+162

Consider moving content to references/ subdirectories.

---

Automated token analysis. See skill authoring guidelines for best practices.

[Copilot]

Pull request overview

Adds a new GitHub custom agent definition intended to guide contributors when fixing/updating skills, starting with a rule to bump the skill version in the same PR.

Changes:

• Introduces a new custom agent markdown file under .github/agents/.
• Adds initial guideline content for skill updates (version bump reminder).

Comments suppressed due to low confidence (3)

.github/agents/skill-fixer.agent.md:9

• name: and description: are left empty in the YAML frontmatter. This likely results in an invalid/unnamed custom agent config (and makes the agent hard to discover/use). Please fill these with concrete values (and consider adding a tools: list like the other agents in this repo so the agent can actually operate as intended).

name:
description:
---

.github/agents/skill-fixer.agent.md:12

• # My Agent looks like placeholder content and doesn’t reflect the purpose of this agent. Please rename the heading/body to match the agent’s role (e.g., “Skill Fixer Agent”) so the prompt is self-explanatory when viewed outside the repo context.

# My Agent

.github/agents/skill-fixer.agent.md:13

• The guideline “bump skill version” is ambiguous. In this repo, skill versions appear to live in metadata.version inside each plugin/skills/<skill>/SKILL.md; it would be clearer to explicitly reference that field and (optionally) the expected versioning scheme (e.g., SemVer) so contributors know exactly what to change.

When working on updating any skills in this repo, make sure to bump skill version in the same PR.

[Copilot]

The file still contains the scaffold/template instructions in the frontmatter block. Once name/description are set, consider removing these template comments to keep the agent definition concise and avoid shipping repo-internal setup notes as part of the agent prompt.

This issue also appears in the following locations of the same file:

• line 6
• line 11
• line 13

Suggested change

	# Fill in the fields below to create a basic custom agent for your repository.
	# The Copilot CLI can be used for local testing: https://gh.io/customagents/cli
	# To make this agent available, merge this file into the default repository branch.
	# For format details, see: https://gh.io/customagents/config
	name:
	description:
	name: skill-fixer
	description: Assist with updating skills in this repo and ensure skill versions are bumped in the same PR.

[Copilot]

File naming in .github/agents/ is currently PascalCase (e.g., SkillCreator.agent.md, SkillBrainstormer.agent.md). For consistency/discoverability, consider renaming skill-fixer.agent.md to match that pattern (e.g., SkillFixer.agent.md).