Skip to main content
Skills to pakiety instrukcji wielokrotnego użytku wraz z opcjonalnymi plikami pomocniczymi. Pozwalają Twojemu zespołowi raz zdefiniować powtarzalny sposób wykonania zadania, a następnie stosować go spójnie w całym Flowglad. Każdy Skill ma nazwę, slug polecenia ukośnikowego, opis oraz instrukcje napisane w Markdown. Pliki pomocnicze mogą dostarczać dodatkowy kontekst lub zasoby potrzebne do wykonania tych instrukcji.

​
Używaj Flowglad jako biblioteki Skills swojego zespołu

Flowglad przechowuje każdy Skill jako wersjonowany pakiet. Opublikowanie zmiany tworzy nową rewizję zamiast zastępować poprzedni pakiet w miejscu. Administratorzy organizacji mogą otworzyć History danego Skilla, aby przejrzeć jego rewizje, porównać zmiany, przywrócić wcześniejszą rewizję lub odrzucić wersję roboczą, gdy te działania są dostępne. Dzięki temu Twój zespół ma jedno zarządzane miejsce do utrzymywania instrukcji wielokrotnego użytku, a jednocześnie zachowuje informację o tym, która wersja była aktywna w danym czasie. Wersje robocze i odrzucone rewizje nie zastępują aktywnej wersji.

​
Zarządzanie Skills przez MCP

Po połączeniu serwera Flowglad MCP agent może przeglądać bibliotekę Skills Twojej organizacji i zarządzać nią w Twoim imieniu:
  • skills.list zwraca Skills widoczne dla połączenia.
  • skills.get zwraca metadane najnowszej i aktywnej rewizji jednego Skilla.
  • skills.create przesyła nowy pakiet Skilla.
  • skills.create_candidate przesyła nową rewizję istniejącego Skilla.
  • skills.publish_revision weryfikuje i publikuje odroczoną rewizję.
  • skills.create_package_upload_session i skills.finalize_package_upload_session przesyłają pakiety zbyt duże, aby wysłać je inline.
  • skills.get raportuje wynik weryfikacji i promocji zaakceptowanego żądania.
Tworzenie lub aktualizowanie Skills wymaga uprawnienia skills:write zarówno w członkostwie członka zespołu w organizacji, jak i w grancie połączenia MCP. Jeśli dodasz to uprawnienie po połączeniu serwera, połącz ponownie Flowglad MCP i autoryzuj skills:write, aby narzędzia zapisu stały się dostępne. Uprawnienia: Administratorzy mają domyślnie dostęp do tworzenia Skills. Aby nadać Contributorowi taki sam dostęp, otwórz Settings → Team, wybierz członka zespołu i włącz Skill Authoring. Daje to uprawnienie do tworzenia i aktualizowania Skills organizacji bez nadawania członkowi zespołu roli administratora.

​
Ładowanie Skills z Flowglad MCP do agenta

Serwer Flowglad MCP ogłasza io.modelcontextprotocol/skills podczas inicjalizacji MCP. Informuje to kompatybilnych klientów, że serwer implementuje metody Skills dla agentów skills/list i skills/get. Każdy zwrócony Skill zawiera URI zasobów skill:// oraz skróty (digests) zawartości; klienci mogą pobrać pliki za pomocą resources/read. Połączenie serwera nie gwarantuje, że klient wywoła skills/list ani zainstaluje zwrócone pakiety. Obsługa różni się w zależności od klienta. Dodaj instrukcję startową do ChatGPT / Codex lub Claude, jeśli chcesz, aby agent odświeżał rejestr Flowglad na początku każdej sesji. Nazewnictwo MCP: Nazwy celowo się różnią. skills.list z kropką to narzędzie Flowglad dla wersjonowanych rekordów Skills Twojej organizacji. skills/list z ukośnikiem to metoda rozszerzenia protokołu MCP służąca do wykrywania pakietów Skills przeznaczonych dla agentów.

​
Dodawanie instrukcji startowej

Przed rozpoczęciem nowej sesji jednorazowo utwórz katalog docelowy, a następnie dodaj odpowiedni blok instrukcji poniżej.

​
ChatGPT / Codex

Utwórz katalog docelowy dla ChatGPT / Codex za pomocą mkdir -p ~/.agents/skills. Umieść poniższy blok w ~/.codex/AGENTS.md, aby zastosować go do każdego projektu, lub w pliku AGENTS.md repozytorium, aby udostępnić go zespołowi tego repozytorium.
AGENTS.md

​
Claude

Utwórz katalog docelowy dla Claude za pomocą mkdir -p ~/.claude/skills. Umieść poniższy blok w ~/.claude/CLAUDE.md, aby zastosować go do każdego projektu, lub w pliku CLAUDE.md repozytorium, aby udostępnić go zespołowi tego repozytorium.
CLAUDE.md
Możesz poprosić ChatGPT / Codex lub Claude o dodanie odpowiedniego bloku do własnego pliku instrukcji na poziomie użytkownika. Przejrzyj proponowaną zmianę przed jej zaakceptowaniem, ponieważ ten plik wpływa na przyszłe sesje. Instrukcja jest bootstrapem agenta typu best-effort; jeśli Twoje środowisko musi odświeżać Skills deterministycznie, zaimplementuj tę samą synchronizację w zaufanym hooku SessionStart lub w integracji klienta MCP.

​
Gdzie używane są Skills

Skills mają obecnie dwóch konsumentów:
  • Kompatybilni zewnętrzni agenci wykrywają i synchronizują włączone pakiety przez Flowglad MCP, a następnie dopasowują je automatycznie lub wywołują po nazwie.
  • Automations przypinają dokładną opublikowaną rewizję Skilla jako zasób kodu OWS skill-revision. Automation wybiera ścieżkę pakietu i punkt wejścia; kroki agenta otrzymują tylko Skills autoryzowane przez zapieczętowany zestaw uprawnień uruchomienia.
Pierwsza ścieżka dostarcza instrukcje wielokrotnego użytku zewnętrznemu agentowi. Druga dostarcza niezmienny kod i pliki pomocnicze do powtarzalnego uruchomienia Automation. Opublikowane Skills obowiązują w całej organizacji, więc autoryzowana Automation może wybrać tę samą rewizję Skilla w dowolnym Space. Korzystająca z niego Automation i jej uruchomienia pozostają własnością swojego Space; wybranie Skilla nie zmienia tej granicy.

​
Tworzenie i utrzymywanie Skills

Otwórz menu organizacji → Skills → New Skill. Na karcie Skill wprowadź Name, Slug, opcjonalny Description oraz instrukcje wielokrotnego użytku w polu Markdown. Użyj karty Files dla wszelkich pomocniczych plików pakietu, a następnie wybierz Create Skill. Slug składa się z małych liter, cyfr i łączników, zaczyna się od litery lub cyfry i jest tym, co użytkownicy wpisują po /. Utworzenie lub edycja Skilla tworzy wersję roboczą. Na stronie szczegółów Skilla zmiany zapisują się automatycznie; wybierz Publish Draft, aby zweryfikować i opublikować wersję roboczą. Jeśli weryfikacja się nie powiedzie, użyj wyświetlonej diagnostyki, aby poprawić wersję roboczą i opublikować ją ponownie. Użyj History, aby przejrzeć rewizje, przywrócić zastąpioną rewizję lub odrzucić modyfikowalną wersję roboczą, gdy te działania są dostępne. Disable Skill usuwa Skill z wykrywania przez zewnętrznych agentów i z rozwiązywania przez Automations bez usuwania historii rewizji; Enable Skill ponownie go udostępnia.

​
Tworzenie lub edycja Skilla przez MCP

Do tworzenia opartego na pakietach używaj połączonego zewnętrznego klienta MCP. Przed edycją istniejącego Skilla wywołaj skills.get. Użyj skills.create dla nowego pakietu lub skills.create_candidate dla rewizji opartej na bieżącej aktywnej rewizji. Małe pakiety można przekazać inline. W przypadku większych pakietów wywołaj skills.create_package_upload_session, prześlij żądane obiekty i zakończ za pomocą skills.finalize_package_upload_session. Jeśli weryfikacja została odroczona, wywołaj skills.publish_revision. Odpytuj skills.get, aby uzyskać zaakceptowane żądanie cyklu życia oraz jego wynik weryfikacji lub promocji. Opublikowanie Skilla nie tworzy, nie zmienia ani nie aktywuje Automation; gdy jest to potrzebne, jawnie użyj cyklu życia Automation w MCP.

​
Zaczynanie od szablonu Skilla

Strona Skills zawiera Skill Templates. Przeszukaj lub przefiltruj katalog, wyświetl podgląd szablonu i wybierz Copy Skill. Kopia staje się Skillem organizacji, który można edytować i publikować jak każdy inny Skill.

​
Skills i Automations

Skill definiuje, jak wykonać pracę wielokrotnego użytku. Nie decyduje, kiedy ta praca jest wykonywana. Użyj Automation, gdy praca ma być uruchamiana ręcznie, według harmonogramu lub w odpowiedzi na zdarzenie. Automation może przypiąć jedną lub więcej rewizji Skills, aby ta sama implementacja była ponownie używana w kolejnych uruchomieniach.