- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add microsoft/GitHub-Copilot-for-Azure --skill skill-authoring -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add microsoft/GitHub-Copilot-for-Azure --skill skill-authoring -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add microsoft/GitHub-Copilot-for-Azure --skill skill-authoring -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add microsoft/GitHub-Copilot-for-Azure --skill skill-authoring -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/microsoft/GitHub-Copilot-for-Azure/tree/HEAD/.github/skills/skill-authoringFrom the publisher
This skill provides guidance for writing Agent Skills that comply with the agentskills.io specification.
name: 1-64 chars, lowercase + hyphens, match directorydescription: 1-1024 chars, ≤60 words, explain WHAT and WHENWHEN: with quoted trigger phrases (preferred over USE FOR:)DO NOT USE FOR: unless the skill has trigger overlap with a broader skill (see frontmatter guidelines)>- folded scalars)SKILL.md (required) - Instructionsreferences/ (optional) - Detailed docsscripts/ (optional) - Executable codeFrontmatter: name (lowercase-hyphens), description (WHAT + WHEN)
Metadata (~100 tokens) loads at startup. SKILL.md (<5000 tokens) loads on activation. References load only when explicitly linked (not on activation). Keep SKILL.md lean.
References are JIT (just-in-time) loaded:
[text](references/file.md) load[Recipes](references/recipes/README.md) not [Recipes](references/recipes/)See REFERENCE-LOADING.md for details.
# Run from the scripts directory
cd scripts
npm run references # Validate all skill links
npm run tokens -- check # Check token limits
When reviewing or authoring skills, verify:
See Validation for detailed procedures.
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 ski
---name: skill-authoringdescription: Guidelines for writing Agent Skills that comply with the agentskills.io specification. WHEN: \"create a…---# .github/skills/skill-authoring/SKILL.mdOverview
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\".
FAQ
Download .github/skills/skill-authoring/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/microsoft/GitHub-Copilot-for-Azure.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.