←Leaderboard/Skill Creation/skills-best-practices
Last commit on July 27, 2026·Created on February 24, 2026

mgechev/skills-best-practices

“A structured framework for authoring agent skills that adhere to the agentskills.io specification.”
Combined rank
#208
across all skills
In Skill Creation
#9
category rank
Stars
2.3k
+0.2% in last 7d
Forks
167
0.0% in last 7d
Watchers
12
0.0% in last 7d
Traction scoreGitHub stars can be faked, so popularity alone can be misleading. Traction Score looks for broader signs of recent attention, adoption, and active maintenance.
TL;DR

This skill provides a procedural guide for creating professional-grade agent skills. It focuses on the precise initialization of metadata and the application of progressive disclosure principles to ensure skills are discoverable and functional.

It is designed for developers building new skill directories who need to validate naming conventions and draft clear usage triggers.

WHO IT'S FOR
AI agent / automation builders
authoring professional-grade skills for agents
AI workflow designers
drafting procedural instructions for AI agents
Platform / DevEx teams
standardizing agent skill metadata and structure
Technical leads / architects
optimizing agent context windows and discoverability
Repository contents

1 skill file

Compatible AgentsThe repository documents support for these agents. The skills may also work with other agents that can load SKILL.md files, but they may need some setup or small changes.

Use this skill

Follow the documented setup, then try a first task.

See the repository for installation instructions.

Open repository instructions ↗

Give it something to do.

Suggested first task

Review an existing skill's instructions

Uses skill-creator

  • The existing SKILL.md to review.
  • Related supporting files or a directory listing, so referenced paths can be checked.

Make sure skill-creator is installed in your agent before trying this task.

Use skill-creator to review the SKILL.md I provide. Identify ambiguous steps that force an agent to guess, inconsistent terminology, and file paths that should be relative. Propose concrete edits to the most important issues. If the file exceeds 500 lines, recommend which procedural content to move into flat references files and where to add instructions to read those files when needed.
skill/SKILL.md ↗ · Checked Oct 18, 2026