Projekt pochází od Addyho Osmaniho, Engineering Leadera v Google s 25 lety zkušeností v oblasti softwarového inženýrství. Osmani se dlouhodobě věnuje tématu AI-assisted developmentu — přednáší o něm, píše knihy (O'Reilly: Beyond Vibe Coding) a na svém blogu a Substack newsletteru Elevate pravidelně popisuje reálné zkušenosti s nástroji jako Claude Code nebo Cursor. Agent Skills je open-source projekt pod MIT licencí.
AI coding agenti mají jeden zásadní problém: vždy hledají nejkratší cestu. Přeskočí testy, vynechají code review, ignorují security checklist. Agent Skills tento problém řeší tím, že agentovi poskytuje strukturované pracovní postupy pro každou fázi vývoje — od definice specifikace až po nasazení. Jde o kurátorskou kolekci skills, které kódují workflows, quality gates a best practices, které používají senior inženýři ve špičkových firmách při vývoji webových aplikací — zabalené tak, aby je AI coding agenti mohli konzistentně dodržovat. Projekt obsahuje 19 skills rozdělených do 6 fází: Define, Plan, Build, Verify, Review, Ship. Každá skill je Markdown soubor (SKILL.md) s konkrétními kroky, verifikačními body a exit kritérii. Součástí jsou také 3 specializované agent persony: code-reviewer, test-engineer a security-auditor. Skills fungují s Claude Code, Cursorem, Windsurf, GitHub Copilotem i Gemini CLI — každý SKILL.md lze jednoduše vložit do systémového promptu nebo do pravidel daného nástroje.
Kontext pro vznik projektu je jasný. Průzkumná data ukazují, že jen 48 % developerů konzistentně kontroluje AI-generovaný kód před commitem, přestože 38 % z nich uvádí, že review AI kódu vyžaduje více úsilí než review kódu psaného člověkem. Zároveň platí, že čím více informací je v context window, tím hůře se model soustředí na to, co je důležité právě teď — přidání strategických poznámek projektového manažera do kontextu, který se snaží opravit CSS bug, aktivně snižuje výkon modelu. Agent Skills na to reaguje principem progressive disclosure: skills se načítají selektivně podle aktuální fáze práce, ne všechny najednou. Každá skill navíc obsahuje tabulku běžných výmluv, které agenti používají k přeskočení kroků (např. „Testy přidám později"), spolu s dokumentovanými protiargumenty — projekt tomu říká anti-rationalization.
| Fáze | Příklady skills |
|---|---|
| Define | idea-refine, spec-driven-development |
| Plan | planning-and-task-breakdown |
| Build | incremental-implementation, context-engineering, frontend-ui-engineering |
| Verify | test-driven-development, browser-testing-with-devtools |
| Review | code-review-and-quality, security-and-hardening |
| Ship | git-workflow-and-versioning, ci-cd-and-automation, shipping-and-launch |
Zdroje:
- https://github.com/addyosmani/agent-skills
- https://addyo.substack.com/p/the-80-problem-in-agentic-coding
- https://addyosmani.com/blog/claude-code-agent-teams/
- https://beyond.addy.ie/
