Favicon of skill-authoring

skill-authoring

AI Agent SkillTypeScriptOpen source

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.

Decision snapshot

Is this a fit?

Best for

Documentation, Writing, Includes SKILL.md, Reusable instructions

Works with

Compatibility not yet detected.

Access

Permission behavior not yet detected.

Setup

Copy skill directory

Project health

2 months ago · NOASSERTION license

Considerations

No specific cautions were detected. Review the source and requested permissions before installing.

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.

Trust signal
95/100
Maintenance signal
90/100
Adoption signal
59/100

Automated repository signals based on public metadata such as recency, license, installation evidence, and adoption. These are not a security audit or endorsement. See how SkillIndex evaluates profiles.

Key capabilities

  • Includes SKILL.md support
  • Reusable instructions support
  • Documentation
  • Writing
  • Documentation use cases
  • Writing use cases

Declared skill metadata

  • Declared author: Microsoft
  • Declared license: MIT
  • Source file: .github/skills/skill-authoring/SKILL.md

These fields retain source and confidence evidence from the indexed SKILL.md.

Compatibility and setup

Copy skill directory
  • Install or run with Copy skill directory

When to use skill-authoring

  • Use it for documentation.
  • Use it for writing.

Built with

TypeScriptCopy skill directory

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

Verified compatibility and discovery

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.

Share:

Stars
232
Forks
183
Last commit
2 months ago
Last verified
Aug 30, 2026
Metadata fetched
Aug 30, 2026
Repository age
2 years
License
NOASSERTION

Project health auto-fetched from the source repository.

Maintain this resource?

Review this source-backed profile, send a correction with evidence, or link to it from your documentation. Claims verify your relationship to the project; profile facts still require source evidence and editorial review.

Alternatives to skill-authoring