Skip to content

Add shared Copilot skills and skill development tooling#14285

Draft
ronniegeraghty wants to merge 8 commits intomainfrom
gimli/shared-copilot-skills
Draft

Add shared Copilot skills and skill development tooling#14285
ronniegeraghty wants to merge 8 commits intomainfrom
gimli/shared-copilot-skills

Conversation

@ronniegeraghty
Copy link
Member

@ronniegeraghty ronniegeraghty commented Mar 3, 2026

Adds shared Copilot skills to .github/skills/ per #14261.

Migrated from Azure/azure-rest-api-specs#40811.

Naming Convention

  • azsdk-common-* prefix — shared skills distributed to other Azure SDK repos
  • No prefix — internal meta-skills for skill writing and maintenance

Skills (8 total)

Shared Domain Skills (5) — azsdk-common-* prefix

Skill Path Description
azsdk-common-sdk-release .github/skills/azsdk-common-sdk-release/ Check SDK release readiness and trigger release pipeline
azsdk-common-prepare-release-plan .github/skills/azsdk-common-prepare-release-plan/ Create and manage release plan work items
azsdk-common-pipeline-troubleshooting .github/skills/azsdk-common-pipeline-troubleshooting/ Diagnose and resolve SDK CI pipeline failures
azsdk-common-apiview-feedback-resolution .github/skills/azsdk-common-apiview-feedback-resolution/ Retrieve and resolve APIView review feedback
azsdk-common-generate-sdk-locally .github/skills/azsdk-common-generate-sdk-locally/ Generate, build, and test SDKs locally from TypeSpec

Internal Meta-Skills (3) — no prefix

Skill Path Description
markdown-token-optimizer .github/skills/markdown-token-optimizer/ Analyze markdown files for token efficiency
sensei .github/skills/sensei/ Iteratively improve skill frontmatter compliance
skill-authoring .github/skills/skill-authoring/ Guidelines for writing Agent Skills per agentskills.io spec

What's Included

Each skill includes:

  • SKILL.md with waza-compliant frontmatter
  • eval.yaml evaluation config with valid waza grader types (text, code)
  • evals/ directory with eval.yaml, trigger_tests.yaml, and tasks/ (basic-trigger + anti-trigger)
  • tasks/ with eval scenarios (basic, edge, negative)
  • references/ and fixtures/ where applicable

CI Workflow

Added .github/workflows/skill-eval.yml for automated skill compliance and evaluation:

  • Skill Compliance Check — runs waza check on all skills, uploads compliance report
  • Run Skill Evaluations — runs waza run on all evals/eval.yaml, uploads results
  • Triggers on push to main, PRs, and manual dispatch (paths: .github/skills/**)

Skills Removed After Review

Per @praveenkuttappan's feedback, removed 7 skills that don't need standalone implementations:

  • validate-service-label — Daniel reworking labels with different approach
  • verify-setup — Single MCP tool call, fold into AGENTS.md or generate-sdk-locally
  • validate-codeowners — Wait for Daniel's codeowners project
  • typespec-to-sdk-workflow — Should be guidance in AGENTS.md, not standalone skill
  • check-package-validation — Single MCP tool call, fold into generate-sdk-locally
  • package-release-readiness — Redundant with sdk-release skill
  • azsdk-common-report-test-bug — User decided not needed as standalone skill

Excluded skills (not shared across repos):

  • TypeSpec authoring skill
  • Customizations skill

Closes #14261

Migrated from Azure/azure-rest-api-specs#40811 per #14261.
All shared skills prefixed with shared-.
Excluded: typespec authoring skill, customizations skill.

Skills added:
- shared-sdk-release
- shared-prepare-release-plan
- shared-pipeline-troubleshooting
- shared-apiview-feedback-resolution

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@azure-sdk
Copy link
Collaborator

The following pipelines have been queued for testing:
java - template
java - template - tests
js - template
net - template
net - template - tests
python - template
python - template - tests
You can sign off on the approval gate to test the release stage of each pipeline.
See eng/common workflow

ronniegeraghty and others added 7 commits March 5, 2026 03:09
- Move all 4 skill directories from eng/common/ to .github/skills/
- Rename directory prefix from shared- to azsdk-common-
- Update name: field in all SKILL.md frontmatter
- Update all internal cross-skill references

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add azsdk-common-markdown-token-optimizer skill
- Add azsdk-common-sensei skill
- Add azsdk-common-skill-authoring skill
- Create eval.yaml for each skill
- Add basic evaluation tasks
- Create .github/workflows/skill-eval.yml for automated testing

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Fix name: fields in 3 meta-skills to use azsdk-common- prefix
- Convert invalid keyword/regex grader types to text in all 7 eval.yaml files
- Add evals/ directory with trigger_tests.yaml for all 7 skills
- Replace workflow with spec-compliant version (compliance check + eval jobs)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The azsdk-common- prefix is reserved for skills shared across Azure SDK
repos. Meta-skills (sensei, skill-authoring, markdown-token-optimizer)
are internal tooling and keep their original names.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Added from azure-rest-api-specs commit 54d54fb with azsdk-common- prefix:
- azsdk-common-check-package-validation
- azsdk-common-generate-sdk-locally
- azsdk-common-package-release-readiness
- azsdk-common-report-test-bug
- azsdk-common-typespec-to-sdk-workflow
- azsdk-common-validate-codeowners
- azsdk-common-validate-service-label
- azsdk-common-verify-setup

Also added README.md, INSTRUCTION-TO-SKILL-MAPPING.md, .waza.yaml, .gitignore

All eval.yaml files use valid waza grader types (text, code).
Name fields updated to azsdk-common- prefix.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Removed skills that praveenkuttappan flagged as not needing standalone skills:
- validate-service-label (Daniel reworking labels)
- verify-setup (single MCP call, fold into AGENTS.md)
- validate-codeowners (wait for Daniel's codeowners project)
- typespec-to-sdk-workflow (belongs in AGENTS.md)
- check-package-validation (single MCP call, fold into generate-sdk-locally)
- package-release-readiness (redundant with sdk-release)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
User decided this skill is not needed as a standalone skill.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ronniegeraghty ronniegeraghty changed the title Add shared Copilot skills to eng/common/ Add shared Copilot skills and skill development tooling Mar 5, 2026
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.

Sync job for skills across all repos

2 participants