Agent Skills FAQ
Frequently asked questions about Agent Skills and how they work with AI coding assistants.
What are Agent Skills?
Q: What is an Agent Skill?
A: An Agent Skill is a modular "knowledge package" designed to teach an AI agent how to
perform a specialized task in a reliable, repeatable way. Unlike a generic prompt, a skill is a folder
containing a SKILL.md file with Markdown instructions
and metadata, along with optional scripts, templates, or reference documentation. These packages codify
domain expertise—such as team coding standards or specific document workflows—allowing the agent to reuse
that knowledge automatically.
Q: How do Skills work technically?
A: Skills utilize a mechanism called progressive disclosure (or lazy loading) to maintain efficiency. At startup, the agent loads only the name and description of the skill. The agent monitors the user's conversation, and if a request matches a skill's description, the agent dynamically loads the full instructions and context into the conversation. This approach prevents the agent's context window from being overwhelmed by unused instructions.
Q: How are Skills different from the Model Context Protocol (MCP)?
A: While they can work together, they serve different purposes:
- Skills (Know-How): Skills are Markdown files that provide "knowledge sharing," teaching the agent how to use tools or follow a process (e.g., "Review this PR using our specific security guidelines").
- MCP (Tools): MCP connects the agent to external systems and data (e.g., connecting to a database or executing code).
In short, MCP provides the "hands" (tools), while Skills provide the "brain" (methodology) for using those tools effectively.
The Agent Skills Standard
Q: Is there a unified standard for Skills?
A: Yes. Capabilities across different platforms are built on the Agent Skills Open Specification (also referred to as the open agent skills standard). This specification defines the required structure, such as the SKILL.md file format and the YAML frontmatter (metadata like name and description) required for the skill to function. It also specifies the metadata formatted as XML tags that gets sent to the LLM or agent to pick a skill.
Q: How did Skills become a cross-platform standard?
A: The standard originated with Anthropic, which introduced Agent Skills (around October 2025) to extend Claude's capabilities. It became a de facto industry standard through broad adoption and compatibility:
- Open Specification: The explicit publication of the "Agent Skills Open Specification" allowed other developers to build compatible systems.
- Cross-Compatibility: Major platforms adopted the file structure
defined by Anthropic. For example, GitHub Copilot and OpenCode were engineered to automatically discover
and use skills located in
.claude/skillsdirectories, ensuring that a skill created for one agent often works for another without modification.
Support & Ecosystem
Q: Which AI agents and platforms support Skills?
A: As of late 2025, support for Agent Skills is available across several major developer tools:
- Claude Code: Supports skills via the
.claude/skillsdirectory, plugins, and the anthropics/skills repository. - GitHub Copilot: Added support for Agent Skills on December 18, 2025.
Copilot works with skills in the CLI, IDE, and coding agent, and it can read skills directly from
.claude/skillsrepositories. - OpenAI Codex: Supports skills via the CLI and IDE extensions,
utilizing the
.codex/skillsdirectory or system-wide locations. - OpenCode: Supports skills via
.opencode/skilland maintains compatibility with.claude/skills. - Skilz: With the Skilz installer, you can use Agent Skills with 14+ different platforms, including Gemini CLI, Aider, Cursor, Windsurf, Qwen Code, KIMI Code, and many more. You can even configure the Skilz installer to support tools that it does not currently support. The Skilz installer works with skillzwave.ai but it can also work standalone and can install from any git repo or GitHub repo URL or from the file system. It supports project installs as well as user home installs.
Q: Where can I find pre-made Skills?
A: Users can download curated skills from community repositories. Notable sources include the
anthropics/skills
repository on GitHub and the
github/awesome-copilot
collection. You can also browse thousands of skills here on
Skillzwave.
Platforms like Codex also include a $skill-installer
tool to help users download skills from these repositories.
The Kitchen Analogy
You can think of an AI Agent as a master chef in a kitchen:
- 🔧 MCP (Tools) is the equipment: the ovens, blenders, and knives that allow the chef to physically manipulate ingredients.
- 📋 Agent Skills are the recipe cards: specific, step-by-step instructions that tell the chef exactly how to use that equipment to prepare a specific dish (like "Grandma's Lasagna") exactly the way you want it, every single time.