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

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. Skille do produktu, marketingu i pracy z wiedzą są w skillach do produktu, marketingu i pracy z wiedzą.

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.

# Skille Office i PDF: wtyczka document-skills zawiera dokładnie docx, pdf, pptx, xlsx
claude plugin marketplace add anthropics/skills
claude plugin install document-skills@anthropic-agent-skills

# Sam doc-coauthoring (wtyczka example-skills dodałaby 11 innych skilli)
npx skills add anthropics/skills --skill doc-coauthoring --agent claude-code -y

# Review tekstu i usuwanie śladów AI
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.

# Zakres projektu: pliki trafiają do .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.

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, a aktualizacje i usuwanie w instalowaniu i zarządzaniu skillami.

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.

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

npm install --save-dev pptxgenjs          # 4.0.1 na dzień 2026-09-26
python3 -m venv .venv && . .venv/bin/activate   # pip nie dotyka systemowego Pythona
pip install "markitdown[pptx]" defusedxml lxml Pillow
# oraz LibreOffice (soffice) i Poppler (pdftoppm) z menedżera pakietów systemu

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

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.
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.
Sprawdź wynik walidatora. Skill uruchamia walidator po każdym buildzie. Czysty przebieg kończy się linią:
```
All validations PASSED!
```
Błąd wskazuje część pliku i poprawkę, na przykład wykres skumulowany z dataLabelPosition: 'outEnd', którego PowerPoint nie otworzy.
Porównaj tekst z changelogiem. markitdown docs/release/release-4.2.pptx wypisuje jeden blok na slajd pod znacznikiem , a notatki prelegenta pod ### Notes:. Porównaj ten tekst z sekcją changeloga sam albo promptem ze śladem źródeł poniżej.
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.

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.

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ć.
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.
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.
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.
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).
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.
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.
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ł.

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.

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:

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.

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.

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

Dokąd dalej

Skille przeciw sztucznie brzmiącemu tekstowi Deterministyczne skanery unslop, miodkuj dla polszczyzny i co evale mówią o usuwaniu śladów AI.

Rekordy decyzji architektonicznych Gdzie trafia przyjęte RFC i jak agenci czytają decyzje później.

Programowanie sterowane specyfikacją Ta sama dyscyplina „najpierw wywiad, potem szkic”, zastosowana do specyfikacji, z których buduje agent.

Bezpieczeństwo łańcucha dostaw skilli Co przeczytać, zanim zainstalujesz skill, który uruchamia skrypty z twoimi uprawnieniami.

Instalowanie i zarządzanie skillami Skills CLI, wtyczki, aktualizacje, usuwanie i pułapki pomiędzy nimi.

Dokumentacja jako kontekst 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. Jak wtyczki pakują i dystrybuują takie skille, wyjaśniamy w przewodniku po wtyczkach i marketplace’ach.