Saját készségeket tölthetnek fel a Mintlify ügynökéhez

Mappákból, ZIP- és SKILL-fájlokból is működik

A Mintlify október 23-i bejelentése szerint a készség egy olyan mappa, amelynek központi eleme egy SKILL.md fájl. Ehhez referenciafájlok és példák is tartozhatnak. Az ügynök mappákat, .zip fájlokat, önálló készségfájlokat és .skill fájlokat is kezel, köztük olyanokat, amelyeket a felhasználók Claude-ból exportáltak.

A feltöltés egyetlen kattintással elindítható a szervezet készségoldaláról. A készséget személyes vagy szervezeti szinten lehet hozzáadni. A személyes készségek csak az adott felhasználó kéréseire vonatkoznak, a szervezeti készségek viszont minden csapattag munkájára érvényesek. Így egyetlen alkalommal feltöltött stíluskalauz minden olyan szerkesztésre hatással lehet, amelyet az ügynök a csapat tagjainak készít.

Az ügynök minden készség leírását elolvassa, majd akkor választja ki, ha a feladat megfelel annak. A Mintlify szerint a dokumentációk már most is közzétesznek egy generált készséget a /.well-known/skills/ címen, hogy külső ügynökök URL-en keresztül megismerhessék a terméket. Az egyedi készségek ennek fordított irányát biztosítják, vagyis a csapat ezekkel taníthatja meg a Mintlify ügynökének a saját írási szabályait.

A visszatérő szerkesztői hibákból érdemes kiindulni

A Mintlify első készségként olyan szabályokat javasol, amelyek a felülvizsgálatok során rendszeresen visszatérő megjegyzéseket rögzítik. Egy stíluskalauz meghatározhatja a csapat hangvételét, a termékneveket, a címsorok írásmódját és az elkerülendő kifejezéseket. Külön készség írhatja le, milyen elemeket kell tartalmaznia egy gyors kezdési útmutatónak, és miben tér el ettől egy referenciaoldal.

A változásnaplóhoz létrehozható olyan szabályrendszer, amely rögzíti a bejegyzések formátumát, és három jó példát is tartalmaz. Egy ellenőrzési készség az ügynök által készített pull request megnyitása előtt keresheti a nem alátámasztott állításokat, a hiányzó előfeltételeket és azokat a lépéseket, amelyekhez nem tartozik várt kimenet. Az API-referenciákhoz külön szabályok adhatók a paraméternevekre, a szakaszok sorrendjére és a hibakódok formázására.

A cég szerint érdemes egy készséget egyetlen feladatra korlátozni. A változásnapló formátuma és az általános stíluskalauz ezért külön fájlban lehet, így csak az alkalmazható szabályok töltődnek be. A fő SKILL.md fájlt körülbelül 500 sor alatt javasolják tartani, a hosszabb terminológiai listákat pedig referenciafájlokba érdemes áthelyezni.

Nyílt forrású példák és használati feltételek

A Mintlify több nyílt forrású készséget is ajánl kiindulópontként. A GitHub awesome-copilot tárházának documentation-writer készsége a dokumentációs oldalakat a Diátaxis négy típusának egyikébe sorolja, és írás előtt jóváhagyást kér a vázlathoz. A technical-writer külön készségeket használ a tervdokumentumokhoz, változásnaplókhoz, üzemeltetési útmutatókhoz és esemény utáni jelentésekhez.

A Peter Yang nevéhez kötött no-ai-slop több mint 20, mesterséges intelligenciára jellemző írási mintát szűr ki. A készség felsorolja az elvégzett módosításokat, és felismerési módot is kínál, amely átírás nélkül jelzi a problémás szövegrészeket. Az Anthropic készségtárházában a brand-guidelines és az internal-comms példát ad márkaelőírások, állapotfrissítések, hírlevelek és incidensjelentések szabályainak rögzítésére.

A Mintlify arra kéri a felhasználókat, hogy szervezeti szintű feltöltés előtt olvassák el a készséget, és ellenőrizzék a licencét. A no-ai-slop MIT-licencű, míg a Wikipédia útmutatóját felhasználó készségekre a CC BY-SA feltételei vonatkozhatnak.

A funkció Pro és Enterprise csomagban érhető el

A készség leírása határozza meg, mikor aktiválódik. A Mintlify szerint az ügynök előzetesen csak a készség nevét és leírását olvassa, ezért a leírásnak olyan kifejezéseket kell használnia, amelyeket a felhasználók ténylegesen beírnak. A példák, a jó oldalakra mutató hivatkozások és a folyamat végén futtatható ellenőrzőlista szintén segíthetik a használatot.

A beállításhoz a szervezet készségoldalát kell megnyitni, az Add Skill lehetőséget választani, majd feltölteni a mappát, a ZIP- vagy a SKILL-fájlt. Ezután ki kell választani, hogy személyes vagy szervezeti készségről van-e szó. A Mintlify azt javasolja, hogy a felhasználó kérjen az ügynöktől egy, a készséghez illő feladatot, majd az eredményt vesse össze a készség ellenőrzőlistájával.

Az egyedi készségek minden olyan helyen működnek, ahol az ügynök használható. Ehhez a Mintlify közlése szerint Pro vagy Enterprise csomag szükséges.