# Dependabot pro agent skills: verzování přes APM

> Dependabot pro agent skills hlídá verze v apm.yml. Návod na APM, lockfile, nastavení dependabot.yml a bezpečné review pull requestů se skills.

Canonical: https://aicko.cz/content/dependabot-pro-agent-skills-verzovani-pres-apm
Last updated: 2026-11-11
Kategorie: Vibe coding

**Dependabot pro agent skills** je od 3. listopadu 2026 realita: GitHub ho naučil aktualizovat závislosti v souboru `apm.yml`, tedy skills, prompty a instrukce pro AI agenty, které spravuje Agent Package Manager (APM). Dosud sis skill zkopíroval do repozitáře a za půl roku nevěděl, jestli autor mezitím něco opravil, nebo rozbil. Teď ti na novou verzi přijde [pull request](https://aicko.cz/content/pull-request-ktery-se-vysvetli-sam-diagram-video-plan) jako u každé jiné knihovny.

V tomhle návodu si ukážeme, co APM je, jak do něj převést skills, které máš rozházené po projektech, jak zapneš Dependabota a hlavně kde jsou jeho meze. Zdroje jsem ověřil v [oznámení GitHub Changelogu z 3. 11. 2026](https://github.blog/changelog/2026-11-03-dependabot-version-updates-support-agent-package-manager/) a v [dokumentaci APM](https://microsoft.github.io/apm/).

![Balíčky s verzemi a robotická ruka, která vyměňuje starou verzi za novou](https://aicko.cz/uploads/images/aicko-dependabot-agent-skills-apm-20261105.webp)

## Proč verzovat skills stejně jako knihovny

Skill není dekorace. Je to text, který agentovi říká, jak má dělat [code review](https://aicko.cz/content/code-review-podle-rizika-jak-ho-nastavit-v-tymu-s-ai), psát testy nebo nasazovat. Když se změní, změní se chování agenta, přestože v aplikačním kódu nepřibyl jediný řádek. Přesně tohle se při kopírování souborů mezi repozitáři ztrácí.

Typické bolesti, které řeší správa závislostí:

- **Drift:** stejný skill ve třech repozitářích, každý trochu jiný.
- **Žádná historie:** nevíš, kdy a proč se instrukce změnila.
- **Ruční aktualizace:** upstream skill se zlepšil, ale nikdo si toho nevšiml.
- **Reprodukovatelnost:** kolega po `git clone` dostane jiné chování agenta než ty.

Pokud skills teprve zavádíš, začni u článků [Claude Skills návod: vlastní dovednosti agenta](https://aicko.cz/content/claude-skills-navod-vlastni-dovednosti-agenta) a [Subagenti vs skills](https://aicko.cz/content/subagenti-vs-skills-kdy-agenty-slozit-do-jedne-smycky). Tady už předpokládám, že skills máš a chceš je udržovat.

## Co je Agent Package Manager (APM)

APM je open-source správce závislostí pro konfiguraci AI agentů. Vyvíjí ho organizace Microsoft na GitHubu a běží pod licencí MIT. Podle [dokumentace](https://microsoft.github.io/apm/) umí nasadit balíčky pro [GitHub Copilot](https://aicko.cz/content/github-copilot-dynamic-workflows-multi-agent-proces-v-praxi), [Claude Code](https://aicko.cz/content/claude-code-scheduled-tasks-lokalni-vs-cloud-2026), Cursor, Codex, Gemini, OpenCode, Windsurf, Kiro i Grok Build. Každý nástroj dostane jen ty primitivy, které podporuje.

Základ tvoří tři věci:

- **`apm.yml`** je manifest. Povinné jsou dvě pole, `name` a `version`. Závislosti jdou do `dependencies.apm`, MCP servery do `dependencies.mcp`.
- **`apm.lock.yaml`** je lockfile. Má se commitovat. Zapisuje přesný commit, ze kterého se balíček nainstaloval, a nasazené soubory. Díky tomu dostane každý po klonu totéž.
- **`apm install`** stáhne závislosti a rozloží je do složek konkrétního agenta.

Instalace podle oficiální stránky:

```bash
brew install apm
# Linux/macOS bez Homebrew
curl -sSL https://aka.ms/apm-unix | sh
# Windows
irm https://aka.ms/apm-windows | iex
```

Zkušební balíček si vyzkoušíš jedním příkazem: `apm install microsoft/apm-sample-package`.

## Jak vypadá apm.yml se skills

Závislost je zkratka `vlastnik/repozitar`, volitelně s `#ref`. Dokumentace uvádí tyto podoby:

- `microsoft/apm-sample-package#v1.0.0` je tag (neměnný),
- `owner/repo#main` je větev, která se může kdykoli změnit,
- `ComposioHQ/awesome-claude-skills/brand-guidelines` je jen podsložka repozitáře, tedy jeden skill,
- `./packages/my-shared-skills` je lokální cesta, jen pro vývoj.

Jednoduchý manifest může vypadat takto:

```yaml
name: moje-tymove-skills
version: 1.0.0

dependencies:
  apm:
    - ComposioHQ/awesome-claude-skills/brand-guidelines#v1.2.0
    - moje-firma/agent-standardy/skills/code-review#v2.0.1
  mcp: []
```

Tag v `ref` je důležitý. Když ho vynecháš, APM tě na nepřipnutou závislost upozorní a stahovat budeš to, co je zrovna na výchozí větvi.

**Tip:** `ref` může být i rozsah semver, třeba `^1.2.0`. APM ho podle manifestu vyhodnotí proti vzdáleným tagům a vybere nejvyšší shodu. Dependabot se o rozsazích v oznámení ani v diskusi nezmiňuje, proto pro něj raději používej konkrétní tagy.

## Krok za krokem: převod skills do APM

### 1. Skills dej do jednoho balíčku

Každý skill má vlastní složku v `.apm/skills/`. Jediný povinný soubor je `SKILL.md`, volitelně přidáš `scripts/`, `references/` a `assets/`. Jméno skillu v hlavičce musí odpovídat názvu složky: malá písmena, číslice a pomlčky, nejvýše 64 znaků. Popis má mít maximálně 1024 znaků.

### 2. Zkus instalaci nanečisto

Nejdřív se podívej, kam APM soubory rozloží, a nic nezapisuj:

```bash
apm install --dry-run --target claude
apm install --target claude
```

Pro [Claude Code](https://aicko.cz/content/claude-code-mcp-tasks-elicitations) skončí skill v `.claude/skills/<name>/SKILL.md`. Cursor, Codex, Gemini, Copilot i OpenCode používají podle dokumentace `.agents/skills/<name>/SKILL.md`.

### 3. Zkontroluj skill auditem

```bash
apm audit --file .apm/skills/<name>/SKILL.md
```

Instalace navíc skenuje skryté znaky Unicode. Jediný neviditelný znak v souboru může instalaci zablokovat, což je dobrá pojistka proti podvrženým instrukcím.

### 4. Připni verze a commitni lockfile

Každou závislost zapiš s tagem a po instalaci commitni `apm.yml` i `apm.lock.yaml`. Dependabot lockfile přegeneruje jen tehdy, když v repozitáři už je, a bez něj ti nikdo nezaručí stejné chování agenta na dvou počítačích.

## Zapnutí Dependabota pro APM

Podle changelogu stačí přidat do `.github/dependabot.yml` položku `apm`, nasměrovat ji do složky s `apm.yml` a zvolit plán. Příklad (hodnoty `directory` a `interval` si uprav):

```yaml
version: 2
updates:
  - package-ecosystem: "apm"
    directory: "/"
    schedule:
      interval: "weekly"
```

GitHub k tomu oznámení nezveřejnil hotový YAML, takže ber ukázku jako ověřený tvar podle popisu v changelogu, ne jako kopii z dokumentace. První týden si projdi, co přijde.

**Pozor:** v diskusi v repozitáři dependabot-core (issue č. 14350) se u APM objevila poznámka o beta stavu a volbě `enable-beta-ecosystems: true`. Changelog z 3. listopadu už mluví o obecné dostupnosti na github.com pro všechny tarify. Kdyby ti GitHub konfiguraci odmítl, zkus tuhle volbu přidat.

### Co přesně Dependabot umí

Podle oznámení a diskuse v dependabot-core:

- **Tagy** (`owner/repo#v1.2.0`) posune na nejnovější release tag.
- **Úplné SHA commitu** (40 znaků) posune na commit nejnovějšího anotovaného tagu a přidá komentář s verzí.
- **Větve** (`owner/repo#main`) neaktualizuje v manifestu, ale posune commit zapsaný v `apm.lock.yaml`.
- **Lockfile** přegeneruje pomocí `apm lock`, ale jen pokud už existuje.
- Pokrývá `dependencies` i `devDependencies` a funguje s volbami `groups`, `ignore` a `cooldown`.

Dependabot se tedy chová stejně jako u npm nebo Composeru. Můžeš skupinovat aktualizace do jednoho PR, ignorovat konkrétní balíčky nebo nastavit prodlevu, než nová verze dozraje.

### Co Dependabot nedělá

- **Jen verzovací aktualizace.** Bezpečnostní aktualizace (security updates) APM zatím nepodporuje.
- **Nepřipnuté položky, zkrácené SHA, lokální cesty a MCP servery** nechává beze změny.
- **Enterprise Server:** na GitHub Enterprise Server dorazí podpora ve verzi 3.24.

V praxi z toho plyne jedno pravidlo: bez tagu není co aktualizovat.

## Jak reviewovat pull request se skills

Tohle je nejdůležitější část. PR od Dependabota s novou verzí skillu není rutinní bump knihovny. Mění instrukce, podle kterých tvůj agent jedná, a to může ovlivnit i to, co smí spouštět.

Checklist k review:

1. **Podívej se na diff `SKILL.md`,** ne jen na číslo verze. Co se změnilo v pravidlech?
2. **Hledej nové skripty.** Skill může přibalit `scripts/`, které agent spustí.
3. **Zkontroluj oprávnění.** Přibyla instrukce typu „spusť bez ptaní“ nebo odkaz na neznámou doménu?
4. **Projdi lockfile.** Měl by se změnit commit u konkrétního balíčku, ne celý strom.
5. **Spusť skill na jednom známém úkolu** a porovnej výstup s tím, co dával dřív.

Pokud tvůj agent pracuje s citlivými daty, přečti si ještě [jak auditovat bezpečnost AI agentů](https://aicko.cz/content/jak-auditovat-bezpecnost-ai-agentu-2026) a [bezpečnostní kroky pro rozšíření VS Code a Cursoru](https://aicko.cz/content/bezpecnost-rozsireni-vs-code-a-cursoru-7-kroku). Stejná logika platí pro skills: třetí strana ti dodává kód, který se spouští tvým jménem.

**Tip:** nastav v repozitáři pravidlo, že PR měnící `.claude/skills/` nebo `.agents/skills/` schvaluje vždy člověk z týmu, nikdy automatický merge.

## Týmové nastavení, které funguje

Z praxe jde o tři vrstvy:

- **Firemní balíček** se standardy ([code review](https://aicko.cz/content/ai-code-review-nastroje-srovnani-greptile-coderabbit-bugbot), testy, styl commitů) s tagovanými verzemi, který si repozitáře instalují přes APM.
- **Projektový manifest** v každém repozitáři, kde je jen to, co projekt skutečně používá.
- **Dependabot s týdenním plánem** a skupinováním, ať nedostaneš každý den jiný PR.

Pro sdílení kontextu mezi agenty se hodí i [AGENTS.md](https://aicko.cz/content/agents-md-jak-nastavit-ai-coding-agenta). APM umí instrukce kompilovat do AGENTS.md nebo CLAUDE.md, takže jedno místo pravdy obslouží víc nástrojů. Autoři zmiňují i varování: jakmile na sdíleném kontextu závisí víc týmů, je z něj součást platformy a potřebuje vlastníka a řízení změn.

## Než to nasadíš

Návod vychází z oficiálního changelogu GitHubu, dokumentace APM a diskuse v dependabot-core, ne z testu v ostrém repozitáři. Ukázkový `dependabot.yml` proto nejdřív vyzkoušej na testovacím repozitáři a první pull requesty od Dependabota projdi ručně.

## Časté otázky

### Co je Agent Package Manager (APM)?

Open-source správce závislostí pro konfiguraci AI agentů od Microsoftu. Přes soubor `apm.yml` a lockfile `apm.lock.yaml` instaluje skills, prompty, instrukce a MCP servery pro Copilot, Claude Code, Cursor, Codex a další.

### Aktualizuje Dependabot i MCP servery?

Ne. MCP servery v `apm.yml` nechává Dependabot beze změny, stejně jako lokální cesty, nepřipnuté položky a zkrácené SHA.

### Hlídá Dependabot i bezpečnostní zranitelnosti skills?

Zatím ne. Oznámení výslovně říká, že podpora pokrývá verzovací aktualizace, ne bezpečnostní. Proto si každý PR musíš projít ručně.

### Musím mít apm.lock.yaml?

Nemusíš, Dependabot ho aktualizuje jen tehdy, když existuje. Doporučuju ho ale commitovat, protože zaručuje stejný obsah balíčků po každém klonu.

### Funguje to i s Claude Code?

Ano. APM má cíl `claude` a rozloží skill do `.claude/skills/<name>/SKILL.md`. Ostatní nástroje jako Cursor, Codex nebo Gemini používají složku `.agents/skills/`.

## Shrnutí

Skills jsou závislosti jako každé jiné. APM jim dá manifest a lockfile, Dependabot k tomu přidá pravidelné pull requesty. Nejdřív připni verze tagy, commitni `apm.lock.yaml`, zapni týdenní plán a každý PR si přečti jako změnu kódu, ne jako číslo verze. Vyzkoušej to nejdřív na jednom repozitáři.

## Related

- [Obsah: Vibe coding](https://aicko.cz/obsah/vibe-coding)
- [Claude AI](https://aicko.cz/ai-tools/claude)
- [GitHub Copilot](https://aicko.cz/ai-tools/github-copilot)
- [OpenCode](https://aicko.cz/ai-tools/opencode)
- [Cursor](https://aicko.cz/ai-tools/cursor)
- [Gemini](https://aicko.cz/ai-tools/gemini)

---
Zdroj: AIčko.cz. Při citaci uveďte název webu a odkaz na https://aicko.cz/content/dependabot-pro-agent-skills-verzovani-pres-apm
