SkillPedia Skills Encyclopedia
中文 EN

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

Unconfirmed

Whether 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.

Rate this skill

Fill it in to be included in the per-role averages below.

One vote per IP,and it cannot be changed after submitting, so choose carefully the first time. No account is collected and no sign-in is required.

RepositoryRepository

Skill ID414
Data sourceGitHub
Repositorymgechev/skills-best-practices
CategoryAI & Agent Development / Agent Skills & Prompt Engineering
Primary languagePython
LicenseNot specified
Default branchmain
GitHub repository ID1166020413
Node IDR_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

01k2k3k2026-09-292026-10-112026-09-29 · 2,2682026-10-11 · 2,272
  • Now2,272
  • Previous point · 09-29 2,268
  • vs previous point +4
  • 2 data points 12 days
0501001502002026-09-292026-10-112026-09-29 · 1662026-10-11 · 167
  • 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.

a0bfa56 mgechev 2026-07-27