From 9b2b16349dcfdc429e38dc28ba6007b49df835f3 Mon Sep 17 00:00:00 2001 From: xxl007 Date: Tue, 23 Dec 2025 13:55:08 +0000 Subject: [PATCH] Refactor README: restructure into user journey phases (Learn -> Use -> Build -> Master) --- README.md | 227 +++++++++++++++++++----------------------------------- 1 file changed, 80 insertions(+), 147 deletions(-) diff --git a/README.md b/README.md index 42dec72..d614019 100644 --- a/README.md +++ b/README.md @@ -40,194 +40,127 @@ This architecture delivers: ## πŸ“š 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 +- [Start Here](#-start-here) - Introduction to the concepts +- [Phase 1: Learn the Fundamentals](#-phase-1-learn-the-fundamentals) - Articles and videos to get started +- [Phase 2: Use Existing Skills](#-phase-2-use-existing-skills) - Platforms and ready-to-use libraries +- [Phase 3: Build & Integrate](#-phase-3-build--integrate) - Create your own skills and tools +- [Phase 4: Master & Research](#-phase-4-master--research) - Advanced engineering and theory +- [Frequently Asked Questions](#-frequently-asked-questions) - Common questions answered +- [Community & Contributing](#-community--contributing) - Join the movement -## 🎁 Ready-to-Use Skills +## 🏁 Start Here -**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. +**New to Agent Skills?** These resources will take you from zero to understanding the core concepts in minutes. -### πŸ“š Skills Collections & Repositories +### πŸŽ“ Getting Started -**Multi-skill repositories** with diverse capabilities. -> ℹ️ *Resources are sorted by popularity (GitHub stars) where applicable.* +- [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 +- [Agent Skills Review](https://www.youtube.com/watch?v=tGpeWM7gOlA) - 25-second feature highlight + +## πŸŽ“ Phase 1: Learn the Fundamentals + +**Understand the "Why" and "How".** Before diving into code, grasp the architectural shift and best practices. + +### πŸ“° Key Concepts & 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 +- [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 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 +- [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) + +### 🎬 Video Introductions + +- [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's new 'Agent Skills'](https://www.youtube.com/watch?v=VRzkafNIdgI) - 1-minute quick overview - installable "mini-brains" +- [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 + +## πŸ› οΈ Phase 2: Use Existing Skills + +**Experience the power.** Don't build from scratchβ€”leverage the ecosystem of platforms and pre-built libraries. + +### 🎨 Supported Platforms & IDEs + +**Where can you use Agent Skills today?** + +- [Cursor](https://cursor.com/) - AI-powered code editor with native skills integration ([docs](https://cursor.com/docs/context/skills)) +- [Claude Code](https://claude.ai/code) - Anthropic's coding tool with first-class skills support +- [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)) +- [VS Code](https://code.visualstudio.com/) - Microsoft's editor with Agent Skills in Insiders build +- [OpenAI Codex](https://developers.openai.com/codex/skills/) - OpenAI's CLI agent with Agent Skills support + +### πŸ“¦ Ready-to-Use Skill Libraries + +**Tap into battle-tested capabilities.** #### πŸ”₯ Top Picks - - Official collection from Anthropic (document editing, data analysis, etc.) - 50+ verified skills for Claude Code and Claude.ai - Skills for specialized capabilities #### πŸ“‚ More Collections - - Multi-agent collaboration skills - Pydantic AI integration - Skills for DSPy framework - Document editing, data analysis, and project management - Curated Claude Agent Skills collection - Freeact agent library skills -- Productivity-focused skills -- Voice AI, image generation, and web development -### 🎯 Individual Skills by Category +## πŸ—οΈ Phase 3: Build & Integrate -**Specialized capabilities for specific domains.** +**Create your own.** Learn to author `SKILL.md` files and integrate them into your workflows. -#### πŸ’» Development & Programming - -- Swift Concurrency Migration guide -- Swift Programming Language reference -- Obsidian.md plugin development -- Stream Coding methodology (10-20x velocity) -- Multi-language code execution - -#### πŸ”’ Security & Operations - -- Offensive/defensive security operations with sub-agents - -#### πŸ”§ Integration & Automation - -- Web browser capability for agents -- Skills for any agent via CLI or MCP -- Load skills using Model Context Protocol -- Google Sheets CLI automation -- Spotify API integration -- MIDI file generation from text - -#### 🧠 AI & Context Engineering - -- Context engineering techniques -- Auto-convert Skills for AGENTS.md -- System Skill Pattern (skills that remember & improve) -- 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 -- [Cursor](https://cursor.com/) - AI-powered code editor with native skills integration ([docs](https://cursor.com/docs/context/skills)) -- [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 -- [OpenCode](https://opencode.ai/) - AI development tool with built-in Agent Skills support -- [Amp](https://ampcode.com/) - Next-gen AI coding assistant - -### πŸ€– AI Agent Platforms -- [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 -- [Goose](https://block.github.io/goose/) - Open source AI agent framework -- [Letta](https://www.letta.com/) - Build stateful LLM agents with memory - -### πŸ”§ Developer Tools & Libraries - -- [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/)) -- [IntentKit](https://github.com/crestalnetwork/intentkit) - Framework for intent-driven AI agents -- [vibe-tools](https://github.com/eastlondoner/vibe-tools) - Give your agent an AI team with advanced skills -- [openskills](https://github.com/numman-ali/openskills) - Universal skills loader for any AI agent -- [Agentica](https://github.com/wrtnlabs/agentica) - TypeScript AI function calling framework -- [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 -- [agentigy/skillcheck](https://github.com/agentigy/skillcheck) - Security scanner for SKILL.md files - detect vulnerabilities before production - -## πŸ“– 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 Build 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 +### πŸ”§ Developer Tools -- [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 +**Frameworks and utilities for building and loading skills.** -### 🏒 Real-World Applications +- [agentigy/skillcheck](https://github.com/agentigy/skillcheck) - Security scanner for SKILL.md files - detect vulnerabilities before production +- [openskills](https://github.com/numman-ali/openskills) - Universal skills loader for any AI agent +- [LangChain Deep Agents](https://github.com/langchain-ai/deepagents) - Open source agent harness with skills support +- [IntentKit](https://github.com/crestalnetwork/intentkit) - Framework for intent-driven AI agents +- [Agentica](https://github.com/wrtnlabs/agentica) - TypeScript AI function calling framework -- [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 +### πŸ’‘ Reference Implementations (By Category) -### 🎀 Conference Talks +**Learn from examples.** -- [Don't Build Agents, Build Skills Instead](https://www.youtube.com/watch?v=CEvIs9y1uog) - 16-minute talk by Barry Zhang & Mahesh Murag (Anthropic) +#### Development & Programming +- Swift Concurrency Migration guide +- Obsidian.md plugin development +- Stream Coding methodology -> πŸ’‘ **Know a great video?** We're actively looking for more video content! Please [contribute](CONTRIBUTING.md) if you find or create relevant tutorials. +#### Integration & Automation +- Web browser capability for agents +- Skills for any agent via CLI or MCP +- Google Sheets CLI automation +- Spotify API integration -## πŸ”¬ Research Papers +## πŸ”¬ Phase 4: Master & Research -**Understand the foundations.** Cutting-edge research exploring the architecture, security implications, and theoretical underpinnings of skills-based agent systems. +**Deepen your expertise.** Explore advanced architectures, security implications, and academic research. -### πŸ›‘οΈ Security & Safety +### 🧠 Advanced Engineering + +- [I finally CRACKED Claude Agent Skills](https://www.youtube.com/watch?v=kFpLzCVLA20) - 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 +- Context engineering techniques +- System Skill Pattern (skills that remember & improve) +- Mind cloning with LLM skills + +### πŸ›‘οΈ Research & Security - [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?