skill-authoring

Guidelines for writing Agent Skills that comply with the agentskills.io specification. WHEN: "create a skill", "new skill", "write a skill", "skill template", "skill structure", "review skill", "skill PR", "skill compliance", "SKILL.md format", "skill frontmatter", "skill best practices".

1.35x

Quality

88%

Does it follow best practices?

Impact

100%

1.35x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Evaluation results

100%

21%

New Skill: Azure Policy Compliance Checker

Frontmatter compliance

Criteria

Without context

With context

Name format

100%

Name matches directory

100%

Name not reserved prefix

100%

Name no leading/trailing hyphen

100%

Description word count

100%

WHEN: trigger phrases

100%

No DO NOT USE FOR

100%

Inline string format

50%

100%

No XML angle brackets

100%

Action-oriented workflow

100%

57%

Fix Skill Reference Structure

Reference file structure

Criteria

Without context

With context

File links not folder links

100%

Descriptive link text

100%

Large reference split

100%

Split folder has README entry point

100%

No orphaned references

100%

Duplicate authentication content consolidated

100%

SKILL.md links updated

50%

100%

All linked files present

100%

advanced-config.md preserved

100%

References one level deep

100%

Improve Skill Content Quality

Content quality and progressive disclosure

Criteria

Without context

With context

No decorative emojis

100%

Numbered action-oriented steps

100%

Configuration options as table

100%

Azure SQL guidance extracted

100%

Service-specific reference file

100%

Detail moved to references

100%

References linked from SKILL.md

100%

Registries as table

100%

No verbose welcome prose

100%

No path-as-text links

100%

Repository: microsoft/github-copilot-for-azure
Commit: 1f4304b

Evaluated: 19 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

New Skill: Azure Policy Compliance Checker Fix Skill Reference Structure Improve Skill Content Quality

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.