Dovednost je jeden adresář pod sekcí dovedností vrstvy obsahující SKILL.md, objevený zdrojovou třídou `skill`, kterou čtou shellový nástroj i spustitelný program v Rustu, takže přidání souboru je celá registrace a katalog, příkaz, doctor, MCP i web se z něj odvozují

Co to znamená

Dovednost je .ai/repo/skills/<id>/SKILL.md: YAML front matter splňující share/schemas/majordomus/skill/skill.v1.schema.json nad tělem v Markdownu, které je postupem, s volitelným examples/*.md vedle. Nic ji neregistruje. Zdrojová třída skill v .ai/repo/knowledge/sources.yaml říká, které sledované soubory jsou dovednosti, a tuto jedinou deklaraci čtou shellový nástroj, spustitelný soubor v Rustu i generátor webu. Přidání adresáře a jeho sledování způsobí, že dovednost existuje pro majordomus skills list, pro doctor, pro web i pro MCP; jeho odstranění ji ze všech zmizí.

Princip

share/kinds.yaml deklaruje druh skill (Markdown, povinný front matter, identita id, schéma skill) a schéma nese x-majordomus-allow: skill, takže majordomus generate allow zapíše allow-list, který čte shellový validátor. lib/skills.sh odvodí jeden katalog z mj_knowledge_discover — řádků tříd skill a skill_example, v pořadí indexu — a vše ostatní je projekce tohoto katalogu: skills list|show|check, validátor doktríny mj_validate_skills a skills.json a site/content/skills/, které scripts/generate-site-data zapisuje. Spustitelný soubor v Rustu indexuje tytéž soubory přes tutéž třídu a servíruje každý jako majordomus://skill/<id>, vypsatelný přes majordomus_list podle druhu a čitelný přes majordomus_get a resources/read, bez kódu, který by o existenci druhu věděl.

Jak to vidět

mkdir -p .ai/repo/skills/release-notes && $EDITOR .ai/repo/skills/release-notes/SKILL.md
git add .ai/repo/skills/release-notes
majordomus skills list                                  # release-notes  active  v1  ...
majordomus skills check                                 # OK skill 1 skill(s) ...
apps/majordomus-cli/target/debug/majordomus mcp --inspect | grep skill/   # resource majordomus://skill/release-notes
scripts/generate-site-data && ls site/content/skills/   # release-notes.md
git rm -r .ai/repo/skills/release-notes && majordomus skills list          # gone everywhere

Co nepokrývá

Nesledovaný soubor není dovednost: objevování čte git index, nikdy pracovní strom, takže dovednost existuje, jakmile je přidána. Kterou dovednost má úloha načíst, se zde nerozhoduje; generované instrukce říkají workerovi, aby načetl jen dovednosti, o nichž úloha je.

Proč existuje

Zdrojový materiál tohoto nástroje vedl katalog pěti set čtyřiceti šesti agentů, z nichž jeden byl zaregistrován u čehokoli, co běželo. Dovednost, kterou je třeba jmenovat na druhém místě, aby existovala, je dovednost, která bude existovat na jednom místě a na druhém ne; dovednost, která existuje, protože existuje její soubor, se od vlastního soupisu odchýlit nemůže.