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". Published by microsoft in GitHub-Copilot-for-Azure.
What is 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". Published by microsoft in GitHub-Copilot-for-Azure. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.
Automated repository signals based on public metadata such as recency, license, installation evidence, and adoption. These are not a security audit or endorsement.
Key capabilities
- Includes SKILL.md support
- Reusable instructions support
- Documentation
- Writing
- Documentation use cases
- Writing use cases
Technical details
- Install or run with Copy skill directory
When to use skill-authoring
- Use it for documentation.
- Use it for writing.
Built with
Editorial notes
Source
- Creator: microsoft
- Repository: microsoft/GitHub-Copilot-for-Azure
- Skill file: .github/skills/skill-authoring/SKILL.md
What it does
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".
Skill instructions
Skill Authoring Guide This skill provides guidance for writing Agent Skills that comply with the agentskills.io specification. When to Use - Creating a new skill for this repository - Reviewing a skill PR for compliance - Checking if an existing skill follows best practices - Understanding token budgets and progressive disclosure Constraints - name: 1-64 chars, lowercase + hyphens, match directory - description: 1-1024 chars, ≤60 words, explain WHAT and WHEN - Use WHEN: with quoted trigger phrases (preferred over USE FOR:) - Avoid DO NOT USE FOR: unless the skill has trigger overlap with a broader skill (see frontmatter guidelines) - Use inline double-quoted strings (not - folded scalars) - SKILL.md: <500 tokens (soft), <5000 (hard) - references/.md: <1000 tokens each Structure - SKILL.md (required) - Instructions - references/ (optional) - Detailed docs - scripts/ (optional) - Executable code Frontmatter: name (lowercase-hyphens), description (WHAT + WHEN) Progressive Disclosure Metad
Explore related resources
Frequently asked questions
What is skill-authoring?
skill-authoring is a open-source AI agent skill with Copy skill directory. Guidelines for writing Agent Skills that comply with the agentskills.io specification.
Who is skill-authoring best for?
skill-authoring is best for reusing agent instructions, scripts, and references, documentation workflows, writing workflows.
How do I install skill-authoring?
Install or run skill-authoring using Copy skill directory. Check skill-authoring for the latest setup command.
Is skill-authoring actively maintained?
skill-authoring may need a closer maintenance check before production use.
Auto-fetched from GitHub.
