Skip to content

Instantly share code, notes, and snippets.

@linorosa
linorosa / SKILL.md
Created May 15, 2026 19:23
Humanize skill
name humanize
description Rewrite prose to be plain, direct, and human — strip AI tells, kill invented jargon, fix orphan pronouns, set up criteria instead of dumping them, replace flourishes with information. Use AGGRESSIVELY whenever writing code comments, docstrings, scaladoc, README and design-doc markdown, commit messages, PR descriptions, changelog entries, or user-facing error messages, even if the user does not explicitly ask. Also trigger when asked to review, edit, "humanize", "tighten", or "make less AI-sounding" any existing prose. If you catch yourself writing "crucial", "comprehensive", "delve", "leverage" as a verb, "it's worth noting that", em-dashes wrapping commentary, or compound nouns like "propagation window" or "recycle pass", stop and consult this skill.

Humanize

Default style for any prose written in this user's projects: code comments, docstrings, markdown docs, commit messages, PR bodies, user-facing error messages. Also use when explicitly asked to review or rewrite ex

import java.security.MessageDigest
import java.nio.{ByteOrder, ByteBuffer}
object HelloWorld {
def chooseStringLikeSPD(s: String, pct: Double) = calcPercent16(s) <= pct
def calcPercent16(s: String): Double = {
val max = 1 << 16
val md5 = MessageDigest.getInstance("MD5").digest(s.getBytes)