Skip to main content
Skills And MCP Basics

What Is An AI Skill?

A practical definition of AI skills, how they are packaged, and where they fit in an agent workflow.

Short answer

An AI skill is a reusable bundle of instructions, examples, scripts, and optional metadata that teaches an agent how to perform a focused job well. It is usually loaded from the local filesystem or a repository, not discovered dynamically over a network protocol during each tool call.

Skills are best when the capability is mostly behavioral: how to investigate, how to structure output, how to review code, or how to orchestrate existing tools safely.

The right mental model

Think of a skill as reusable operating instructions for an agent, not as a server process. A good skill narrows one task, defines expectations, and sometimes ships helper scripts or templates. It is closer to a playbook than to an API.

That is why skills are useful even when they contain no executable server. They can still improve planning, output structure, review discipline, and tool usage patterns dramatically.

What usually lives inside a skill

  • A primary instructions file such as SKILL.md.
  • Optional scripts, templates, examples, or reference files.
  • Optional metadata that tells a host application how to display or invoke the skill.
  • Optional dependency declarations, especially in platforms that support richer skill packaging.

That structure matters for review. A skill that looks harmless at the prompt layer can still ship scripts or helper files that widen its effective permissions.

When a skill is the right fit

Use a skill when you want repeatable guidance, not a long-running tool transport. Examples include code review standards, threat-model checklists, release playbooks, data extraction workflows, or organization-specific documentation conventions.

If the capability needs live access to a database, browser, design tool, or SaaS API, that usually points to an MCP server instead.

Sources and further reading