# Format pliku umiejętności

EN: **Skill file format** · id `skillformat` · aliases: SKILL.md format, frontmatter umiejętności

Path: [AI Atlas](https://aiatlasgraph.com/llms.txt) › [Aplikacje LLM i agenci](https://aiatlasgraph.com/t/applications.md) › [Agenci i orkiestracja](https://aiatlasgraph.com/t/agentsnode.md) › [Umiejętności agentów](https://aiatlasgraph.com/t/agentskills.md) › Format pliku umiejętności

## Description

- PL: Folder z plikiem instrukcji, którego nagłówek ma co najmniej nazwę i opis, zgodne z nazwą folderu.
- EN: A folder with an instruction file whose header has at least a name and description, matching the folder name.

## In one sentence

- PL: Ustalony układ folderu: krótka metryczka na górze pliku i instrukcja pod spodem.
- EN: A fixed folder layout: a short header at the top of the file and instructions underneath.

## Problem it solves

- PL: Każdy opisuje procedury inaczej, więc asystent nie wie, czego szukać ani kiedy je stosować.
- EN: Everyone describes procedures differently, so the assistant does not know what to look for or when to apply them.

## What it does

- PL: Wymaga nazwy i opisu w stałym nagłówku, a kroki trzyma w zwykłym tekście pod spodem.
- EN: It requires a name and description in a fixed header, and keeps the steps in ordinary text below.

## Everyday example

- PL: Zapisujesz zamknięcie miesiąca jako folder z plikiem instrukcji, a asystent rozpoznaje go po opisie, nie po nazwie czatu.
- EN: You save month-end closing as a folder with an instruction file, and the assistant recognizes it from the description, not the chat title.

## This concerns you if you…

- PL: chcesz, żeby asystent sam wybrał właściwą procedurę
- PL: opisujesz powtarzalną pracę tak, by dało się ją przekazać
- EN: want the assistant to pick the right procedure itself
- EN: describe repeatable work so someone else can reuse it

## Keywords

SKILL.md · YAML frontmatter · skill name constraints · skill description · scripts directory · references directory · assets directory · skills-ref

## How it works

- PL: Wymagany plik zaczyna się od nagłówka z polami name i description. Nazwa jest krótka, małymi literami i myślnikami, i musi zgadzać się z nazwą folderu. Opis mówi, co umiejętność robi i kiedy jej użyć, bo to jedyne pole widoczne przed włączeniem. Opcjonalne katalogi scripts, references i assets trzymają kod, dokumentację i szablony.
- EN: The required file starts with a header containing name and description. The name is short, lowercase and hyphenated, and must match the folder name. The description says what the skill does and when to use it, because that is the only field visible before activation. Optional scripts, references and assets directories hold code, documentation and templates.

## Limits

- PL: Za długi albo ogólnikowy opis psuje wybór. Pole dozwolonych narzędzi jest eksperymentalne i nie każdy agent je honoruje. Sama zgodność nagłówka nie gwarantuje, że skrypty zadziałają w innym środowisku.
- EN: An overly long or vague description breaks selection. The allowed-tools field is experimental and not every agent honors it. A valid header does not guarantee that scripts will run in another environment.

## Key terms

- PL: **nagłówek**: Pola na górze pliku, oddzielone od właściwej instrukcji.
- PL: **opis wywołania**: Zdanie, po którym agent decyduje, czy otworzyć umiejętność.
- PL: **katalog zasobów**: Opcjonalne pliki z kodem, dokumentacją albo szablonami.
- EN: **frontmatter**: Fields at the top of the file, separate from the instructions.
- EN: **trigger description**: The sentence the agent uses to decide whether to open a skill.
- EN: **resource directory**: Optional files with code, documentation or templates.

## Know first

- [Budowa polecenia: instrukcje, rola i znaczniki (Prompt structure: instructions, roles and delimiters)](https://aiatlasgraph.com/t/promptstructure.md)
- [Structured outputs i walidacja (Structured outputs and validation)](https://aiatlasgraph.com/t/structured.md)

## Sources

- [Agent Skills specification](<https://agentskills.io/specification>) `agentskills-spec` · by Agent Skills (otwarty standard; format pochodzi od Anthropic)
- [Equipping agents for the real world with Agent Skills](<https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills>) `anthropic-agent-skills-2025` · by Anthropic · sponsored
- [Agent Skills in Codex](<https://developers.openai.com/codex/skills>) `openai-codex-skills-docs` · by OpenAI · sponsored

---

AI Atlas revision 122 (2026-10-30) · HTML: https://aiatlasgraph.com/t/skillformat · index: https://aiatlasgraph.com/llms.txt · everything: https://aiatlasgraph.com/llms-full.txt · updated 2026-10-30