Obsługiwani agenci

Każdy obsługiwany agent czyta foldery w natywnym formacie Agent Skills: <name>/SKILL.md z metadanymi front matter name i description oraz opcjonalnymi folderami reference/, scripts/ i templates/. Siedmiu z nich czyta ten sam wspólny folder .agents/skills, więc jedna kopia wystarcza dla Codexa, Cursora, Gemini CLI, OpenCode, Windsurfa, GitHub Copilot i Devina. Claude Code czyta tylko .claude/skills. Lokalizacje sprawdzono w dokumentacji każdego dostawcy 29 października 2026 r., a lokalizacje dla Devina i plików instrukcji projektu 11 listopada 2026 r.

Gemini CLI, OpenCode i Windsurf ładują skille przez narzędzie albo @mention, a nie przez polecenie ukośnikowe, dlatego instalator zapisuje też cienkie polecenie z kilku linijek: „użyj skilla <name> z tymi argumentami”. Nigdy nie powiela treści skilla, więc do aktualizacji wystarczą git pull i agent-skills sync.

Dla starszych wersji agentów:

• Cursor, OpenCode i Copilot czytają też .claude/skills w zakresie projektu. Gdy w jednym projekcie działają Claude i jeden z nich, skill może się pojawić dwa razy. Zainstaluj Claude w zakresie użytkownika, a pozostałych w zakresie projektu, albo odwrotnie.
• Codex nadal ładuje przestarzały folder ~/.codex/skills. agent-skills nigdy tam nie zapisuje, a agent-skills doctor ostrzega, gdy stare kopie przesłaniają nowe.

• Windsurf preferuje teraz .devin/{rules,workflows,skills} i czyta .windsurf/* jako zapasowe. agent-skills zapisuje .windsurf/*, co działa zarówno w starej, jak i w przemianowanej aplikacji, oraz wspólny .agents/skills.
• Gemini CLI ogranicza narzędzia plikowe do folderów obszaru roboczego. Skille podlinkowane w zakresie użytkownika są aktywowane przez activate_skill, które daje dostęp do folderu skilla.

Repozytorium trzyma instrukcje dla agentów programujących w jednym pliku, AGENTS.md. Codex, OpenCode i Devin czytają go samodzielnie. Claude Code, Gemini CLI, Cursor i Copilot potrzebują własnego, małego pliku, a agent-skills agent-files generuje te pliki z AGENTS.md, więc nigdy nie piszesz ich ręcznie:

cd ~/code/shop                      # repozytorium z plikiem AGENTS.md
agent-skills agent-files            # zapisz to, czego brakuje lub co jest nieaktualne
agent-skills agent-files --check    # nic nie zapisuje, kończy się kodem 1, gdy wygenerowanego pliku brakuje lub różni się
agent-skills doctor                 # każdy agent: skonfigurowany lub nie dla tego repozytorium

Uruchom je ponownie po git pull agent-skills (nowe wersje skilli) albo po zmianie struktury AGENTS.md. Pliki z odwołaniem nie zawierają instrukcji, więc edycja samego AGENTS.md nie wymaga ponownego uruchomienia. Generator obejmuje siedmiu agentów: Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode, GitHub Copilot i Devin. Windsurf czyta też .agents/skills i AGENTS.md, więc wygenerowane repozytorium działa tam bez dodatkowego pliku.

Każdy plik tekstowy zaczyna się komentarzem, który mówi, że wygenerował go agent-skills agent-files. Claude Code usuwa ten komentarz, zanim przeczyta CLAUDE.md, więc agent nadal widzi pojedynczy wiersz importu. .mcp.json nigdy nie zawiera tokena ani adresu URL z poświadczeniami; serwery dodaje człowiek.

Polecenie można bezpiecznie uruchamiać wielokrotnie:

• Ponowne uruchomienie daje ten sam wynik. Drugie uruchomienie nic nie zmienia i wypisuje 0 change(s); zakończenia wierszy nie mają znaczenia.
• Pliki napisane ręcznie zostają. CLAUDE.md, GEMINI.md, reguła, plik instrukcji lub folder skilla bez znacznika jest zgłaszany i pozostawiany bez zmian, a polecenie kończy się kodem 1. Przenieś jego treść do AGENTS.md i usuń go albo użyj --force: stary plik jest wcześniej zapisywany jako <path>.bak-agent-skills.
• Twoje serwery w .mcp.json zostają. --force pomija taki plik; tylko --force-mcp go zastępuje i zapisuje stary jako .mcp.json.bak-agent-skills. Ta kopia może zawierać blok env z tokenami, więc usuń ją albo zignoruj przed git add.
• Twoje własne skille nigdy nie są zmieniane. Zarządzane są tylko foldery nazwane jak skill z agent-skills.
• Wszystko zostaje w repozytorium. Link wskazujący poza nie jest odrzucany, zgłaszany i pomijany; polecenie kończy się kodem 1.
• --check i --dry-run niczego nie zapisują. --check kończy się kodem 1, gdy wygenerowanego pliku brakuje, różni się albo nie ma znacznika, i jest bramką do użycia w CI. --skills a,b ogranicza, które skille są kopiowane, a --json wypisuje raport do odczytu maszynowego.

agent-skills doctor wypisuje każdego z siedmiu agentów jako configured albo not configured dla bieżącego repozytorium, razem z powodem, na przykład CLAUDE.md missing. Tylko raportuje, niczego nie zmienia.

Wygenerowane pliki nie obejmują jeszcze hooka ochronnego każdego agenta ani ról subagentów z .claude/agents/.

Skribly Agent uruchamia 13 agentów, więcej, niż obsługuje agent-skills. Aider, Amp, Factory Droid, Qwen Code, Goose, Crush i Kimi CLI działają w Skribly, ale nie mają celu instalacji skilli. Zobacz Obsługiwani agenci w Skribly Agent.