mgechev/skills-best-practices resource

Health v2 · maintenance only

Flags: no_releases no_license

Adoption not part of the score

2237 stars · 166 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A guide and reference repository of best practices for writing professional-grade agent skills (SKILL.md files) for LLM agents like Claude. It covers skill directory structure, frontmatter optimization for discoverability, and progressive disclosure to keep the agent's context window lean.

Use cases

• how to write agent skills for claude
• best practices for SKILL.md files
• optimize skill descriptions for agent triggering
• keep agent context window lean with progressive disclosure
• structure a skill with scripts references and assets
• validate agent skills with LLMs
• naming conventions for skill frontmatter

When to choose

• you are authoring or maintaining skills for Claude or similar LLM agents
• you want a concise, opinionated checklist for skill structure and discoverability
• your skills load too much context and you need progressive-disclosure patterns

When to avoid

• you need comprehensive official documentation rather than a concentrated guide
• you are building agent frameworks or runtimes rather than writing skills
• you need a tool that grades skills - use the companion skillgrade repo instead

Facets

learning-resource · maturity active

documentation prompt-engineering agent-framework developer-tools artificial-intelligence developer-tools tutorials documentation python cli cross-platform agent-skills claude-skills best-practices context-window llm-validation skill-authoring ai-agents

Member repositories

For agents

markdown · JSON · MCP: product_card(name="mgechev/skills-best-practices")