Všichni průvodci › Skilly a nástroje
Skilly a nástrojeKatalog skillů: skill kaloko a nástroje, které k němu doporučujeme
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.
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.mdascenario.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: truea 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
a11ypokryje 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
perfuž 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
preparepro 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: truea 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.