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.
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
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
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
- https://github.com/mgechev/skills-best-practices Project page · Linked repository · Research reference
- https://github.com/mgechev/skills-best-practices/blob/main/README.md Research reference
- https://github.com/stars/angelcervera/lists/ai Research reference
Research metadata
- Research date
- 2026-09-16
- Catalogue snapshot
- 2026-10-06