Skip to content

Add miodkuj and stop-slop skills for user-facing prose - #24

Merged
milten89 merged 2 commits into
developfrom
chore/prose-style-skills
Oct 1, 2026
Merged

milten89 merged 2 commits into
developfrom
chore/prose-style-skills

Conversation

@milten89

@milten89 milten89 commented Oct 1, 2026

Copy link
Copy Markdown
Owner

Adds two vendored skills for editing user-facing prose (ADR-0009: READMEs and other docs in Polish and English), and tells agents to use them.

Changes

  • .claude/skills/miodkuj/: bartekpucek/miodkuj (MIT, © 2026 Bartek Pucek). It removes AI-sounding, bureaucratic and translated phrasing from Polish text.
  • .claude/skills/stop-slop/: hardikpandya/stop-slop (MIT, © 2025 Hardik Pandya). It removes predictable AI writing patterns from English text.
  • CLAUDE.md: run /miodkuj on README.md and /stop-slop on README.en.md (and on CONTRIBUTING, SECURITY and other user-facing prose), changing only the prose; the skills are listed under "Skills and agents" with their source and license.
  • AGENTS.md: the same rule for other agents.

The vendored files are unmodified copies of upstream: every blob SHA matches miodkuj@32004e3 and stop-slop@8da1f03. They use LF line endings and contain no code, so build and dotnet format aren't affected.

Reviewer suggestions (not applied; this is your wording, your call)

  • Meaning over style: stop-slop tells the agent to remove adverbs, passive voice and absolutes ("always", "never", "only"). In our docs those words often carry API facts ("only on Wednesdays", "never runs in CI"). Consider adding to both files: "Meaning, API limits, publication schedules and qualifiers take precedence over style rules."
  • Keep AGENTS.md and CLAUDE.md in sync: AGENTS.md protects code blocks, commands, names and links. CLAUDE.md also protects badges and numbers, and names which README is Polish and which is English.
  • Record the upstream versions: for example the SHAs above in CLAUDE.md, so later updates are easy to diff.

🤖 Generated with Claude Code

Vendors two prose-editing skills and tells agents to use them on
READMEs and other user-facing docs (ADR-0009: Polish and English
versions):
- /miodkuj (bartekpucek/miodkuj, MIT) for Polish text
- /stop-slop (hardikpandya/stop-slop, MIT) for English text

Code blocks, commands, names, links and numbers stay unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@milten89
milten89 merged commit b2130aa into develop Oct 1, 2026
8 checks passed
@milten89
milten89 deleted the chore/prose-style-skills branch October 1, 2026 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant