# Stopniowe wczytywanie umiejętności

EN: **Progressive disclosure of skills** · id `skilldisclosure` · aliases: progressive disclosure, stopniowe odkrywanie 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) › Stopniowe wczytywanie umiejętności

## Description

- PL: Trzystopniowe ładowanie umiejętności: metadane na starcie, treść po wyborze, zasoby na żądanie.
- EN: Three-level skill loading: metadata at startup, body after selection, resources on demand.

## In one sentence

- PL: Asystent najpierw widzi spis umiejętności, a szczegóły otwiera dopiero przy pasującym zadaniu.
- EN: The assistant first sees a list of skills and opens the details only for a matching task.

## Problem it solves

- PL: Pełne instrukcje wszystkich procedur nie mieszczą się w jednej rozmowie i zagłuszają właściwe zadanie.
- EN: Full instructions for every procedure do not fit in one conversation and drown out the actual task.

## What it does

- PL: Działa jak spis treści: najpierw tytuły, potem rozdział, a załączniki dopiero gdy są potrzebne.
- EN: It works like a table of contents: titles first, then the chapter, and attachments only when needed.

## Everyday example

- PL: Masz dwadzieścia procedur firmowych. Asystent widzi ich opisy, a pełną instrukcję zwrotów otwiera dopiero przy reklamacji.
- EN: You have twenty company procedures. The assistant sees their descriptions and opens the full returns instructions only for a complaint.

## This concerns you if you…

- PL: masz więcej procedur, niż mieści się w jednej wiadomości
- PL: asystent gubi się, gdy dostaje wszystkie zasady naraz
- EN: have more procedures than fit in one message
- EN: the assistant gets lost when given every rule at once

## Keywords

progressive disclosure · skill metadata · on-demand loading · context budget · skill activation · reference files

## How it works

- PL: Specyfikacja rozdziela trzy poziomy. Metadane, około stu tokenów na umiejętność, trafiają do kontekstu przy starcie. Treść pliku instrukcji, zalecana poniżej pięciu tysięcy tokenów, jest czytana po aktywacji. Pliki w scripts, references i assets są otwierane dopiero, gdy instrukcja do nich odsyła.
- EN: The specification separates three levels. Metadata, about a hundred tokens per skill, enters context at startup. The instruction body, recommended under five thousand tokens, is read after activation. Files under scripts, references and assets are opened only when the instructions point to them.

## Limits

- PL: Wybór zależy od jakości opisu, nie od pełnej treści. Zbyt wiele opisów i tak zajmuje kontekst startowy. Agent może nie doczytać pliku, do którego instrukcja odsyła.
- EN: Selection depends on description quality, not on the full text. Too many descriptions still consume the startup context. The agent may fail to open a file the instructions refer to.

## Key terms

- PL: **poziom metadanych**: Krótka nazwa i opis wczytywane przy każdym starcie.
- PL: **poziom instrukcji**: Pełna treść pliku czytana dopiero po wyborze umiejętności.
- PL: **poziom zasobów**: Dodatkowe pliki otwierane tylko na odwołanie z instrukcji.
- EN: **metadata level**: Short name and description loaded at every startup.
- EN: **instruction level**: Full file body read only after the skill is selected.
- EN: **resource level**: Extra files opened only when the instructions refer to them.

## Know first

- [Zarządzanie oknem kontekstu (Context window management: placement, compaction and context rot)](https://aiatlasgraph.com/t/contextmanagement.md)
- [Prompty i kontekst (Prompting and context engineering)](https://aiatlasgraph.com/t/prompting.md)

## Related topics

Untyped, symmetric "see also" links.

- [Mapa dokumentów dla agenta (Repository map for agents)](https://aiatlasgraph.com/t/harnessdocs.md)
- [Zarządzanie oknem kontekstu (Context window management: placement, compaction and context rot)](https://aiatlasgraph.com/t/contextmanagement.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/skilldisclosure · index: https://aiatlasgraph.com/llms.txt · everything: https://aiatlasgraph.com/llms-full.txt · updated 2026-10-30