Jak jsem vytvořil katalog Aimee coaching skills
S rostoucí knihovnou koučovacích dovedností (skills), která je organizovaná do samostatných adresářů a konfiguračních JSON souborů, se stalo náročným udržet si rychlý přehled. Stakeholdeři potřebovali okamžitý, čitelný seznam všech dostupných schopností AI agenta bez toho, aby museli otevírat desítky podadresářů.
Cílem bylo přeměnit strukturovaná, ale fragmentovaná data na jeden soudržný dokument pro jednoduchou orientaci.
Problém, který jsem řešil
Potřeba dynamicky vygenerovat "Table of Contents" nebo katalog z distribuované souborové struktury, kde každý adresář reprezentuje jednu entitu (skill). Místo manuálního kopírování textů z jednotlivých souborů jsem zadal úlohu AI: projít složku `@Skills` a vytvořit přehledný seznam s konkrétními parametry (Název, Tagline, Overview).
Jak jsem ho vyřešil
AI zmapovala adresářovou strukturu, aby identifikovala všechny relevantní podadresáře. Následně využila konzistenci projektu – fakt, že každý skill má svůj `skill.config.json`. Místo čtení celých textů cíleně extrahovala jen požadovaná metadata z 13 různých souborů najednou a ta transformovala do čistého Markdown formátu.
Výsledek: soubor `aktualne-skills.md`, který slouží jako aktuální katalog 13 klíčových AI dovedností. Tento dokument okamžitě poskytl vhled do obsahu kurzu bez technického balastu. Transformace z "kódu" (JSON) do "čitelného textu" (Markdown) proběhla bez ztráty kontextu, čímž se vytvořil most mezi vývojem a produktovým managementem.
Jak to funguje v praxi
To, co by člověku trvalo 15 minut otevírání a kopírování, proběhlo v sekundách. Eliminace rizika překlepů nebo vynechání skillu. Využití existující JSON schémy umožnilo okamžitou orientaci v datech.
Co jsem se naučil
Síla konvencí. Důsledné dodržování struktury (všechny skilly mají stejný config soubor) je klíčem k jednoduché automatizaci dokumentace.
Dokumentace jako kód. Uchovávání metadat v JSON formátu umožňuje kdykoli vygenerovat aktuální katalog, místo udržování statického dokumentu, který rychle zastará.
Agregace nad tvorbou. AI v tomto případě nic "nevymýšlela", ale "agregovala". Tato schopnost syntézy je často cennější než generování nového textu.
Proč to stojí za to
Když máš distribuovanou souborovou strukturu a chceš z ní vytvořit katalog, nemusíš to dělat manuálně. Můžeš použít AI na automatickou agregaci metadat z více souborů.
Aimee coaching skills katalog je teď součástí mého workflow. Šetří mi čas, protože nemusím manuálně kopírovat texty. A zároveň mám kontrolu nad tím, jak katalog vypadá, protože všechno je v Markdown formátu.
Pokud máš podobný problém – potřeba vytvořit katalog z distribuované struktury – zkus to. Možná zjistíš, že je to jednodušší, než sis myslel.
Časté otázky
Proč ukládat metadata do JSON souborů místo jednoho centrálního dokumentu?
Protože metadata patří k tomu, co popisují. Když máš `skill.config.json` přímo v adresáři daného skillu, informace se nerozjedou. Centrální dokument rychle zastará – někdo přidá nový skill a zapomene ho tam dopsat. S distribuovanou strukturou tohle nehrozí.
Jak dlouho trvá vygenerovat katalog z 13 souborů?
Sekundy. Manuálně by to bylo 15 minut otevírání adresářů, hledání správných polí v JSON a kopírování. Plus riziko, že něco vynecháš nebo uděláš překlep. AI to udělá systematicky a bez chyb.
Co když nemám konzistentní strukturu souborů?
Pak to bude složitější. Síla tohoto přístupu je v konvencích – všechny skilly mají stejný `skill.config.json` se stejnými poli. Pokud máš chaos, nejdřív sjednoť strukturu. Investice do konzistence se vrátí při každé další automatizaci.
Proč Markdown a ne třeba Excel nebo Notion?
Markdown je plain text – verzuješ ho v Gitu, otevřeš kdekoli, snadno ho transformuješ do jiných formátů. Excel nebo Notion jsou fajn pro jiné účely, ale pro dokumentaci jako kód je Markdown ideální. Navíc ho AI generuje přirozeně.
Dá se tento přístup použít i na jiné typy dokumentace?
Určitě. Kdekoli máš strukturovaná data rozložená do více souborů – API endpointy, komponenty, produktové featury. Princip je stejný: konzistentní struktura + AI agregace = aktuální katalog bez manuální práce.
Tom