← Browse tools

Reference resources

Skills Best Practices

A practical guide to authoring, evaluating and maintaining agent skills, with emphasis on discoverability, progressive disclosure and reliable supporting scripts.

2,254 stars

Overview

Research summary

Skills Best Practices explains how to structure agent instructions so that a client can discover the right skill and load only the context needed for a task. It discusses SKILL.md metadata, separation of references and scripts, error handling, evaluation, and iterative refinement with representative scenarios. The repository is primarily a guide and supporting examples rather than a complete skills package manager or agent execution framework.

Its recommendations are useful inputs to a team’s authoring process, but individual client requirements should still be checked against the specification and implementation in use. Suggested evaluation practices do not establish that every resulting skill is reliable without actual testing. No repository-wide license was verified in the reviewed snapshot, so the catalog explicitly leaves licensing unknown instead of equating public availability with permission to redistribute the material.

Repository summary

Stars
2,254
Open issues
Unavailable
Last push
2026-07-27
Commits, 90 days
Unavailable
Repository activity
Not scored
Version
Unavailable

Recorded catalogue figures. View repository data and provenance →

Classification

Pricing & services

Paid services unknown

Whether the provider offers paid products or services has not been established.

Licence scope

Unknown licence

No repository-wide license was verified in the reviewed snapshot.

Implementation

Recorded implementation details and interfaces for Skills Best Practices.

Implementation details

Markdown authoring guide with Python-related examples

Languages
Markdown
Repository type
reference

Recorded interfaces and capabilities

Licence scope

Unknown licence

No repository-wide license was verified in the reviewed snapshot.

Repository

Repository snapshots, release information and recorded maintenance signals.

Repository snapshot

mgechev/skills-best-practices ↗

Stars
2,254
Open issues
Unavailable
Last push
2026-07-27
Commits, 90 days
Unavailable
Repository activity
Not scored
Archived
Not recorded

Repository activity is a snapshot, not a quality or popularity ranking. It combines recent-push freshness (50%), 90-day commits (30%) and issue pressure (20%).

Maintenance and provenance

Catalogue snapshot
2026-10-06
Stars source
Recorded fallback
Last push source
Recorded fallback

Documentation

Recorded references and research provenance for this entry.

Recorded sources 3

Research metadata

Research date
2026-09-16
Catalogue snapshot
2026-10-06