{"adoption": {"forks": 166, "observed_at": "2026-08-28T04:06:29.387937+00:00", "stars": 2237}, "canonical_url": "https://ross.abutalabs.com/products/skills-best-practices", "card": {"archived": false, "artifact_type": "learning-resource", "description": "Write professional-grade skills for agents, validate them using LLMs, and maintain a lean context window.", "domain": ["artificial-intelligence", "developer-tools", "tutorials", "documentation"], "enriched": true, "function": ["documentation", "prompt-engineering", "agent-framework", "developer-tools"], "health_score": 77, "homepage": null, "language": "Python", "license": null, "license_family": "other", "maturity": "active", "member_repos": ["mgechev/skills-best-practices"], "name": "mgechev/skills-best-practices", "platform": ["python", "cli", "cross-platform"], "pushed_at": "2026-07-27T16:27:51+00:00", "repo": "mgechev/skills-best-practices", "stars": 2237, "tags": ["agent-skills", "claude-skills", "best-practices", "context-window", "llm-validation", "skill-authoring", "ai-agents"], "topics": [], "urls": [], "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"], "what_it_is": "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.", "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"], "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"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/skills-best-practices", "repo": "mgechev/skills-best-practices", "role": "main", "score": 57}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:06:29.387937+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T02:44:15.919955+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1ba82c4fbb7e9511e5671e05bfb49baf9ffbbdf22beaf745446f107ab64cad33", "fetched_at": "2026-08-28T04:06:29.387937+00:00", "kind": "readme", "missing": false, "url": "https://github.com/mgechev/skills-best-practices"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 94, "longevity": 13, "rhythm": 35}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["no_releases", "no_license"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 190, "days_push": 37, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 57, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}