# ๐ฏ Awesome Agent Skills [](https://awesome.re)
## ๐ก What Are Agent Skills?
**Agent Skills** mark a fundamental shift from monolithic AI systems to composable agent architectures. Rather than embedding capabilities through expensive fine-tuning or bloating context windows with static documentation, skills provide **modular, on-demand knowledge injection** through standardized `SKILL.md` packages.
### The Architecture
**Progressive Disclosure at Scale**: Skills leverage a three-tier context management strategy:
1. **Discovery** (~50 tokens): Lightweight metadata (name + description) loads at startup
2. **Activation** (~2-5K tokens): Full `SKILL.md` instructions load when task-relevant
3. **Execution**: Referenced scripts and resources accessed dynamically
This architecture delivers:
- ๐ง **Infinite capability scaling** - No context window trade-offs
- โก **Sub-second skill loading** - Zero startup latency penalty
- ๐ **Cross-platform portability** - Write once, deploy to any compatible agent
- ๐ฆ **Frictionless distribution** - Share via Git, install like packages
### The Revolution
**From specialized agents to universal platforms**: Instead of building separate coding agents, research agents, and analysis agents, the industry is converging on **general-purpose agents with skill libraries**. One agent. Unlimited specializations. Dynamic composition.
> "We used to think agents in different domains will look very different. The agent underneath is actually more universal than we thought."
> โ *Barry Zhang, Anthropic Research*
**The open standard advantage**: Major platforms (OpenAI, GitHub, Microsoft, Cursor) have adopted the Agent Skills specification, creating **network effects**: every skill you create works across the entire ecosystem. This is the npm moment for AI agents.
### ๐ท๏ธ Key Topics
`agent-skills` ยท `ai-agents` ยท `llm` ยท `claude` ยท `anthropic` ยท `skill-md` ยท `progressive-disclosure` ยท `context-management` ยท `ai-development` ยท `mcp` ยท `agent-architecture` ยท `agentic-ai` ยท `automation` ยท `productivity`
๐ **New to Agent Skills?** Start here: [agentskills.io](https://agentskills.io)
## ๐ What's Inside?
- [๐ Ready-to-Use Skills](#-ready-to-use-skills) - Start building with production-ready skill libraries
- [๐ ๏ธ Tools & Platforms](#๏ธ-tools--platforms) - Leverage platforms with native Agent Skills support
- [๐ Learn & Explore](#-learn--explore) - Master the concepts through deep-dive articles
- [๐ฌ Videos & Tutorials](#-videos--tutorials) - Watch experts build real-world agent systems
- [๐ฌ Research Papers](#-research-papers) - Understand the science behind agent capabilities
- [โ Frequently Asked Questions](#-frequently-asked-questions) - Get answers to common questions
- [๐ฌ Join the Community](#-join-the-community) - Connect with pioneers shaping the ecosystem
- [๐ค Contributing](#-contributing) - Help shape the future of agent development
## ๐ Ready-to-Use Skills
**Don't build from scratch - stand on the shoulders of giants.** Tap into battle-tested skill libraries and specialized capabilities that power production agent systems today.
### ๐ Skills Collections & Repositories
**Multi-skill repositories** with diverse capabilities:
- [anthropics/skills](https://github.com/anthropics/skills) - ๐ข Official collection from Anthropic (document editing, data analysis, etc.)
- [karanb192/awesome-claude-skills](https://github.com/karanb192/awesome-claude-skills) - โญ 50+ verified skills for Claude Code and Claude.ai
- [shajith003/awesome-claude-skills](https://github.com/shajith003/awesome-claude-skills) - ๐ฏ Skills for specialized capabilities
- [ponderous-dustiness314/awesome-claude-skills](https://github.com/ponderous-dustiness314/awesome-claude-skills) - ๐ Document editing, data analysis, and project management
- [jacintarefined358/awesome-claude-skills](https://github.com/jacintarefined358/awesome-claude-skills) - โจ Productivity-focused skills
- [lifegenieai/claude-skills](https://github.com/lifegenieai/claude-skills) - ๐จ Voice AI, image generation, and web development
- [hikanner/agent-skills](https://github.com/hikanner/agent-skills) - ๐๏ธ Curated Claude Agent Skills collection
- [GuDaStudio/skills](https://github.com/GuDaStudio/skills) - ๐ค Multi-agent collaboration skills
- [OmidZamani/dspy-skills](https://github.com/OmidZamani/dspy-skills) - ๐ฎ Skills for DSPy framework
- [gradion-ai/freeact-skills](https://github.com/gradion-ai/freeact-skills) - ๐ฌ Freeact agent library skills
- [DougTrajano/pydantic-ai-skills](https://github.com/DougTrajano/pydantic-ai-skills) - ๐ Pydantic AI integration
### ๐ฏ Individual Skills by Category
#### ๐ป Development & Programming
- [kylehughes/the-unofficial-swift-programming-language-skill](https://github.com/kylehughes/the-unofficial-swift-programming-language-skill) - Swift Programming Language reference
- [kylehughes/the-unofficial-swift-concurrency-migration-skill](https://github.com/kylehughes/the-unofficial-swift-concurrency-migration-skill) - Swift Concurrency Migration guide
- [formulahendry/agent-skill-code-runner](https://github.com/formulahendry/agent-skill-code-runner) - Multi-language code execution
- [gapmiss/obsidian-plugin-skill](https://github.com/gapmiss/obsidian-plugin-skill) - Obsidian.md plugin development
- [frmoretto/stream-coding](https://github.com/frmoretto/stream-coding) - Stream Coding methodology (10-20x velocity)
#### ๐ Security & Operations
- [gadievron/raptor](https://github.com/gadievron/raptor) - Offensive/defensive security operations with sub-agents
#### ๐ง Integration & Automation
- [fabioc-aloha/spotify-skill](https://github.com/fabioc-aloha/spotify-skill) - Spotify API integration
- [gmickel/sheets-cli](https://github.com/gmickel/sheets-cli) - Google Sheets CLI automation
- [tubone24/midi-agent-skill](https://github.com/tubone24/midi-agent-skill) - MIDI file generation from text
- [SawyerHood/dev-browser](https://github.com/SawyerHood/dev-browser) - Web browser capability for agents
- [gotalab/skillport](https://github.com/gotalab/skillport) - Skills for any agent via CLI or MCP
- [DiscreteTom/agent-skills-mcp](https://github.com/DiscreteTom/agent-skills-mcp) - Load skills using Model Context Protocol
#### ๐ง AI & Context Engineering
- [muratcankoylan/Agent-Skills-for-Context-Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) - Context engineering techniques
- [dave1010/skills-to-agents](https://github.com/dave1010/skills-to-agents) - Auto-convert Skills for AGENTS.md
- [jakedahn/pomodoro](https://github.com/jakedahn/pomodoro) - System Skill Pattern (skills that remember & improve)
- [yzfly/Mind-Cloning-Engineering](https://github.com/yzfly/Mind-Cloning-Engineering) - Mind cloning with LLM skills
## ๐ ๏ธ Tools & Platforms
**The ecosystem is here.** Industry-leading platforms have already integrated Agent Skills - your next agent build starts with choosing the right foundation.
### ๐จ IDEs & Code Editors
- [OpenCode](https://opencode.ai/) - ๐ฏ AI development tool with built-in Agent Skills support
- [Cursor](https://cursor.com/) - โก AI-powered code editor with native skills integration ([docs](https://cursor.com/docs/context/skills))
- [Amp](https://ampcode.com/) - ๐ Next-gen AI coding assistant
- [Claude Code](https://claude.ai/code) - ๐ค Anthropic's coding tool with first-class skills support
- [OpenAI Codex](https://developers.openai.com/codex/skills/) - ๐ป OpenAI's CLI agent with Agent Skills support
### ๐ค AI Agent Platforms
- [Letta](https://www.letta.com/) - ๐ง Build stateful LLM agents with memory
- [Goose](https://block.github.io/goose/) - ๐ฆ Open source AI agent framework
- [GitHub Copilot](https://github.com/features/copilot) - ๐ GitHub's AI coding assistant with Agent Skills support ([docs](https://docs.github.com/copilot/concepts/agents/about-agent-skills), [announcement](https://github.blog/changelog/2025-12-18-github-copilot-now-supports-agent-skills/))
- [VS Code](https://code.visualstudio.com/) - ๐ป Microsoft's editor with Agent Skills in Insiders build
### ๐ง Developer Tools & Libraries
- [openskills](https://github.com/numman-ali/openskills) - ๐ฆ Universal skills loader for any AI agent
- [vibe-tools](https://github.com/eastlondoner/vibe-tools) - ๐ฅ Give your agent an AI team with advanced skills
- [IntentKit](https://github.com/crestalnetwork/intentkit) - ๐ญ Framework for intent-driven AI agents
- [Agentica](https://github.com/wrtnlabs/agentica) - ๐ TypeScript AI function calling framework
- [agentigy/skillcheck](https://github.com/agentigy/skillcheck) - ๐ Security scanner for SKILL.md files - detect vulnerabilities before production
- [AIPexStudio/AIPex](https://github.com/AIPexStudio/AIPex) - ๐ Privacy-first AI browser automation with Agent Skills
- [breaking-brake/cc-wf-studio](https://github.com/breaking-brake/cc-wf-studio) - ๐ฌ ClaudeCode Workflow Studio VSCode extension with slash commands
- [LangChain Deep Agents](https://github.com/langchain-ai/deepagents) - ๐ Open source agent harness with skills support ([blog](https://blog.langchain.com/using-skills-with-deep-agents/))
## ๐ Learn & Explore
**From zero to expert in hours, not weeks.** Curated resources that take you from understanding the fundamentals to architecting production-grade agent systems.
### ๐ Getting Started
- [What are skills?](https://support.claude.com/en/articles/12512176-what-are-skills) - ๐ Perfect introduction for beginners
- [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude) - ๐ Quick start guide
### ๐๏ธ Building Skills
- [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills) - โ๏ธ Step-by-step authoring guide
- [Skills API Quickstart](https://docs.claude.com/en/api/skills-guide#creating-a-skill) - ๐ป Technical documentation- [A2A Protocol: Agent Skills Tutorial](https://a2a-protocol.org/latest/tutorials/python/3-agent-skills-and-card/) - ๐ค How skills work in the Agent-to-Agent protocol
### ๐ฐ Featured Articles
- [Equipping agents for the real world with Agent Skills](https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) - ๐ฏ The original announcement from Anthropic Engineering
- [How I Built Agent Skills for Claude Code](https://dev.to/nunc/how-i-built-agent-skills-for-claude-code-oj4) - ๐ ๏ธ 8-minute tutorial on building custom Agent Skills from scratch
- [Claude Skills vs MCP: Complete Guide](https://dev.to/jimquote/claude-skills-vs-mcp-complete-guide-to-token-efficient-ai-agent-architecture-4mkf) - โ๏ธ Comparison of Skills and Model Context Protocol architectures
- [GitHub Copilot Agent Skills: Teaching AI Your Repository Patterns](https://dev.to/qa-leaders/github-copilot-agent-skills-teaching-ai-your-repository-patterns-1oa8) - ๐ Using Agent Skills with GitHub Copilot
- [From 2 Hours to 5 Minutes: Automating CDC Transformations](https://medium.com/@jagadeesh.subramani) - ๐ Real-world case study: 95% efficiency gain with Agent Skills
- [Advent of AI 2025 - Day 14: Agent Skills](https://dev.to/nickytonline/advent-of-ai-2025-day-14-agent-skills-4d48) - ๐ 5-minute guide to Agent Skills with Goose
- [Agent Skill in VS Code](https://dev.to/thangchung/agent-skill-in-vs-code-77d) - ๐ป Using Agent Skills directly in VS Code
- [Code Sandbox Tech Behind Manus and Claude Agent Skills](https://dev.to/qtalen/exclusive-reveal-code-sandbox-tech-behind-manus-and-claude-agent-skills-ef2) - ๐๏ธ Deep dive into sandboxing technology
- [OpenSkills: Adding Claude Skills for Any Agent or IDE](https://dev.to/wakeupmh/openskills-adding-claude-skills-and-superpowers-for-any-agent-or-ide-3j35) - ๐ Universal skills integration guide
- [Agent Skills Framework Analysis: Litho Implementation](https://dev.to/sopaco/agent-skills-framework-analysis-litho-implementation-and-design-philosophy-2l91) - ๐๏ธ Architecture and design patterns analysis
- [The Great AI Agent Configuration Confusion](https://medium.com/@satinath.mondal/the-great-ai-agent-configuration-confusion-agents-md-skill-md-and-whats-next-12345) - ๐ Understanding configuration standards (SKILL.md, AGENTS.md)
### ๐ฐ Industry News & Analysis
- [Anthropic launches enterprise Agent Skills and opens the standard](https://venturebeat.com/ai/anthropic-launches-enterprise-agent-skills-and-opens-the-standard) - ๐ฏ VentureBeat deep dive: Why Anthropic is giving away its competitive advantage
- [Agent Skills: Anthropic's Next Bid to Define AI Standards](https://thenewstack.io/agent-skills-anthropics-next-bid-to-define-ai-standards/) - ๐๏ธ The New Stack analysis of the open standard strategy
## ๐ฌ Videos & Tutorials
**See it in action.** Watch developers build real agent systems from scratch - from 1-minute quickstarts to hour-long engineering deep dives.
### ๐ Beginner-Friendly Tutorials
- [A better way to build agents? Claude Agent Skills Tutorial + Demo](https://www.youtube.com/watch?v=mxZqEduwyFk) - ๐ฅ 11-minute intro: Is Agent Skills the next big standard after MCP?
- [Claude Code Skills just Built me an AI Agent Team (2026 Guide)](https://www.youtube.com/watch?v=OdtGN27LchE) - ๐ 27-minute beginner guide to building general AI agents
- [Claude's new 'Agent Skills'](https://www.youtube.com/watch?v=VRzkafNIdgI) - โก 1-minute quick overview - installable "mini-brains"
- [Agent Skills Review](https://www.youtube.com/watch?v=tGpeWM7gOlA) - ๐ 25-second feature highlight
### ๐ง Technical Deep Dives
- [I finally CRACKED Claude Agent Skills (Breakdown For Engineers)](https://www.youtube.com/watch?v=kFpLzCVLA20) - ๐ ๏ธ 27-minute engineering breakdown: Skills vs MCP vs Subagents
- [Claude Agent Skills](https://www.youtube.com/watch?v=9XaprFRNTlc) - ๐ฏ 1-hour deep dive into domain-specific AI expertise
- [Agent Skills Explained: Why This Changes Everything](https://www.youtube.com/watch?v=Ihoxov5x66k) - ๐ก 17-minute analysis of why Skills matter for AI development
- [Claude Agent Skills Tutorial](https://www.youtube.com/watch?v=fOxC44g8vig) - ๐ฅ Comprehensive implementation tutorial with SKILL.md format
### ๐ Comparisons & Analysis
- [Agent Skills vs MCP Which Is Better?](https://www.youtube.com/watch?v=Pc2sB8v9570) - โ๏ธ 5-minute comparison: MCP vs Skills architecture
- [Claude Skills vs MCP: Complete Guide](https://dev.to/jimquote/claude-skills-vs-mcp-complete-guide-to-token-efficient-ai-agent-architecture-4mkf) - ๐ Written guide for token-efficient architectures
### ๐ข Real-World Applications
- [Claude Skills Built Me an AI Agent Army](https://www.youtube.com/watch?v=G-5bInklwRQ) - ๐ค 33-minute practical demo: Building digital employees
- [OpenAI Adds Agent Skills to Codex](https://www.youtube.com/watch?v=MsJzacfjzp8) - ๐ฅ 6-minute first look at Codex with Skills support
- [Agent Skills AI Real Work](https://www.youtube.com/watch?v=Udneqo7up2M) - ๐ผ 3-minute overview of customizable Claude agents
### ๐ค Conference Talks
- [Don't Build Agents, Build Skills Instead](https://www.youtube.com/watch?v=CEvIs9y1uog) - ๐๏ธ 16-minute talk by Barry Zhang & Mahesh Murag (Anthropic)
> ๐ก **Know a great video?** We're actively looking for more video content! Please [contribute](CONTRIBUTING.md) if you find or create relevant tutorials.
## ๐ฌ Research Papers
**Understand the foundations.** Cutting-edge research exploring the architecture, security implications, and theoretical underpinnings of skills-based agent systems.
### ๐ก๏ธ Security & Safety
- ๐ [Agent Skills Enable a New Class of Realistic and Trivially Simple Prompt Injections](https://arxiv.org/abs/2510.26328) (2025) - Security analysis showing vulnerabilities in Agent Skills markdown files
### ๐ Interoperability & Standards
- ๐ [A survey of agent interoperability protocols](https://arxiv.org/abs/2505.02279) (2025) - Comprehensive look at MCP, Agent Cards, and more
### ๐ Progressive Disclosure & Transparency
- ๐ [The Effect of Progressive Disclosure in the Transparency of Large Language Models](https://link.springer.com/chapter/10.1007/978-3-031-82633-7_17) (2024) - How progressive disclosure affects LLM transparency
- ๐ [Disclosures & disclaimers: Investigating the impact of transparency disclosures](https://ojs.aaai.org/index.php/HCOMP/article/view/31597) (2024) - Impact study on agent transparency
### ๐ง Skill Learning & Architecture
- ๐ [Reinforcement Learning for Self-Improving Agent with Skill Library](https://arxiv.org/abs/2512.17102) (2024) - Framework for agents to build and maintain skill libraries
- ๐ [PolySkill: Learning Generalizable Skills Through Polymorphic Abstraction](https://arxiv.org/abs/2510.15863) (2024) - Learning generalizable skills through polymorphic abstraction
> ๐ก **Note:** Agent Skills (SKILL.md format) is a recent innovation (2024-2025), so academic research is still emerging. Most papers focus on related concepts like skill learning, tool use, and agent architectures.
## โ Frequently Asked Questions
### What are Agent Skills?
Agent Skills are modular, standardized `SKILL.md` packages that provide AI agents with on-demand capabilities. Instead of fine-tuning models or bloating context windows, skills enable **progressive disclosure**: lightweight metadata loads at startup (~50 tokens), full instructions activate when needed (~2-5K tokens), and resources load dynamically during execution.
### How do Agent Skills differ from fine-tuning?
Fine-tuning modifies model weights permanently (expensive, inflexible), while Agent Skills provide **runtime knowledge injection** that's instantly updatable, shareable across platforms, and requires zero retraining. Update a skill once, and every agent using it benefits immediately.
### What's the difference between Agent Skills and MCP (Model Context Protocol)?
**Agent Skills** focus on **capabilities and workflows** (how to do X), while **MCP** focuses on **data access** (connecting to APIs, databases). They're complementary: use MCP to connect to external data sources, use Skills to teach agents how to process that data. Many developers use both together.
### How do I create my first Agent Skill?
1. Create a `SKILL.md` file with YAML frontmatter (name, description)
2. Write clear instructions in markdown (what, when, how)
3. Add optional `scripts/` folder for code references
4. Place in `.github/skills/` or `.claude/skills/` directory
5. Test with compatible platforms (Claude Code, Cursor, GitHub Copilot)
๐ Full guide: [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills)
### Which AI platforms support Agent Skills?
Major platforms with native support include: **Claude** (Claude.ai, Claude Code), **OpenAI** (Codex CLI), **GitHub Copilot**, **Cursor**, **VS Code Insiders**, **OpenCode**, **Amp**, **Letta**, and **Goose**. The ecosystem is rapidly expanding as more platforms adopt the open standard.
### Can I use Agent Skills with ChatGPT or other LLMs?
While ChatGPT doesn't natively support the Agent Skills format, you can use universal loaders like [openskills](https://github.com/numman-ali/openskills) to integrate skills with any LLM platform. The skills specification is open and platform-agnostic by design.
### Are Agent Skills secure?
Agent Skills introduce new security considerations. Since skills can execute code and access files, always **review skills before installation** from untrusted sources. Use tools like [skillcheck](https://github.com/agentigy/skillcheck) to scan for vulnerabilities. Research shows potential for prompt injection attacks ([arxiv.org/abs/2510.26328](https://arxiv.org/abs/2510.26328)), so treat skills like code packagesโaudit before trusting.
### How do I share Agent Skills with my team?
**Option 1**: Commit to your repository's `.github/skills/` or `.claude/skills/` directoryโagents automatically discover them.
**Option 2**: Publish to GitHub as a standalone repo (e.g., `my-org/data-analysis-skill`)โothers can reference or clone.
**Option 3**: Use [skillport](https://github.com/gotalab/skillport) or [agent-skills-mcp](https://github.com/DiscreteTom/agent-skills-mcp) for cross-platform distribution.
### What makes a good Agent Skill?
**Best practices:**
- โ
**Single responsibility** - One clear capability per skill
- โ
**Progressive detail** - Brief metadata, detailed instructions, extensive resources
- โ
**Context-aware** - Include when/why to use (not just how)
- โ
**Testable** - Provide example inputs/outputs
- โ
**Discoverable** - Descriptive names and rich descriptions
### When should I use Agent Skills vs custom tools/functions?
Use **Agent Skills** when:
- Capabilities need to work across multiple platforms
- Instructions are complex multi-step workflows
- You want version control and collaborative editing
- Knowledge needs frequent updates
Use **custom tools/functions** when:
- Platform-specific integration required (e.g., API-specific features)
- Real-time data access needed
- Computational logic can't be expressed as instructions
### Can Agent Skills call other Agent Skills?
Yes! Skills can reference other skills in their instructions, enabling **skill composition**. This allows building complex capabilities from simple, reusable building blocks. Some platforms also support **skill libraries** where skills automatically discover and leverage related capabilities.
### How do Agent Skills impact token usage?
**Dramatically reduce it.** Traditional approaches load all documentation upfront (10K-100K tokens), while skills load only what's needed (50 tokens metadata + 2-5K when activated). For agents managing 50+ capabilities, this means **90%+ token reduction** during idle time.
### Are Agent Skills just for coding tasks?
NoโAgent Skills work for any domain: **data analysis**, **content creation**, **project management**, **research**, **security operations**, **automation**, and more. The format is domain-agnostic. Think of them as "packages for knowledge" rather than "packages for code."
### Where can I find production-ready Agent Skills?
Start with:
- [anthropics/skills](https://github.com/anthropics/skills) - Official Anthropic collection
- [karanb192/awesome-claude-skills](https://github.com/karanb192/awesome-claude-skills) - 50+ verified skills
- This repository's [Ready-to-Use Skills](#-ready-to-use-skills) section
### How often should I update my Agent Skills?
Update skills whenever:
- Platform APIs or tools change
- Better approaches emerge
- Team workflows evolve
- User feedback reveals gaps
**Pro tip**: Add version numbers and changelogs to your skills for better tracking.
## ๐ฌ Join the Community
**You're not alone in this.** Join thousands of developers pioneering the future of AI agents - share breakthroughs, debug challenges, and shape the standards.
- ๐ญ [Agent Skills GitHub Discussions](https://github.com/agentskills/agentskills/discussions) - Official specification discussions
- ๐ [Anthropic Skills GitHub Issues](https://github.com/anthropics/skills/issues) - Report issues and request features
- โญ **Star this repo** to stay updated with the latest resources!
## ๐ค Contributing
**Shape the ecosystem.** This is a community-driven resource - your contributions help thousands of developers discover and build better agent systems.
- ๐ Add new skills, tools, or articles
- ๐ Improve documentation
- ๐ Fix broken links
- ๐ก Suggest new sections
Please read our [contribution guidelines](CONTRIBUTING.md) before submitting.
---
**Found this useful? Give it a โญ and share it with others!**
*Built with โค๏ธ by the Agent Skills community*
