> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Twórz pakiety wielokrotnego użytku dla zewnętrznych agentów i Automations

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.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### 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.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

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.


## Related topics

- [MCP](/docs/pl/mcp-server.md)
- [Automations](/docs/pl/automations.md)
- [Witamy](/docs/pl/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.