# Dokumenty i pisanie: skille Office, doc-coauthoring i writing-guidelines

URL: https://developertoolkit.ai/pl/ecosystem/skills/document-and-writing-skills/
Description: Skille docx, pdf, pptx i xlsx od Anthropic, doc-coauthoring, writing-guidelines Vercela i humanizer: instalacja i łańcuch od szkicu RFC do prezentacji.

Skille do dokumentów i pisania pozwalają agentowi programistycznemu tworzyć pliki i teksty wokół kodu. Skille `docx`, `pdf`, `pptx` i `xlsx` od Anthropic tworzą prawdziwe pliki Office i PDF, `doc-coauthoring` prowadzi trzyetapowe pisanie RFC, `writing-guidelines` od Vercela recenzuje tekst, a `humanizer` usuwa ślady AI. Żaden nie jest wbudowany w Claude Code, a licencja skilli Office jest własnościowa.

W piątek wypuszczasz release. Dział produktu chce prezentacji na spotkanie całej firmy (all-hands), zespół platformowy chce RFC do kolejnej migracji, a oba dokumenty powstają z twojego repozytorium: z changeloga, zgłoszeń i notatek projektowych. Prośba „zrób PowerPointa” bez skilla kończy się skryptem w Pythonie, który działa w połowie, albo Markdownem z rozszerzeniem `.pptx`. Ta strona jest dla programistów, którzy chcą, żeby dokumenty wychodziły z agenta równie powtarzalnie jak kod, i dla tech leadów, którzy chcą jednego procesu pisania, który zespół może zrecenzować.

## Co daje ci zestaw skilli do dokumentów i pisania

- Wybór spośród pięciu skilli i polecenia instalacji dla Claude Code, Codex i Cursora (przetestowane 2026-09-26, skills CLI 1.7.0)
- Prezentację PPTX na release zbudowaną z `CHANGELOG.md` i proces od szkicu RFC przez test czytelnika do opublikowanego dokumentu
- Prompty do skopiowania, listę kontrolną weryfikacji i pułapki, przez które te skille zawodzą po cichu

## Którego skilla do dokumentów albo pisania użyć?

Pięć skilli robi różne rzeczy. Dwa tworzą pliki, jeden prowadzi proces, a dwa poprawiają tekst.

| Skill | Wydawca | Co robi | Wynik | Licencja |
| --- | --- | --- | --- | --- |
| `pptx`, `docx`, `xlsx`, `pdf` | Anthropic (`anthropics/skills`) | Tworzą, czytają i edytują pliki PowerPoint, Word, Excel i PDF za pomocą skryptów (pptxgenjs, biblioteki Pythona, LibreOffice), a potem je walidują | Prawdziwe pliki `.pptx`, `.docx`, `.xlsx`, `.pdf` | Własnościowa, kod dostępny do wglądu („LICENSE.txt has complete terms”) |
| `doc-coauthoring` | Anthropic (`anthropics/skills`) | Trzyetapowy proces dla RFC, specyfikacji, PRD i dokumentów decyzyjnych: zbieranie kontekstu, dopracowywanie sekcja po sekcji, test czytelnika na świeżym modelu | Plik Markdown (albo artefakt na claude.ai) | Brak pliku licencji w folderze skilla; README repozytorium mówi, że „wiele” jego skilli jest na Apache 2.0 |
| `writing-guidelines` | Vercel Labs (`vercel-labs/agent-skills`) | Sprawdza dokumentację względem podręcznika pisania Vercela, który przy każdym uruchomieniu pobiera z GitHuba | Zwięzłe uwagi w formacie `plik:linia`, bez edycji | Repozytorium reguł `vercel-labs/writing-guidelines`: MIT; `agent-skills` nie miało 2026-09-26 pliku licencji w katalogu głównym |
| `humanizer` | blader (`blader/humanizer`), v3.1.0 | Wykrywa 26 ponumerowanych wzorców tekstu brzmiącego jak AI, opartych na „Signs of AI writing” z Wikipedii, i przepisuje je bez zmiany twierdzeń | Przepisany tekst albo edytowany plik w trybie plikowym | MIT |

**Popularność na dzień 2026-09-26.** Gwiazdki na GitHubie: `anthropics/skills` 178,4 tys. (całe repozytorium) i `blader/humanizer` 52 tys. Liczba instalacji na skills.sh od początku, według zewnętrznego zrzutu `LinklyAI/best-skills` z 2026-09-26, czyli źródła wtórnego (przed cytowaniem sprawdź je na skills.sh): `doc-coauthoring` 86 463, `writing-guidelines` 75 985.

### Który skill do którego zadania

| Jeśli musisz… | Użyj | Dlaczego ten |
| --- | --- | --- |
| dać interesariuszowi prezentację, dokument Worda albo arkusz | `pptx`, `docx` albo `xlsx` | Tworzą poprawne pliki i sprawdzają je walidatorem i renderem, czego goły prompt nie robi |
| wyciągnąć tabele z PDF-a, wypełnić formularz, połączyć albo podzielić pliki | `pdf` | Robi to skryptem z bibliotekami PDF zamiast zgadywać tekst |
| napisać RFC, dokument projektowy albo zapis decyzji | `doc-coauthoring` | Przepytuje cię przed pisaniem i testuje wynik na modelu, który nie widział waszej rozmowy |
| sprawdzić dokumentację względem spisanego przewodnika stylu | `writing-guidelines` albo własny przewodnik (zobacz pułapki) | Zgłasza uwagi z numerem linii i niczego nie zmienia |
| usunąć z release notes albo README wzorce „brzmi jak ChatGPT” | `humanizer` | Zostawia fakty, kod, polecenia i YAML bez zmian i sam sprawdza, czy przepisanie dodało albo zgubiło twierdzenie |

Mocniejsze narzędzia przeciw „slopowi”, z deterministycznymi skanerami i opublikowanym evalem, opisujemy w [skillach przeciw sztucznie brzmiącemu tekstowi](/pl/ecosystem/skills/unslop/). Skille do produktu, marketingu i pracy z wiedzą są w [skillach do produktu, marketingu i pracy z wiedzą](/pl/ecosystem/skills/top-skills-business/).

## Jak zainstalować skille do dokumentów i pisania?

Na claude.ai i w Claude API cztery skille dokumentowe są wbudowane. Dokumentacja Anthropic mówi wprost, że nie są one dostępne w Claude Code („are not available in Claude Code”), więc każdy agent programistyczny potrzebuje jawnej instalacji. Instaluj skille do dokumentów, które faktycznie tworzysz, a nie cały katalog.

**Claude Code**

```bash
# Office and PDF skills: the document-skills plugin holds exactly docx, pdf, pptx, xlsx
claude plugin marketplace add anthropics/skills
claude plugin install document-skills@anthropic-agent-skills

# doc-coauthoring alone (the example-skills plugin would add 11 more skills)
npx skills add anthropics/skills --skill doc-coauthoring --agent claude-code -y

# Writing review and de-slopping
npx skills add vercel-labs/agent-skills --skill writing-guidelines --agent claude-code -y
claude plugin marketplace add blader/humanizer
claude plugin install humanizer@humanizer
```

Skille z wtyczek mają przestrzeń nazw: `/document-skills:pptx`, `/humanizer:humanizer`. Polecenia rzadko są potrzebne, bo skill uruchamia się, gdy wspominasz o prezentacji, slajdach albo pliku `.pptx`. Wtyczka humanizer wymaga Claude Code 2.1.142 lub nowszego. Jeśli `anthropic-agent-skills` jest już na liście `claude plugin marketplace list`, pomiń linię `marketplace add`.

**Codex**

```bash
# Project scope: files land in .agents/skills/
npx skills add anthropics/skills --skill pptx docx xlsx pdf doc-coauthoring --agent codex -y
npx skills add vercel-labs/agent-skills --skill writing-guidelines --agent codex -y
npx skills add blader/humanizer --agent codex -y
```

Skill wywołujesz po nazwie, `$pptx` albo `$humanizer`, a `/skills` pokazuje, co się załadowało. Codex 0.157.1 potrafi też czytać marketplace Anthropic (`codex plugin marketplace add anthropics/skills`, potem `codex plugin add document-skills@anthropic-agent-skills`). W naszym teście z 2026-09-26 (Codex 0.157.1, `codex plugin add document-skills@anthropic-agent-skills`, a potem zliczenie plików `SKILL.md` w `~/.codex/plugins/cache`) ta instalacja skopiowała do cache wtyczki wszystkie 20 folderów skilli z repozytorium, a nie tylko cztery, więc użyj skills CLI, żeby dostać dokładnie te skille, które wymienisz.

**Cursor**

```bash
npx skills add anthropics/skills --skill pptx docx xlsx pdf doc-coauthoring --agent cursor -y
npx skills add vercel-labs/agent-skills --skill writing-guidelines --agent cursor -y
npx skills add blader/humanizer --agent cursor -y
```

Skills CLI zapisuje projektowe skille Cursora do `.agents/skills/`, tego samego folderu, który czyta Codex, więc jedna instalacja obsługuje oba narzędzia. O skill proś po nazwie w czacie Agenta („use the pptx skill”).

Jedno polecenie może obsłużyć wszystkie trzy agenty: `--agent claude-code codex cursor` zapisuje skill do `.agents/skills/` i dodaje dowiązanie symboliczne w `.claude/skills/` dla Claude Code (skills CLI 1.7.0, test z 2026-09-26). Zacommituj `skills-lock.json` i folder `humanizer` na licencji MIT, żeby cały zespół używał tych samych wersji, ale dodaj `.agents/skills/{docx,pdf,pptx,xlsx}/` do `.gitignore`: te cztery są objęte licencją zastrzeżoną, a commit skopiowałby pliki Anthropic do twojego repozytorium. `doc-coauthoring` traktuj tak jak skille Office (dodaj go do `.gitignore` i odtwarzaj z pliku blokady), dopóki Anthropic nie doda do niego pliku licencji. Pozostali członkowie zespołu odtwarzają wszystko z pliku blokady poleceniem `npx skills experimental_install` („restore from skills-lock.json”, skills CLI 1.7.0). CLI kończy każdą instalację komunikatem „Review skills before use; they run with full agent permissions”; listę kontrolną znajdziesz w [bezpieczeństwie łańcucha dostaw skilli](/pl/ecosystem/skills/skill-security/), a aktualizacje i usuwanie w [instalowaniu i zarządzaniu skillami](/pl/ecosystem/skills/installing-managing/).

## Jak wygenerować prezentację PPTX na release z changeloga?

Skill `pptx` tworzy nową prezentację, pisząc skrypt w pptxgenjs, a potem sprawdza plik na trzy sposoby: walidatorem schematu i struktury, zrzutem tekstu i wyrenderowanymi obrazami slajdów. Przykład zamienia ostatni release z `CHANGELOG.md` w prezentację na osiem slajdów.

1. **Zainstaluj lokalne zależności.** Sandbox Anthropic ma je preinstalowane; twój komputer nie. W terminalu:

    ```bash
    npm install --save-dev pptxgenjs          # 4.0.1 on 2026-09-26
    python3 -m venv .venv && . .venv/bin/activate   # keeps pip off the system Python
    pip install "markitdown[pptx]" defusedxml lxml Pillow
    # plus LibreOffice (soffice) and Poppler (pdftoppm) from your OS package manager
    ```

    Bez LibreOffice i Popplera prezentacja nadal się zbuduje, ale agent nie wyrenderuje slajdów do obrazów, więc kontrola wizualna odpada.

2. **Daj agentowi źródło prawdy i limit slajdów.** Wklej poniższy prompt do Claude Code, Codex albo Cursora. Wskazuje sekcję changeloga, odbiorców, ścieżkę wyjściową i kontrole, więc agent nie wypełni slajdów wymyślonymi funkcjami.

3. **Pozwól skillowi napisać i uruchomić generator.** Spodziewaj się skryptu w rodzaju `scripts/release-deck.js`, który najpierw ustawia `pres.layout`, zapisuje kolory jako sześcioznakowy hex bez `#` i umieszcza notatki prelegenta w `slide.addNotes()`. To trzy z pułapek pptxgenjs, które skill wymienia. Dwie pierwsze po cichu psują plik albo wypychają kształty poza slajd; trzecia trzyma notatki poza widocznym slajdem.

4. **Sprawdź wynik walidatora.** Skill uruchamia walidator po każdym buildzie. Czysty przebieg kończy się linią:

    ```text
    All validations PASSED!
    ```

    Błąd wskazuje część pliku i poprawkę, na przykład wykres skumulowany z `dataLabelPosition: 'outEnd'`, którego PowerPoint nie otworzy.

5. **Porównaj tekst z changelogiem.** `markitdown docs/release/release-4.2.pptx` wypisuje jeden blok na slajd pod znacznikiem `<!-- Slide number: N -->`, a notatki prelegenta pod `### Notes:`. Porównaj ten tekst z sekcją changeloga sam albo promptem ze śladem źródeł poniżej.

6. **Obejrzyj wyrenderowane slajdy.** Skill konwertuje prezentację do PDF przez LibreOffice, a potem do jednego pliku JPEG na slajd przez `pdftoppm`, i sprawdza każdy obraz pod kątem wychodzenia tekstu poza ramkę, nakładania się elementów i słabego kontrastu. Zanim prezentacja pójdzie dalej, otwórz dwa albo trzy obrazy sam.

**Prompt do skopiowania: prezentacja na release z CHANGELOG.md**

```text
Use the pptx skill. Build docs/release/release-4.2.pptx from the "## [4.2.0]"
section of CHANGELOG.md, for an internal all-hands audience (engineers and
product). Eight slides maximum: title, highlights (three items), one slide
per Added/Changed/Fixed group, breaking changes with the migration step,
and a closing slide with the upgrade command.

Rules:
- Every bullet must come from a CHANGELOG line. Do not add features,
  numbers or dates that are not in that section.
- Put detail in speaker notes, not on the slide. Max five bullets per slide.
- Write the generator as scripts/release-deck.js so it can be rerun.
- Fonts: Cambria for titles, Calibri for body.

When done: run the skill's validator, run markitdown on the deck, and render
every slide to an image and inspect it. Report the validator result, any
slide you had to fix, and a table mapping each slide bullet to the
CHANGELOG line it came from.
```

Prawdziwym produktem jest skrypt generatora. Gdy już istnieje, kolejny release wymaga jednego polecenia, `node scripts/release-deck.js`, a agent musi zaktualizować skrypt tylko wtedy, gdy zmieni się format changeloga. Zrecenzuj skrypt w pull requeście jak każdy inny kod.

## Jak napisać RFC razem z agentem, zrecenzować je i opublikować?

Dobre RFC zależy od kontekstu, który masz w głowie, w zgłoszeniach i w starych wątkach. `doc-coauthoring` każe agentowi zebrać ten kontekst przed pisaniem i testuje szkic na czytelniku, który go nie ma. Workflow poniżej dokłada bramkę stylu, przejście usuwające ślady AI i zatwierdzenie przez człowieka, a potem publikuje dokument tam, gdzie są jego czytelnicy.

1. **Zacznij sesję współpisania od promptu poniżej.** Skill proponuje swój trzyetapowy proces i zadaje pięć pytań wstępnych: typ dokumentu, główni odbiorcy, oczekiwany efekt, szablon, ograniczenia. Odpowiadaj skrótowo. Potem wyrzuć z siebie wszystko, co wiesz: incydent, który wywołał RFC, odrzucone alternatywy, terminy, osoby, które będą przeciw. Jeśli agent ma serwer MCP do Slacka, Google Drive albo Lineara, wskaż mu wątki zamiast je wklejać.

2. **Odpowiedz na pytania doprecyzowujące.** Skill zadaje od pięciu do dziesięciu ponumerowanych pytań o luki, a ty możesz odpowiadać liniami w rodzaju `3: no, backwards compat`. Idzie dalej, gdy potrafi pytać o kompromisy bez tłumaczenia mu podstaw.

3. **Buduj RFC sekcja po sekcji.** Skill tworzy `docs/rfcs/0042-sessions-kv-to-d1.md` z miejscem na każdą sekcję, a potem zaczyna od sekcji z największą liczbą niewiadomych. Dla każdej zadaje pytania, proponuje 5–20 punktów do rozważenia i pozwala ci je zostawić, usunąć albo połączyć po numerach, zanim napisze tekst. Mów mu, co zmienić, zamiast samodzielnie edytować plik; wtedy uczy się twoich preferencji na kolejne sekcje.

4. **Przeprowadź test czytelnika.** Skill przewiduje 5–10 pytań, które zadałby czytelnik, i odpowiada na nie wyłącznie na podstawie dokumentu. W Claude Code robi to przez subagentów, którzy widzą tylko dokument. W Codex i Cursorze, albo zawsze wtedy, gdy skill zgłosi, że nie może uruchomić subagenta, przeprowadź test sam w świeżej sesji z promptem testu czytelnika poniżej. Warunek wyjścia: świeży czytelnik odpowiada poprawnie i nie znajduje nowych niejasności.

5. **Sprawdź styl.** Poproś o review RFC skillem `writing-guidelines`. Zwraca uwagi w rodzaju `docs/rfcs/0042-sessions-kv-to-d1.md:31 - passive voice` i niczego nie edytuje. Zastosuj uwagi zgodne z twoim przewodnikiem stylu, a te specyficzne dla Vercela odrzuć (zobacz pułapki).

6. **Usuń ślady AI, potem zrób diff.** Uruchom `humanizer` na pliku. W trybie plikowym zapisuje tylko ostateczny tekst i zostawia bez zmian bloki kodu, kod w linii, polecenia, ścieżki, YAML i cele linków. Następnie uruchom `git diff --word-diff docs/rfcs/` i sprawdź, czy nie zmieniła się żadna liczba, nazwa, data ani twierdzenie. Humanizer sam sprawdza dodane i zgubione twierdzenia, ale to diff jest twoim dowodem.

7. **Otwórz pull request i zbierz zatwierdzenia.** RFC przechodzi review jak kod: autor odpowiada za treść, wskazani zatwierdzający (tech lead i po jednym właścicielu każdego dotkniętego systemu) zatwierdzają, a zastrzeżenia rozwiązuje się w wątku PR. Po przyjęciu RFC zapisz decyzję w [rekordzie decyzji architektonicznej](/pl/workflows/plan/architecture-decisions/).

8. **Opublikuj w formacie, którego używają czytelnicy.** Plik Markdown pozostaje źródłem prawdy. Dla czytelników spoza repozytorium poproś skill `docx` o wersję Worda ze spisem treści albo skill `pdf` o PDF i umieść w dokumencie link do PR, żeby czytelnicy widzieli, jak powstawał.

**Prompt do skopiowania: rozpoczęcie RFC z doc-coauthoring**

```text
Use the doc-coauthoring skill. I need an RFC proposing that we move user
sessions from Cloudflare KV to D1. Audience: the platform team and the two
service owners who read sessions. Desired impact: an approve/reject decision
at next Thursday's architecture review. Template: docs/rfcs/TEMPLATE.md.

Write the file to docs/rfcs/0042-sessions-kv-to-d1.md. Start with the
section that has the most unknowns. Do not state any latency, cost or
traffic figure unless I give it to you or you read it from a file I name;
mark missing figures as TODO(owner) instead.
```

**Prompt do skopiowania: test czytelnika w świeżej sesji**

```text
You have not seen this document before. Read docs/rfcs/0042-sessions-kv-to-d1.md
and nothing else. Answer these questions using only the document, and quote
the sentence each answer comes from:
1. What problem does this RFC solve, and for whom?
2. What exactly changes for a service that reads sessions today?
3. What is the rollback plan, and what triggers it?
4. Which alternatives were rejected, and why?
5. What does the author need decided, by whom, by when?
Then list: anything ambiguous, any knowledge the document assumes the reader
already has, and any internal contradiction.
```

Żeby uruchomić test czytelnika z terminala w czystym kontekście, przekaż ten prompt do `claude -p --no-session-persistence` albo `codex exec --ephemeral`, żeby test nie trafił do zapisanych sesji. Oba polecenia startują bez twojej rozmowy o szkicu, choć nadal wczytują `CLAUDE.md` albo `AGENTS.md` z repozytorium.

## Jak zweryfikować dokument, który napisał agent?

Wygenerowany dokument trafia do ludzi, którzy podejmują na jego podstawie decyzje, więc traktuj go jak artefakt releasu: przechodzi kontrole, zanim przeczyta go człowiek, a człowiek czyta dowody, a nie każdą linię.

| Kontrola | Co wyłapuje | Jak działa |
| --- | --- | --- |
| Walidacja pliku | Prezentację albo dokument, którego PowerPoint lub Word nie otworzy | Walidator skilla po każdym buildzie; błąd blokuje wydanie |
| Ślad źródeł | Wymyślone funkcje, liczby albo daty | Tabela przypisująca każdy punkt slajdu albo twierdzenie RFC do linii changeloga, zgłoszenia albo pliku |
| Skan placeholderów | Pozostawione `TODO`, `lorem`, `[insert…]`, tekst szablonu | Polecenie `grep` poniżej, z sekcji QA samego skilla |
| Test czytelnika | Luki, które może wypełnić tylko autor | Świeża sesja odpowiada na pytania czytelnika wyłącznie z dokumentu |
| Sprawdzenie stylu | Naruszenia przyjętego stylu | Uwagi `writing-guidelines` albo ta sama kontrola względem twojego przewodnika |
| Diff przepisania | Fakty zmienione podczas usuwania śladów AI | `git diff --word-diff` po `humanizer` |
| Zatwierdzenie przez człowieka | Złą decyzję, pominiętego interesariusza | Wskazani zatwierdzający w pull requeście |

Uruchom skan placeholderów na zrzucie tekstu:

```bash
markitdown docs/release/release-4.2.pptx | grep -iE "\bx{3,}\b|lorem|ipsum|\bTODO|\[insert"
```

Pusty wynik oznacza zaliczenie.

**Kto zatwierdza.** Autor odpowiada za poprawność i ślad źródeł, niezależnie od tego, kto napisał słowa; przewodnik pisania Vercela mówi to samo („You are accountable for the content you produce, however it is created”). Tech lead zatwierdza RFC zmieniające architekturę. Prezentację zatwierdza właściciel releasu po przeczytaniu tabeli śladu źródeł i obejrzeniu wyrenderowanych slajdów. Dołącz obie rzeczy do pull requesta jako część [pakietu dowodów](/pl/workflows/ship/evidence-bundle/).

## Ile kontekstu kosztuje każdy skill do pisania?

Skille kosztują swoją nazwę i opis w każdej sesji, a treść tylko wtedy, gdy się uruchamiają. Pomiary z 2026-09-26. Pierwsze trzy wiersze pochodzą z `claude plugin details document-skills@anthropic-agent-skills` w Claude Code 2.1.283. Ostatnie trzy to rozmiar każdego pliku w bajtach (`wc -c`), przeliczony w proporcji mniej więcej czterech bajtów na token:

| Co się ładuje | Kiedy | Rozmiar |
| --- | --- | --- |
| Wtyczka `document-skills` (cztery skille) | W każdej sesji | około 1028 tokenów |
| `pptx` | Gdy się uruchamia | około 7,9 tys. tokenów |
| `xlsx`, `pdf`, `docx` | Gdy każdy się uruchamia | około 3 tys., 3 tys. i 2,4 tys. tokenów |
| `SKILL.md` skilla `doc-coauthoring` | Gdy się uruchamia | około 4 tys. tokenów (15 815 bajtów) |
| `SKILL.md` skilla `humanizer` | Gdy się uruchamia | około 8,1 tys. tokenów (32 348 bajtów, v3.1.0) |
| `SKILL.md` skilla `writing-guidelines` + reguły, które pobiera | Gdy się uruchamia | około 3,9 tys. tokenów (1233 + 14 228 bajtów) |

Po instalacji uruchom `claude plugin details document-skills@anthropic-agent-skills`, żeby zobaczyć własne liczby, a przy skillach przenośnych porównaj `/context` przed i po.

**Pułapki ze skillami do dokumentów i pisania**

- **„Claude Code ma wbudowane skille do Worda, Excela i PowerPointa”.** Nie ma. Dokumentacja Anthropic mówi, że wbudowane skille dokumentowe nie są dostępne w Claude Code (dokumentacja Agent Skills od Anthropic, sprawdzone 2026-09-26 dla Claude Code 2.1.283); zainstaluj `document-skills@anthropic-agent-skills`.
- **Skille Office nie są open source.** Ich licencja jest własnościowa, z kodem dostępnym do wglądu, i podlega twojej umowie z Anthropic. Zabrania powielania, rozpowszechniania i tworzenia utworów zależnych z plików skilla, więc nie kopiuj `validate.py` ani folderu skilla do swojego repozytorium czy obrazu CI. To, czy uruchamianie ich w Codex albo Cursorze mieści się w twojej umowie, jest pytaniem do twojego działu prawnego.
- **„pptxgenjs is preinstalled”** jest prawdą w sandboksie Anthropic, nie na twoim laptopie. Gdy `require('pptxgenjs')` się nie powiedzie, agent uruchamia `npm install`; dopilnuj, żeby zainstalował pakiet w projekcie jako zależność deweloperską, a nie w przypadkowym katalogu.
- **Dwa skille o nazwie `doc-coauthoring`.** `getsentry/skills` od Sentry ma własny, innego autora. Zainstalowane razem jako skille przenośne walczą o jeden folder; zostaw jeden.
- **`writing-guidelines` to wewnętrzny przewodnik stylu Vercela.** Pobierane reguły zawierają kontrole specyficzne dla Vercela: `meta.contentType`, zrzuty ekranu z konta demo ACME, przypięte nazwy modeli w przykładach dla AI Gateway Vercela i zakaz pauz (`—`) jako interpunkcji. Każ agentowi je pominąć albo skopiuj plik reguł do własnego skilla z regułami twojego przewodnika.
- **`writing-guidelines` pobiera reguły z GitHuba przy każdym uruchomieniu.** Bez sieci albo w zamkniętym sandboksie nie ma czego stosować. Reguły mogą się też zmienić między dwoma uruchomieniami, więc jeśli na nich opierasz bramkę, przypnij kopię.
- **Wtyczka humanizer i skill przenośny mają różne nazwy.** Wtyczka odpowiada na `/humanizer:humanizer`, instalacja przez skills CLI na `/humanizer`.
- **`--skill=<nazwa>` jest po cichu ignorowane** przez skills CLI 1.7.0; z `-y` instaluje wszystkie skille z repozytorium. Pisz `--skill pptx` ze spacją.

## Co się psuje, gdy agenci piszą dokumenty?

**Prezentacja otwiera się w LibreOffice, ale PowerPoint twierdzi, że jest uszkodzona.** Skill `pptx` wymienia dane wejściowe generatora, które dają takie pliki: `#` albo kanał alfa w kolorze hex, ujemne przesunięcie cienia, etykiety `outEnd` na wykresie skumulowanym, oś pomocniczą bez obu `valAxes` i `catAxes`. Walidator zgłasza dwa błędy wykresów; zasady dotyczące kolorów i cieni są tylko w instrukcjach skilla. Naprawa: uruchom walidator, popraw generator (nie spakowany XML), zbuduj ponownie i przed pierwszym releasem otwórz plik raz w PowerPoincie.

**Tekst wychodzi poza ramkę w prawdziwej prezentacji, choć w QA wyglądał dobrze.** Kontrola wizualna skilla renderuje przez LibreOffice, które podmienia brakujące fonty; Georgia, Trebuchet MS i Garamond renderują się wtedy z inną szerokością. Naprawa: w tekście głównym używaj fontów bezpiecznych dla QA według skilla (Arial, Calibri, Cambria i kilka innych), a gdzie indziej zostaw około 10% zapasu.

**Prezentacja zawiera funkcje, których nie ma w releasie.** Model uzupełnił ubogi changelog wiarygodnie brzmiącymi punktami. Naprawa: wymagaj tabeli śladu źródeł z promptu do prezentacji, odrzucaj każdy punkt bez linii w changelogu, a jeśli funkcja jest prawdziwa, popraw changelog.

**RFC dobrze się czyta, ale nie odpowiada na niczyje pytanie.** Etap zbierania kontekstu został pominięty, więc agent napisał ogólnikową propozycję. Naprawa: zacznij od etapu pierwszego, odpowiedz na pięć pytań wstępnych i przeprowadź test czytelnika, zanim ktokolwiek inny przeczyta dokument.

**Humanizer zmienił liczbę.** Usuwając ślady AI, połączył dwa zdania i zgubił zastrzeżenie. Naprawa: `git diff --word-diff`, przywróć zgubione twierdzenie i nie używaj humanizera na tabelach referencyjnych i changelogach, gdzie brzmienie jest danymi.

**`writing-guidelines` zwraca 60 uwag na krótkiej stronie.** Większość to wewnętrzne reguły Vercela, których twoja dokumentacja nigdy nie stosowała. Naprawa: zawęź uwagi do kategorii wspólnych z twoim przewodnikiem stylu (strona czynna, nagłówki, linki, zakazane słowa) albo napisz własny skill do review, korzystając z [budowania własnych skilli](/pl/ecosystem/skills/building-custom-skills/).

## Dokąd dalej

- [Skille przeciw sztucznie brzmiącemu tekstowi](/pl/ecosystem/skills/unslop/) — Deterministyczne skanery unslop, miodkuj dla polszczyzny i co evale mówią o usuwaniu śladów AI.
- [Rekordy decyzji architektonicznych](/pl/workflows/plan/architecture-decisions/) — Gdzie trafia przyjęte RFC i jak agenci czytają decyzje później.
- [Programowanie sterowane specyfikacją](/pl/workflows/plan/spec-driven-development/) — Ta sama dyscyplina „najpierw wywiad, potem szkic”, zastosowana do specyfikacji, z których buduje agent.
- [Bezpieczeństwo łańcucha dostaw skilli](/pl/ecosystem/skills/skill-security/) — Co przeczytać, zanim zainstalujesz skill, który uruchamia skrypty z twoimi uprawnieniami.
- [Instalowanie i zarządzanie skillami](/pl/ecosystem/skills/installing-managing/) — Skills CLI, wtyczki, aktualizacje, usuwanie i pułapki pomiędzy nimi.
- [Dokumentacja jako kontekst](/pl/workflows/context/documentation-as-context/) — Jak pisać dokumentację czytelną dla kolejnej sesji agenta, a nie tylko dla ludzi.

Skill do przepytywania, który dobrze łączy się z `doc-coauthoring` przed pisaniem specyfikacji, opisujemy w [skillach Matta Pococka, od grill-me do implement](/pl/ecosystem/skills/grill-me/). Jak wtyczki pakują i dystrybuują takie skille, wyjaśniamy w [przewodniku po wtyczkach i marketplace'ach](/pl/ecosystem/plugins/).
