---
title: Katalog skillů: skill kaloko a nástroje, které k němu doporučujeme
description: Co skill kaloko agentovi ukládá, co pokrývá každá reference a které skilly a nástroje třetích stran k němu sednou, u každého s důsledky: co běží kde, jaká data opouštějí počítač, kdy ho nepoužít.
seo_title: Katalog skillů: kaloko, reference a doporučené nástroje
seo_description: Skill kaloko pro Claude Code a Codex, jeho reference a nástroje, které doporučujeme vedle něj pro QA s agentem.
query: skilly pro QA s AI agentem
kind: catalog
order: 20
demo: false
---
Bez skillu agent hádá, kdy má flow projít, co se počítá za hotové a jestli smí sáhnout na produkci. Skill je sada pravidel, kterými se agent řídí bez připomínání. Každý přidaný skill mění, co agent dělá sám od sebe, jaké příkazy spouští a jaká data opouštějí počítač, a většina katalogů skilly jen vyjmenuje. Tenhle to říká u skillu `kaloko` i u každého nástroje, který k němu doporučujeme.

## Skill kaloko

Router `SKILL.md` říká, kdy ho použít, co znamená hotovo, co smí bez ptaní (prostředí local a review, testovací data tam, oprava mechaniky scénáře) a co chce člověka (změna kritérií, produkce, nahrání). Detaily jsou v referencích:

- **První běh** (`reference/first-run.md`): instalace, `kaloko login`, ukázkový běh v nové organizaci, první flow z adresy nebo z úkolu. Důsledek: agent se přihlásí přes prohlížeč, až když kód schválíte.
- **Akceptace** (`reference/acceptance.md`): psaní `ACCEPTANCE.md` a `scenario.yml`; jedna kontrola na kritérium; deterministická pro počitatelné, sémantická pro úsudek, manuální pro kontrolujícího; packy kontrol (seo, a11y, perf a další) jako kondice, která jen radí, pack design jako přijetí; consent dialog jako výchozí první krok. Důsledek: plán je zdroj pravdy, agent sám rozsah nerozšiřuje.
- **Provedení** (`reference/execution.md`): start, walk, capture, mail, sdílený prohlížeč na prostředí, průchod jen tím, čeho se změna týká (`--affected`), víc jazyků najednou a selektory, které se posunuly (`--heal`). Důsledek: jeden profil Chromu na prostředí; produkční běh nikdy nesdílí cookies s lokální prací.
- **Hodnocení** (`reference/evaluation.md`): jak se skládají deterministické výsledky a sémantický evaluátor, vizuální evaluátor a jeho zdůvodnění jednou větou, prahy, hlášení výsledků bez vymýšlení. Důsledek: textový evaluátor vidí zredukovanou osnovu; vizuální vidí zmenšený screenshot, jen u kritérií `vision: true` a nejistých odpovědí.
- **Prostředí** (`reference/environments.md`): co se smí kde, brány, účty a uložená přihlášení; produkce vždy jen pro čtení. Důsledek: CLI zablokuje zápisy na produkci, i když se agent pokusí.
- **Prohlížeče a zařízení** (`reference/devices.md`): WebKit a Firefox, předvolby telefonů, tabletů i televize, tmavý režim, omezený pohyb, nainstalované webové aplikace. Důsledek: každá kombinace je jeden záchyt, takže agent drží matici u toho, čeho se úkol týká.
- **Aplikace** (`reference/apps.md`): Android přes adb, iOS Simulator i skutečné iPhony, Electron, macOS a Windows aplikace, nebo obrazovky z Maestra, Appia či XCUITestu i s UI stromem. Důsledek: emulátory a simulátory smí agent resetovat; skutečná zařízení a skutečné účty chtějí člověka.
- **Stacky** (`reference/stacks.md`): jeden krok pro mnoho stránek jedné šablony (články, produkty, SEO katalog) ze sitemapy, výpisu, souboru nebo skriptu. Důsledek: deterministické kontroly na každé stránce, sémantické na vzorku, takže náklady zůstanou omezené.
- **Import** (`reference/import.md`): screenshoty, reporty a trace z Playwrightu i průchody agentů jako běh. Důsledek: nic se neprochází znovu; kontrolující uvidí to, co importujete.
- **Nahrávání** (`reference/recording.md`): video kroku nebo celého flow, průběh kroků a video průchodu. Důsledek: videa zabírají úložiště, takže agent nahrává, když problém screenshot neukáže.
- **CI** (`reference/ci.md`): workflow, které projde náhled každého pull requestu a okomentuje ho. Důsledek: než agent workflow zapíše nebo nahradí, zeptá se.
- **Spolupráce** (`reference/collaboration.md`): sdílení, komentář v PR, režim kontroly a schválení převzatá u nezměněných kroků, zpětná vazba, inbox, verdikty, referenční běhy, porovnání, podepsaný záznam o převzetí, úklid. Důsledek: agent čte zpětnou vazbu, než pokračuje, a nikdy neschvaluje za člověka.
- **Integrace** (`reference/integrations.md`): úkoly v Jiře a Linearu, kanály po projektech, hostované běhy podle plánu. Důsledek: jeden úkol na skutečný problém; kanály a propojení zakládá admin.
- **MCP** (`reference/mcp.md`): běhy, zpětná vazba, verdikty, inbox, komentáře, fronta ke kontrole a úkoly jako nástroje. Důsledek: zápis potřebuje token se správným rozsahem; zachytávání a nahrávání zůstává v CLI.
- **Dokumentace a changelog** (`reference/docs.md`): vizuální changelog a návody s odkazy na kroky, zastaralé sekce, překlady, exporty, nástroje pro release. Důsledek: agent připraví návrh a zkontroluje ho; zapsat release a publikovat dokumentaci počká na člověka.
- **Podklady pro manuály** (`reference/documentation.md`): manuály a kurzy obnovované z nejnovějších přijatých záchytů. Důsledek: když o to požádáte, dokumentaci plní jen přijaté běhy.
- **Design** (`reference/design.md`, `reference/portable-html.md`): živé HTML kroky, koncepty a verze, import z Figmy, knihovna obrazovek, specifikace kroku a odchylky při implementaci schváleného návrhu. Důsledek: verzi publikuje a referenci nastaví agent, jen když to člověk řekne.

## Doporučujeme vedle něj

- **Playwright MCP** (řízení prohlížeče agentem): připojte ho na CDP endpoint z `kaloko browser start`, aby kroky řízené agentem běžely ve stejném profilu jako skriptované. Důsledek: agent vidí obsah stránky lokálně; k třetí straně nic neodchází.
- **axe** (pravidla přístupnosti): pack `a11y` pokryje názvy, popisky, nadpisy, kontrast, landmarky a průchod tabulátorem; kvůli celé sadě pravidel axe ho spusťte ve skriptu kroku a výsledek uložte jako přílohu. Důsledek: jen lokálně.
- **Lighthouse** (výkon): pack `perf` už z průchodu přečte LCP, CLS, TTFB a váhu stránky; kvůli celému reportu použijte stejný vzor, jeden report na klíčovou stránku. Důsledek: na sdílených runnerech šumí; porovnávejte trendy, ne jednotlivá čísla.
- **Příprava testovacích dat ve vašem projektu**: krok `prepare` pro review a staging, aby scénáře vytvářely jen to, co potřebují. Důsledek: na produkci nikdy.

## Kam jdou data

- Screenshoty, HTML, e‑maily: váš počítač a vaše organizace v Kaloku (úložiště Cloudflare, provozovatel pod právem EU). Soubory se servírují z oddělené domény přes krátkodobě podepsané odkazy.
- Sémantické hodnocení: zredukovaná textová osnova se zamaskovanými e‑maily a tokeny evaluátoru, který nastavíte (výchozí JEV od TypeSafe), jen u kritérií `semantic`. Vizuální evaluátor (Anthropic, s vaším klíčem nebo přes Kaloko) dostane zmenšený screenshot, jen u kritérií `vision: true` a odpovědí, kterými si textový evaluátor není jistý; `evaluators: { vision: false }` ho vypne.
- Sinfinu nic nad rámec toho, co služba potřebuje k zobrazení vaší plachty.

## Otázky

### Můžu napsat vlastní sub‑skill?

Ano: projektové skilly mohou přidat konvence (cesty, testovací data, jazyky) a skill kaloko se jimi řídí tam, kde jsou konkrétnější.

### Funguje skill i s jinými agenty než Claude Code a Codex?

Každý agent, který umí spouštět shellové příkazy, se může řídit `SKILL.md`; `kaloko init` bez `--agent` nic neinstaluje a nechá CLI skriptům a CI.
