stop-slop-pl

Stop Slop PL

English: Stop Slop PL is a Polish-language writing skill for Claude, Claude Code, and Codex. It rewrites AI-sounding, bureaucratic, or over-polished Polish into natural prose while keeping facts, numbers, and register intact. The rest of this README is in Polish, because that's the audience.

Stop Slop PL poprawia polski tekst, który brzmi jak z AI: sztywny, urzędowy, przegadany albo tłumaczony z angielskiego. Skill przepisuje go na naturalny język i nie rusza faktów, liczb, cytatów ani rejestru.

Skill działa w dwóch wersjach z jednego repozytorium:

• Claude / Claude Code: wtyczka albo plik wgrany na claude.ai,
• Codex / ChatGPT: skill $stop-slop-pl.

Obie wersje korzystają z tych samych reguł, więc nie rozjeżdżają się w czasie.

Co robi

• Domyślnie przepisuje tekst i od razu zwraca poprawioną wersję.
• Zostawia bez zmian fakty, liczby, nazwy, linki, cytaty, kod i podstawy prawne.
• Usuwa typowy polski slop: urzędowy żargon, sztuczne i bezosobowe zwroty (które ukrywają, kto coś robi), puste przymiotniki, wymuszone kontrasty i ogólnikowe zakończenia.
• Dopasowuje styl do rejestru: prosty język, marketing, dokumentacja techniczna, tekst naukowy, pisma urzędowe i prawne, treści społecznościowe.
• Na życzenie robi sam audyt, pokazuje listę zmian, upraszcza do prostego języka albo dopasowuje się do Twojego głosu.

Czego nie robi: nie obiecuje obejścia wykrywaczy AI, tekstu „nie do wykrycia", podszywania się pod kogoś ani zmyślania faktów.

Instalacja w Claude Code

Dodaj repozytorium jako marketplace wtyczek, a potem zainstaluj wtyczkę:

/plugin marketplace add bartekpucek/stop-slop-PL
/plugin install stop-slop-pl@stop-slop-pl

Skill włącza się sam, gdy poprosisz o poprawę polskiego tekstu. Możesz go też wywołać wprost: /stop-slop-pl:stop-slop-pl.

Instalacja na claude.ai

Pobierz gotowy plik albo zbuduj go samodzielnie.

Sposób A, gotowy plik (bez terminala). Pobierz stop-slop-pl.skill z ostatniego wydania i wgraj go w ustawieniach: Settings → Capabilities → Skills.

Sposób B, zbuduj samodzielnie:

./scripts/build.sh
# tworzy dist/stop-slop-pl.skill

Tej ścieżki w claude.ai nie ma w oficjalnej dokumentacji Claude Code. Sprawdź u siebie, bo interfejs bywa aktualizowany.

Instalacja w Codex lub ChatGPT

Skopiuj albo podlinkuj folder skilla do katalogu, z którego korzysta Twój Codex:

mkdir -p ~/.codex/skills
ln -s "$(pwd)/skills/codex/stop-slop-pl" ~/.codex/skills/stop-slop-pl

Niektóre konfiguracje czytają skille też z ~/.agents/skills:

mkdir -p ~/.agents/skills
ln -s "$(pwd)/skills/codex/stop-slop-pl" ~/.agents/skills/stop-slop-pl

Po instalacji przeładuj środowisko, żeby zobaczyło nowy skill.

Tej ścieżki też nie ma w oficjalnej dokumentacji. Zweryfikuj ją w swojej wersji Codex.

Jak używać

Popraw styl po polsku, zachowaj sens i fakty:
W celu dokonania zgłoszenia należy wypełnić niniejszy formularz.

Napisz to po ludzku, bez zmiany faktów:
...

Usuń slop. Pokaż też krótką listę zmian:
...

Domyślnie skill zwraca najpierw poprawiony tekst. Uwagi dodaje tylko wtedy, gdy o nie poprosisz albo gdy ostrzega przed ryzykowną zmianą. Jeśli chcesz sam audyt, napisz tylko audyt.

Układ repozytorium

.claude-plugin/         # manifesty wtyczki i marketplace dla Claude Code
shared/references/      # reguły po polsku, jedno źródło prawdy
skills/
  claude/stop-slop-pl/   # wersja dla Claude / Claude Code
  codex/stop-slop-pl/    # wersja dla Codex / ChatGPT
scripts/                # build.sh, validate.sh, validate_skill.py
docs/                   # research-summary.md, test-scenarios.md

Rozwój

Reguły po polsku trzymamy w jednym miejscu: shared/references/. Zmieniaj je tam, a potem zsynchronizuj do obu wersji skilla i zbuduj paczkę:

./scripts/build.sh      # synchronizuje reguły i buduje dist/stop-slop-pl.skill
./scripts/validate.sh   # sprawdza obie wersje skilla

Ręczne testy są w docs/test-scenarios.md.

Źródła

Skill powstał na podstawie przeglądu otwartych narzędzi anti-slop i humanizujących oraz polskich materiałów o prostym języku, czytelności, stylometrii i polskich modelach językowych. Zobacz docs/research-summary.md i references/sources.md.

Licencja

MIT. Zobacz LICENSE.