Agent Skills Format War (2026): .agents vs .skills vs .md

Published: August 8, 2026 | Updated: August 8, 2026 | Category: AI Developer Tools

The Format War That Defines AI Coding's Future

Three competing standards. Billions of dollars at stake. Only one can win.

August 2026 will be remembered as the month the agent skills format war went supernova. In a single week, mattpocock/skills exploded from 4,567 stars to 209,774 stars, Google officially launched google/skills at 16,592 stars, and the community .md format (superpowers) reached 269,041 stars. The question every AI developer is asking: which format should I use?

This is not just a comparison — this is the most important infrastructure decision in AI coding today. The format you choose determines which IDEs, which agent harnesses, which workflows your skills are compatible with. Get it wrong, and you're locked into a dying ecosystem.

The Three Contenders

.agents Directory .agents

Leader: mattpocock/skills (209,774 stars)

Origin: Anthropic's original .agents directory convention

Format: Shell scripts / Markdown in a .agents/ directory

Adoption: Claude Code, Kiro, Cursor, Cline

Vibe: "Skills for Real Engineers" — minimal, pragmatic, works in any terminal

.skills Directory .skills

Leader: google/skills (16,592 stars)

Origin: Google's official Agent Skills for Google products

Format: Python / YAML — structured, typed, validated

Adoption: Google Cloud, Vertex AI, Gemini ecosystem

Vibe: "Enterprise-grade" — designed for Google Cloud customers

.md / Community Format .md

Leader: obra/superpowers (269,041 stars)

Origin: Community-driven, SKILL.md in any directory

Format: Markdown — human-readable, git-friendly

Adoption: Superpowers harness, addyosmani/agent-skills (84,372 stars), reverse-skill (21,051 stars)

Vibe: "Open standard" — flexible, composable, community-owned

Full Rankings

As of August 8, 2026 (18:00 UTC). Data sourced from GitHub API.

RankFrameworkStarsFormatGrowthBest For
1obra/superpowers269,041.md+3,444/weekAgentic skills framework, full harness
2mattpocock/skills209,774.agents+1,354/day.agents standard, real engineers
3addyosmani/agent-skills84,372.md+778/dayProduction-grade engineering skills
4google/skills16,592.skills+718/weekGoogle Cloud + Vertex AI integration
5zhaoxuya520/reverse-skill21,051.md+10,400/weekSecurity / reverse engineering skill routing
6anthropics/skills~5,000.agentsStableOriginal .agents convention
7microsoft/skill-recorder969.ardStableSkill recording and verification
8KKKKhazix/human-writing1,947.mdGrowingChinese writing skills for AI
9Binaryify/open-kimi-ppt-skill1,589.mdGrowingAI presentation skills
10virgiliojr94/book-to-skill18,784.md+3,957/weekBook-to-skill conversion

Not sure which format to choose?

Answer 3 quick questions and get your personalized format recommendation.

Take the Format Quiz

Format Comparison: Head to Head

Metric.agents (mattpocock).skills (Google).md (Superpowers)
Total Ecosystem Stars~214,774~16,592~373,236
Weekly Growth+205,207+718+3,444
Corporate BackingAnthropicGoogleCommunity (no single backer)
File FormatShell scripts + MarkdownPython + YAMLPlain Markdown
Learnning CurveLow (shell basics)Medium (Python/YAML)Lowest (Markdown)
IDE SupportCursor, Cline, KiroGoogle IDX, VS CodeAny IDE
Agent Harness SupportClaude Code, Kiro, CursorVertex AI, GeminiSuperpowers, any
ValidationNone (convention only)Structured + typedNone (human-readable)
Enterprise ReadinessMediumHigh (Google Cloud)Medium (community-driven)

Our Verdict

There is no single winner yet — and that's the most impotant finding. The format war is still in its early innings.

Predictions for 2026-2027

  1. Convergence is inevitable — All major agent harnesses will support all three formats within 6 months.
  2. Google will open-source the .skills validator — Making their format more attractive to the community.
  3. .agents will become the "default" format — Like .gitignore before it. Every project will have a .agents directory.
  4. The real war will be about skill marketplaces — Once formats standardize, the value moves to curation and discovery.
  5. Skill recording and verification will become essential — Microsoft's kill-recorder is early but points to a future of certified kills.

Find Your Format

Take the Quiz

Related Comparisons

Disclosure: Some links are affiliate links. We may earn a commission at no extra cost to you.

💡 Vast.ai recommendation: Rent gpu instances at the lowest prices on the market. Try Vast.ai →

Affiliate disclosure: we may earn a commission if you sign up via this link, at no extra cost to you.

💡 DigitalOcean recommendation: Simple cloud droplets, kubernetes, and app platform. Try DigitalOcean →

Affiliate disclosure: we may earn a commission if you sign up via this link, at no extra cost to you.