Relevant jobs
AI / Algorithm Engineer
Full-stack / Indie Developer
Product Manager
Content Creator / Social Media
skills-best-practicesmgechev/skills-best-practices
Provides actionable rules and checklists for writing high-quality agent skill files, solving the problem of vague descri…
No ratings yet
Rate this skill
Stars2.3k
Forks167
Watchers2.3k
Open Issues0
InstallOne-line install
UnconfirmedWhether this repository follows the Agent Skills spec (that is, whether it contains a SKILL.md) has not been verified yet. Until that is settled, clone it and use what you need:
git clone https://github.com/mgechev/skills-best-practices.git
OverviewOverview
Key Features
Provides actionable rules and checklists for writing high-quality agent skill files, solving the problem of vague descriptions, messy structure, and skills that agents fail to trigger correctly. Key capabilities include: 1. Specificity check: requires every skill statement to state its trigger condition and action, rejecting boilerplate that still reads fine after swapping the skill name; 2. Directory structure convention: references/ holds API docs and domain knowledge, scripts/ holds executable code for deterministic tasks, assets/ holds static resources, so each part of a skill package has a clear home; 3. Three-part description template: a fixed format of Key Features / Use Cases / Target Roles so skill intros can be searched and matched directly; 4. Self-check list: item-by-item checks to catch missing feature points and mismatches between Chinese and English versions before publishing.
Use Cases
writing new agent skill files, refactoring existing skill directories, reviewing skill descriptions submitted by a team, normalizing intros in bulk for a skill marketplace.
Target Roles
AI / Algorithm Engineer, Full-stack / Indie Developer, Product Manager (PM), Content Creator / Social Media Operator.
RatingUser ratings
Nobody has rated this skill yet. Yours would be the first on the site — your vote becomes the initial average.
RepositoryRepository
| Skill ID | 414 |
|---|---|
| Data source | GitHub |
| Repository | mgechev/skills-best-practices |
| Category | AI & Agent Development / Agent Skills & Prompt Engineering |
| Primary language | Python |
| License | Not specified |
| Default branch | main |
| GitHub repository ID | 1166020413 |
| Node ID | R_kgDORYAPPQ |
| Rank | #417 (position within the source ranking) |
| Site-wide popularity rank | #501 (computed live from Stars, across all 5845 entries) |
GrowthStar / Fork growth
One snapshot per day, tracking how Stars and Forks changed
- Now2,272
- Previous point · 09-29 2,268
- vs previous point +4
- 2 data points 12 days
- Now167
- Previous point · 09-29 166
- vs previous point +1
- 2 data points 12 days
TimelineTimeline
Repository created2026-02-24 19:47:388 months ago
Data last updated2026-10-26 11:57:5124 days ago
Last commit2026-07-27 16:27:513 months ago
CommitLatest commit
Committed by mgechev. Update Category: Routine Updates & Maintenance. Commit details: Update the skill creator. This update performs routine maintenance and minor adjustments.