Umiejętność Aggrega
Umiejętność Aggrega uczy asystenta AI instalować Aggrega i z niego korzystać. Jest to folder o nazwie aggrega zawierający plik SKILL.md w otwartym formacie Agent Skills, który wielu asystentów odczytuje z własnego folderu umiejętności i wczytuje, gdy żądanie dotyczy Aggrega.
Umiejętność można przekazać asystentowi na dwa sposoby. Asystent, który instaluje wtyczki, otrzymuje ją jako część wtyczki Aggrega, która jednocześnie łączy asystenta z serwerem MCP Aggrega, w jednym kroku: zob. Instalacja wtyczki. W przypadku każdego asystenta, który odczytuje umiejętności z folderu, plik binarny aggrega może zapisać tam umiejętność: zob. Instalacja samej umiejętności.
Instalacja wtyczki
Repozytorium aggrega-ai/aggrega-skills zawiera umiejętność i jest też wtyczką dla wymienionych poniżej asystentów. Instalacja wtyczki dodaje umiejętność Aggrega i łączy asystenta z serwerem MCP Aggrega, który asystent następnie sam uruchamia jako aggrega mcp, więc dla tego asystenta nie są potrzebne ani aggrega skills install, ani kroki ze strony Połączenie z serwerem MCP.
Wtyczka nie instaluje pliku binarnego aggrega. Należy go najpierw zainstalować, jak opisuje sekcja Instalacja pliku binarnego, aby asystent znalazł aggrega w PATH podczas uruchamiania serwera.
Claude Code
claude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsW Claude Code to samo wykonuje polecenie /plugin install aggrega --marketplace aggrega-ai/aggrega-skills.
Codex
codex plugin marketplace add aggrega-ai/aggrega-skillscodex plugin add aggrega@aggregaPierwsze polecenie dodaje repozytorium jako marketplace wtyczek o nazwie aggrega; drugie instaluje z niego wtyczkę aggrega.
GitHub Copilot
W GitHub Copilot CLI:
copilot plugin marketplace add aggrega-ai/aggrega-skillscopilot plugin install aggrega@aggregaVisual Studio Code z GitHub Copilot znajduje wtyczki zainstalowane przez GitHub Copilot CLI i również z nich korzysta. Aby zainstalować wtyczkę bezpośrednio z Visual Studio Code, należy uruchomić Chat: Install Plugin from Source z palety poleceń i podać adres repozytorium, https://github.com/aggrega-ai/aggrega-skills.
Gemini CLI
gemini extensions install https://github.com/aggrega-ai/aggrega-skillsGemini CLI instaluje wtyczkę jako jedno ze swoich rozszerzeń.
Antigravity
agy plugin install https://github.com/aggrega-ai/aggrega-skillsCursor
Cursor wczytuje wtyczkę z folderu w ~/.cursor/plugins/local/. Należy umieścić tam repozytorium, a następnie uruchomić Developer: Reload Window z palety poleceń:
git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggregaKiro
Kiro instaluje wtyczkę jako power. W panelu Powers należy wybrać Add Custom Power, a następnie Import power from GitHub, wpisać adres repozytorium, https://github.com/aggrega-ai/aggrega-skills, i wybrać Install. Kiro uruchamia i zatrzymuje serwer MCP wtyczki razem z power.
OpenClaw
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skillsOpenClaw dwukrotnie pyta o zgodę, zanim zainstaluje wtyczkę ze źródła, którego sam nie zweryfikował. Najpierw zatrzymuje się i prosi o przejrzenie źródła oraz ponowne uruchomienie polecenia z --force; następnie prosi o zgodę na to, co wnosi wtyczka — tutaj umiejętność i serwer MCP — za pomocą --accept-capabilities. Po przejrzeniu repozytorium należy uruchomić:
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities--force zastępuje też zainstalowaną już wtyczkę o tej samej nazwie, dlatego jeśli wcześniej zainstalowano wtyczkę o nazwie aggrega, należy najpierw sprawdzić openclaw plugins list.
Folder, w którym pracuje serwer
Narzędzia Aggrega działają w obszarze roboczym, a wywołanie, które żadnego nie wskazuje, otrzymuje odpowiedź w obszarze roboczym, który serwer znajduje na podstawie folderu, w którym go uruchomiono. Niektórzy asystenci uruchamiają serwer wtyczki we własnym folderze wtyczki, a nie w projekcie — tak robi Codex. Umiejętność nakazuje asystentowi sprawdzić za pomocą narzędzia config-show, w którym obszarze roboczym odpowiada serwer, zanim zacznie pracę w projekcie, a gdy się one różnią, podawać folder projektu jako workspace_root w każdym wywołaniu, które go przyjmuje — pełną ścieżką, ponieważ względny workspace_root jest odczytywany względem obszaru roboczego, w którym serwer już odpowiada.
Instalacja samej umiejętności
Aby zainstalować umiejętność bez wtyczki, należy użyć pliku binarnego aggrega, który zapisuje wbudowaną w niego kopię. Instalacja dla asystentów na komputerze, we wszystkich projektach użytkownika:
aggrega skills install --globalInstalacja dla jednego asystenta w bieżącym projekcie, ze wskazaniem asystenta:
aggrega skills install --agent claude-codeLista asystentów, dla których można ją zainstalować, wraz z folderem odczytywanym przez każdego z nich:
aggrega skills listPolecenie instalacyjne również może ją dodać podczas instalacji pliku binarnego: odpowiednią opcję podaje sekcja Dodawanie umiejętności asystenta podczas instalacji. Zainstalowana w ten sposób umiejętność nie obejmuje połączenia z serwerem: należy połączyć asystenta z serwerem, jak opisuje strona Połączenie z serwerem MCP.
Co umiejętność przekazuje asystentowi
Umiejętność informuje asystenta, jak zainstalować Aggrega, jak połączyć go z serwerem aggrega mcp, jak rozpocząć obszar roboczy i jak prowadzić pętlę tworzenia — scaffold, validate, build — opisaną w sekcji Tworzenie plików Aggrega. Nie zawiera kopii żadnego schematu ani kontraktu encji: po każdą odpowiedź dotyczącą struktury odsyła asystenta do pliku binarnego — do narzędzi MCP, gdy serwer jest połączony, a w przeciwnym razie do wiersza poleceń aggrega — a po znaczenie poszczególnych elementów do opublikowanej dokumentacji.
Umiejętność i serwer MCP pełnią różne zadania, a asystent działa najlepiej z obydwoma. Umiejętność to instrukcje, które asystent czyta; serwer, podłączany przez wtyczkę lub zgodnie z sekcją Połączenie serwera MCP, to narzędzia, które asystent wywołuje. Asystent, który nie instaluje żadnej wtyczki i którego nie ma na liście --agent, pomija umiejętność, a mimo to dociera do tych samych narzędzi i materiałów referencyjnych przez serwer.
Gdzie jest instalowana
Wtyczka przechowuje umiejętność w folderze, w którym asystent przechowuje swoje wtyczki. aggrega skills install zapisuje ją gdzie indziej: bez --global — w projektowym folderze umiejętności asystenta w katalogu głównym obszaru roboczego, gdzie zatwierdzane są umiejętności projektu; z --global — w folderze umiejętności asystenta przypisanym do użytkownika w katalogu domowym, który asystent odczytuje w każdym projekcie. Z --global i bez --agent polecenie wyszukuje asystentów na komputerze, wypisuje każdego znalezionego asystenta oraz to, co go wykryło, a w terminalu pyta przed zapisem. aggrega skills podaje foldery każdego asystenta, to, co wykrywa każdego z nich, oraz to, czego polecenie odmawia nadpisania.
Utrzymywanie aktualności umiejętności
Umiejętność dostarczona z wtyczką jest aktualizowana razem z wtyczką, w sposób, w jaki asystent aktualizuje swoje wtyczki; wtyczkę sklonowaną do lokalnego folderu Cursor aktualizuje się poleceniem git pull w tym folderze, a następnie Developer: Reload Window. Wtyczka łączy serwer uruchamiany przez plik binarny aggrega z PATH, więc narzędzia i materiały referencyjne odpowiadają zainstalowanemu plikowi binarnemu.
Umiejętność jest też wbudowana w plik binarny aggrega, więc kopia zapisywana przez aggrega skills install odpowiada zainstalowanej wersji. Po aktualizacji Aggrega — polecenie instalatora aktualizuje plik binarny w miejscu — należy ponownie uruchomić to samo polecenie aggrega skills install, aby zaktualizować tę kopię do nowej wersji.