Ultimate Agent Skills Collection

---

Table of Contents

• What Are Agent Skills?
• Why This Collection is Different
• Compatible Agents
• Quick Start
• Skills Directory
• Official Skills References
• Community Skills & Collections
• IDE/Agent Configuration
• Official Tutorials and Guides
• FAQ
• Contributing
• License
• Star History
• References

---

📖 What Are Agent Skills?

Agent Skills are modular instruction packages that extend what AI coding agents can do. Each skill is a self-contained folder with a SKILL.md file (the core instructions) plus optional scripts, templates, and references. When you ask an AI agent to perform a task, it dynamically loads the relevant skill and follows the instructions — no fine-tuning, no API changes, no configuration.

This standard is supported by Claude, Copilot, Codex, Gemini, and more. Skills are portable across all compatible agents.

---

🌟 Why This Collection — Not Another Link List

There are many “awesome lists” that collect links to skills scattered across GitHub. This project takes a completely different approach: every skill lives here, fully implemented, ready to use.

Core Advantages

• skillctl CLI — The first skill manager. Search, enable, disable, update skills per IDE from your terminal
• 51+ Complete Skills — Not links. Real SKILL.md + scripts + templates + references, all in one repo
• 11 IDE Support — Cursor, Claude Code, Copilot, VS Code, Codex, Windsurf, Gemini CLI, and more
• Per-Skill Control — Don’t want all 51? Enable only what you need per IDE
• CI Validated — GitHub Actions verify every SKILL.md has valid structure
• 6 Languages — EN, 简体中文, 繁體中文, 日本語, 한국어, Español

---

🔌 Compatible Agents

This collection works with all major AI coding agents that support the skill standard:

---

🚀 Quick Start

1. Clone & Use skillctl (Recommended)

git clone https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection.git ~/agent-skills
cd ~/agent-skills

# See all available skills
./skillctl list

# Set up all skills for your IDE
./skillctl setup cursor        # or: claude, copilot, codex, windsurf...
./skillctl setup all           # configure all detected IDEs at once

# Enable/disable individual skills
./skillctl enable cursor docx
./skillctl disable cursor xlsx
./skillctl search "testing"
./skillctl status
./skillctl update              # pull latest from GitHub

2. Interactive Installer (Alternative)

chmod +x install.sh && ./install.sh

3. Manual Symlink

git clone https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection.git ~/.agents/skills
mkdir -p ~/.cursor && ln -sf ~/.agents/skills ~/.cursor/skills

---

📂 Skills Directory

🎨 Creative & Design

📄 Document Skills

📝 Obsidian Knowledge Management

🛠️ Development & Technical

🔍 SEO & Performance

🧠 Planning & Workflow

🐛 Debugging & Quality

🤖 Agent Orchestration

🔧 Git & Development Workflow

🔗 Integration & Automation

🔺 Vercel Official

---

📚 Official Skills References

These are official skill implementations from AI platform providers:

Anthropic (Claude)

OpenAI (Codex)

HuggingFace

---

🌐 Community Skills & Collections

Verified community-maintained skills and collections worth exploring:

---

⚙️ IDE/Agent Configuration

Quick Setup (All IDEs)

# Clone the collection
git clone https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection.git ~/.agents/skills

Supported IDEs & Configuration Paths

All-in-One Setup Script

git clone https://github.com/ZhanlinCui/Ultimate-Agent-Skills-Collection.git ~/.agents/skills

mkdir -p ~/.cursor ~/.claude ~/.copilot ~/.codex ~/.gemini ~/.gemini/antigravity \
         ~/.codeium/windsurf ~/.config/opencode ~/.config/agents ~/.iflow

ln -sf ~/.agents/skills ~/.cursor/skills
ln -sf ~/.agents/skills ~/.claude/skills
ln -sf ~/.agents/skills ~/.copilot/skills
ln -sf ~/.agents/skills ~/.codex/skills
ln -sf ~/.agents/skills ~/.gemini/skills
ln -sf ~/.agents/skills ~/.gemini/antigravity/skills
ln -sf ~/.agents/skills ~/.codeium/windsurf/skills
ln -sf ~/.agents/skills ~/.config/opencode/skill
ln -sf ~/.agents/skills ~/.config/agents/skills
ln -sf ~/.agents/skills ~/.iflow/skills

echo "✅ Skills configured for all IDEs!"

---

📖 Official Tutorials and Guides

Claude & Anthropic

• Using Skills in Claude — Official quick start guide
• How to Create Custom Skills — Step-by-step authoring
• Claude Code Skills Documentation — Official reference

GitHub Copilot & VS Code

• About Agent Skills — GitHub documentation
• VS Code Agent Skills — VS Code integration

OpenAI Codex

• Codex Skills Documentation — Official reference

Model Context Protocol (MCP)

• MCP Official Documentation — The open standard
• Build Your First MCP Server — Python/TypeScript guide
• MCP Server Examples — Official server implementations

---

❓ FAQ

What are Agent Skills?

Agent Skills are instruction files that teach AI assistants how to do specific tasks. Think of them as “how-to guides” that the AI reads and follows. They only load when needed, so the AI stays fast and focused.

How is this different from other skill collections?

Most collections are link directories — they list links to external repositories. This collection contains 51+ complete skill implementations with scripts, templates, and reference documentation. Clone once and you have everything ready to use.

How are Agent Skills different from fine-tuning?

Fine-tuning permanently changes how an AI thinks (expensive and hard to update). Agent Skills are just instruction files — you can update, swap, or share them anytime without touching the AI itself.

What’s the difference between Agent Skills and MCP?

They complement each other:

• Agent Skills = teach the AI how to do something (workflows, best practices)
• MCP = help the AI access things (APIs, databases, external tools)

Which AI tools support Agent Skills?

Currently supported: Claude (Claude.ai and Claude Code), GitHub Copilot, VS Code, Codex (OpenAI), Antigravity (Google), Gemini CLI, Kiro, Cursor, Windsurf, OpenCode, and Amp. The list is growing.

Do Agent Skills run code?

No. Skills are text instructions — the AI reads and follows them like a recipe. Some skills include helper scripts that the AI can execute, but the skill itself is just instructions.

How do I create my own skill?

1. Create a folder with a SKILL.md file containing a name and description
2. Write clear, step-by-step instructions
3. Optionally add scripts, templates, or references
4. Place it in your IDE’s skill directory
5. Full guide: How to create custom skills

Can I use these skills with multiple IDEs at the same time?

Yes! Use the install.sh script or the all-in-one setup script above to configure skills for all your IDEs simultaneously. Skills are just files — they work across any compatible agent.

---

🏷️ Skills Quick Reference

Skill Structure

Every skill follows a consistent structure:

skill-name/
├── SKILL.md          # Main instructions (required)
├── scripts/          # Helper scripts (optional)
├── templates/        # Template files (optional)
├── references/       # Documentation (optional)
└── examples/         # Usage examples (optional)

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for full guidelines.

Quick summary:

1. Fork this repository
2. Create a skill folder with SKILL.md (and optional scripts/templates)
3. Add your skill to the correct category in README
4. Submit a Pull Request

Quality requirements:

• SKILL.md must include valid frontmatter (name, description)
• Clear, actionable instructions
• No promotional or marketing language
• Under 500 lines for optimal performance
• Scripts must be tested

---

📜 License

MIT License — see LICENSE for details.

---

⭐ Star History

---

📚 References

• Anthropic: Using Skills in Claude
• Anthropic: Creating Custom Skills
• Claude Code Skills Documentation
• GitHub Copilot: About Agent Skills
• VS Code Agent Skills
• OpenAI Codex Skills
• Google Antigravity Skills
• Model Context Protocol Documentation

---