Skip to main content
Back to Glossary (A)
Glossary · A

Agent Skill.

An agent skill is a folder containing instructions (usually SKILL.md) and optional scripts, templates or reference files that an AI agent loads when needed. It teaches the agent a specific job, such as applying a design system, producing a quote in the company layout or working through a checklist, without having to write everything into every prompt.

Illustration of "Agent Skill": Code editor showing skills/offerte-pdf/SKILL.md skills/offerte-pdf/SKILL.md1---2name:offerte-pdf3description:Createsquotesinthecompanylayout4---561.Loadtemplatefromreferences/72.Runscripts/pdf.py83.ChecktotalsLoaded on demand

Agent Skill — Explained in Detail

An AI agent can do a lot, but it knows neither your processes nor your templates. Until recently people relied on long prompts pasted in again for every task. Agent skills solve this in a more structured way: each skill is a folder of its own. It contains a text file with a short header (name and a description of when the skill applies) followed by the actual instructions. Scripts, example files, fonts or checklists can sit alongside. Anthropic introduced the format for Claude in October 2025, and other agent tools now read skills built the same way.

The trick is loading in stages. At the start the agent only sees the name and description of every available skill, which is a few lines. Only when a task matches does it read the full instructions and, if needed, the accompanying files. This keeps the context window free for the actual work even when dozens of skills are installed. A skill is therefore not a new capability of the model but retrievable know-how plus tooling: 'This is how we do it here, and this script makes it faster.'

Skills should be distinguished from two related building blocks. Project files such as CLAUDE.md and AGENTS.md describe a single project and are always loaded. The Model Context Protocol connects an agent to external systems such as a CRM or a database. Skills sit in between: they are reusable across projects and describe how a task is done, not where data comes from. In practice all three work together.

Skills are code and instructions at once, so the same care applies as with any software. A skill from someone else's repository can run scripts or steer the agent towards actions you do not want. The risk resembles prompt injection: instructions in a file are taken seriously by the agent. Before using one, read what a skill does, check the licence (see open-source licence) and only use sources you trust.

How a skill is structured

At its core one file is enough: SKILL.md with a header containing name and description, followed by instructions in plain language. The description is crucial, because the agent uses it to decide when the skill fits. 'Creates quotes in the company layout as PDF whenever someone asks for a quote or offer' works better than 'quote skill'. Subfolders can sit next to it, such as scripts/ for a Python script that generates a PDF, or references/ with examples of good results.

Good skills are narrowly scoped and verifiable. They state what must exist at the end, which mistakes are common and how to check the result. How we set up AI agents for companies is described on AI agent development and AI consulting Switzerland.

Example: a fiduciary office with three skills

A constructed example: a fiduciary office in Winterthur uses an AI agent for internal routine work. It creates three skills. The first produces engagement letters from the in-house template and fills them from a spreadsheet. The second checks submitted receipts for completeness against a fixed list and flags what is missing. The third drafts client emails in the office's tone, formal or informal depending on the client.

The agent only loads the skill that fits the task. New staff benefit as well, because the skills record the office's way of working in writing. Human review remains essential: the agent prepares, a qualified person approves, see human-in-the-loop. Sensitive client data only belongs in systems whose data storage has been clarified.

Frequently Asked Questions About Agent Skill

A prompt is a one-off instruction in a conversation. A skill is stored, reusable guidance with optional scripts and templates that the agent loads by itself whenever a task matches. You write it once and keep improving it.

Not for simple skills. Clear instructions in plain language with a good description are often enough. As soon as scripts are involved, for example to generate files or validate data, you need programming knowledge or someone who writes and tests the scripts.

Not automatically. A skill can contain scripts and steer the agent towards actions. Before using one, read the instructions and scripts, check origin and licence, and let the agent work only with the permissions it really needs.

Ready for Your Project?

Apply this knowledge to your website — DLM Digital will help you.