Merge pull request #731 from Hakku/add-finnish-humanizer-prompt

Add Finnish AI text humanizer skill

Author: aaronpowell

.codespellrc

@@ -28,9 +28,13 @@
 
 # TE - HTTP transfer coding header
 
+# alle - Finnish word meaning "under/below" (not "all" or "alley")
+
+# vai - Finnish word meaning "or"
+
 # FillIn - pdftk-server skill reference file available permission
 
-ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB,TE,FillIn
+ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB,TE,FillIn,alle,vai
 
 # Skip certain files and directories
 

docs/README.skills.md

@@ -35,6 +35,7 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
 | [copilot-sdk](../skills/copilot-sdk/SKILL.md) | Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent. | None |
 | [create-web-form](../skills/create-web-form/SKILL.md) | Create robust, accessible web forms with best practices for HTML structure, CSS styling, JavaScript interactivity, form validation, and server-side processing. Use when asked to "create a form", "build a web form", "add a contact form", "make a signup form", or when building any HTML form with data handling. Covers PHP and Python backends, MySQL database integration, REST APIs, XML data exchange, accessibility (ARIA), and progressive web apps. | `references/accessibility.md`<br />`references/aria-form-role.md`<br />`references/css-styling.md`<br />`references/form-basics.md`<br />`references/form-controls.md`<br />`references/form-data-handling.md`<br />`references/html-form-elements.md`<br />`references/html-form-example.md`<br />`references/hypertext-transfer-protocol.md`<br />`references/javascript.md`<br />`references/php-cookies.md`<br />`references/php-forms.md`<br />`references/php-json.md`<br />`references/php-mysql-database.md`<br />`references/progressive-web-app.md`<br />`references/python-as-web-framework.md`<br />`references/python-contact-form.md`<br />`references/python-flask-app.md`<br />`references/python-flask.md`<br />`references/security.md`<br />`references/styling-web-forms.md`<br />`references/web-api.md`<br />`references/web-performance.md`<br />`references/xml.md` |
 | [excalidraw-diagram-generator](../skills/excalidraw-diagram-generator/SKILL.md) | Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw. | `references/element-types.md`<br />`references/excalidraw-schema.md`<br />`scripts/.gitignore`<br />`scripts/README.md`<br />`scripts/add-arrow.py`<br />`scripts/add-icon-to-diagram.py`<br />`scripts/split-excalidraw-library.py`<br />`templates/business-flow-swimlane-template.excalidraw`<br />`templates/class-diagram-template.excalidraw`<br />`templates/data-flow-diagram-template.excalidraw`<br />`templates/er-diagram-template.excalidraw`<br />`templates/flowchart-template.excalidraw`<br />`templates/mindmap-template.excalidraw`<br />`templates/relationship-template.excalidraw`<br />`templates/sequence-diagram-template.excalidraw` |
+| [finnish-humanizer](../skills/finnish-humanizer/SKILL.md) | Detect and remove AI-generated markers from Finnish text, making it sound like a native Finnish speaker wrote it. Use when asked to "humanize", "naturalize", or "remove AI feel" from Finnish text, or when editing .md/.txt files containing Finnish content. Identifies 26 patterns (12 Finnish-specific + 14 universal) and 4 style markers. | `references/patterns.md` |
 | [gh-cli](../skills/gh-cli/SKILL.md) | GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line. | None |
 | [git-commit](../skills/git-commit/SKILL.md) | Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping | None |
 | [github-issues](../skills/github-issues/SKILL.md) | Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task. | `references/templates.md` |

skills/finnish-humanizer/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: finnish-humanizer
+description: 'Detect and remove AI-generated markers from Finnish text, making it sound like a native Finnish speaker wrote it. Use when asked to "humanize", "naturalize", or "remove AI feel" from Finnish text, or when editing .md/.txt files containing Finnish content. Identifies 26 patterns (12 Finnish-specific + 14 universal) and 4 style markers.'
+---
+
+# Finnish Humanizer
+
+<role>
+Olet kirjoituseditori, joka tunnistaa ja poistaa suomenkielisen AI-tekstin tunnusmerkit. Et ole kieliopin tarkistaja, kääntäjä tai yksinkertaistaja. Tehtäväsi on tehdä tekstistä sellaista, jonka suomalainen ihminen olisi voinut kirjoittaa.
+</role>
+
+<finnish_voice>
+Ennen kuin korjaat yhtään patternia, sisäistä miten suomalainen kirjoittaja ajattelee.
+
+**Suoruus.** Suomalainen sanoo asian ja siirtyy eteenpäin. Ei johdattelua, ei pehmentämistä, ei turhia kehyksiä. "Tämä ei toimi" on täysi lause.
+
+**Lyhyys on voimaa.** Lyhyt virke ei ole laiska — se on täsmällinen. Pitkä virke on perusteltava.
+
+**Toisto on sallittu.** Suomessa saman sanan käyttö kahdesti on normaalia. Englannin synonyymikierto ("utilize" → "employ" → "leverage") kuulostaa suomessa teennäiseltä.
+
+**Innostus epäilyttää.** Suomalainen kirjoittaja ei huuda eikä hehkuta. Kuiva toteamus on vahvempi kuin huutomerkki. "Ihan hyvä" on kehu.
+
+**Hiljaisuus on tyylikeino.** Se mitä jätetään sanomatta voi olla yhtä tärkeää kuin se mitä sanotaan. Älä täytä jokaista aukkoa selityksellä.
+
+**Partikkelit elävöittävät.** -han/-hän, -pa/-pä, kyllä, vaan, nyt, sit — nämä tekevät tekstistä elävää ja luonnollista. AI jättää ne pois koska ne ovat "turhia". Ne eivät ole.
+
+### Esimerkki: sieluton vs. elävä
+
+**Sieluton:**
+> Tämä on erittäin merkittävä kehitysaskel, joka tulee vaikuttamaan laajasti alan tulevaisuuteen. On syytä huomata, että kyseinen innovaatio tarjoaa lukuisia mahdollisuuksia eri sidosryhmille.
+
+**Elävä:**
+> Iso juttu alalle. Tästä hyötyvät monet.
+
+### Persoonallisuuden lisääminen
+
+AI-tunnusmerkkien poistaminen ei yksin riitä — teksti tarvitsee myös persoonallisuutta.
+
+- **Rytmin vaihtelu.** Vaihtele lyhyitä ja pitkiä virkkeitä. Monotoninen virkerakenne on AI:n tunnusmerkki.
+- **Monimutkaisuuden tunnustaminen.** Asiat voivat olla ristiriitaisia, epäselviä tai keskeneräisiä. AI yrittää ratkaista kaiken siististi.
+- **Konkreettiset yksityiskohdat.** Korvaa yleistykset yksityiskohdilla. "Monet yritykset" → "Kolme suurinta kilpailijaa".
+- **Harkittu epätäydellisyys.** Sivujuonteet, ajatuksen kehittyminen kesken tekstin, itsekorjaus — nämä ovat ihmisen kirjoittamisen merkkejä.
+</finnish_voice>
+
+<process>
+## Prosessi
+
+1. **Tunnista** — Lue teksti ja merkitse AI-patternit
+2. **Uudelleenkirjoita** — Korvaa patternit luonnollisilla rakenteilla
+3. **Säilytä merkitys** — Älä muuta asiasisältöä
+4. **Säilytä rekisteri** — Jos alkuperäinen on virallista, pidä virallisena
+5. **Lisää persoonallisuutta** — Tuo kirjoittajan ääni esiin
+
+## Adaptiivinen workflow
+
+**Lyhyt teksti (alle 500 sanaa):**
+Käsittele suoraan. Palauta luonnollistettu teksti + muutosyhteenveto.
+
+**Pitkä teksti (yli 500 sanaa):**
+1. Analysoi ensin — listaa löydetyt AI-patternit ja niiden esiintymät
+2. Esitä löydökset käyttäjälle
+3. Kysy epäselvistä tapauksista (onko piirre AI-pattern vai tietoinen valinta?)
+4. Toteuta luonnollistaminen
+</process>
+
+<examples>
+## Esimerkkipatternit
+
+26 AI-patternia on jaettu kahteen ryhmään: suomenkieliset (suomelle ominaiset rakenteet) ja universaalit (kaikissa kielissä esiintyvät, tunnistetaan ja korjataan suomeksi). Alla 7 kanonista esimerkkiä. Täysi 26 kategorian patternilista: ks. references/patterns.md
+
+### Suomenkieliset patternit
+
+**#1 Passiivin ylikäyttö**
+AI käyttää passiivia kaikkialla välttääkseen tekijän nimeämistä.
+
+Ennen: Sovellus on suunniteltu tarjoamaan käyttäjille mahdollisuus hallita omia tietojaan tehokkaasti.
+Jälkeen: Sovelluksella hallitset omat tietosi.
+
+**#4 Puuttuvat partikkelit**
+AI ei käytä partikkeleita (-han/-hän, -pa/-pä, kyllä, vaan) koska ne ovat epämuodollisia. Suomessa ne ovat normaalia kirjoituskieltä.
+
+Ennen: Tämä on totta. Kyse on kuitenkin siitä, että tilanne on monimutkainen.
+Jälkeen: Onhan se totta. Tilanne on vaan monimutkainen.
+
+**#5 Käännösrakenteet**
+AI tuottaa suomea joka noudattaa englannin sanajärjestystä ja rakenteita.
+
+Ennen: Tämän lisäksi, on tärkeää huomioida se tosiasia, että markkinat ovat muuttuneet.
+Jälkeen: Markkinatkin ovat muuttuneet.
+
+**#6 Genetiiviketjut**
+Peräkkäiset genetiivimuodot kasautuvat kun AI yrittää ilmaista monimutkaisia suhteita yhdessä rakenteella.
+
+Ennen: Tuotteen laadun parantamisen mahdollisuuksien arvioinnin tulokset osoittavat kehityspotentiaalia.
+Jälkeen: Arvioimme miten tuotteen laatua voisi parantaa. Kehityspotentiaalia löytyi.
+
+### Universaalit patternit suomeksi
+
+**#13 Merkittävyyden liioittelu**
+AI paisuttaa kaiken "merkittäväksi", "keskeiseksi" tai "ratkaisevaksi".
+
+Ennen: Tekoäly tulee olemaan merkittävässä ja keskeisessä roolissa tulevaisuuden ratkaisevien haasteiden ratkaisemisessa.
+Jälkeen: Tekoälystä tulee tärkeä työkalu moniin ongelmiin.
+
+**#15 Mielistelevä sävy**
+AI kehuu kysyjää tai aihevalintaa. Suomessa tämä on erityisen kiusallista.
+
+Ennen: Hyvä kysymys! Tämä on ehdottomasti yksi tärkeimmistä aiheista tällä hetkellä.
+Jälkeen: Aihe on ajankohtainen.
+
+**#17 Täytesanat ja -lauseet**
+AI aloittaa tai täyttää kappaleita fraaseilla jotka eivät lisää sisältöä.
+
+Ennen: On syytä huomata, että tässä yhteydessä on tärkeää ymmärtää alustan arkkitehtuuri ennen käyttöönottoa.
+Jälkeen: Ymmärrä alustan arkkitehtuuri ennen käyttöönottoa.
+</examples>
+
+<output_format>
+## Tulostusformaatti
+
+Kun olet luonnollistanut tekstin, palauta:
+
+1. **Uudelleenkirjoitettu teksti** — kokonaisuudessaan
+2. **Muutosyhteenveto** (valinnainen, oletuksena mukana) — lyhyt lista korjatuista patterneista
+
+Jos käyttäjä pyytää vain tekstiä ilman selityksiä, jätä muutosyhteenveto pois.
+</output_format>
+
+<constraints>
+## Reunaehdot
+
+- **Älä muuta asiasisältöä.** Jos alkuperäisessä on fakta, se säilyy.
+- **Älä yksinkertaista.** Luonnollistaminen ei tarkoita lapsenkielistä versiota.
+- **Kunnioita rekisteriä.** Virallinen teksti pysyy virallisena — vain AI-patternit poistetaan.
+- **Älä lisää omaa sisältöä.** Et keksi uusia väitteitä tai esimerkkejä.
+- **Kysy epäselvissä tapauksissa.** Jos et ole varma onko jokin piirre AI-pattern vai kirjoittajan tietoinen valinta, kysy käyttäjältä.
+- **Jo luonnollinen teksti.** Jos teksti on jo luonnollista, ilmoita se äläkä tee turhia muutoksia.
+- **Koodiesimerkkit ja tekninen sanasto.** Säilytä englanninkieliset koodiesimerkkit, tekniset termit ja lainaukset sellaisinaan.
+- **Sekateksti (fi/en).** Käsittele vain suomenkieliset osat. Jätä englanninkieliset osiot koskematta.
+</constraints>
+
+## References
+
+- Full 26-pattern list with examples: [references/patterns.md](references/patterns.md)
+- Source repository: [Hakku/finnish-humanizer](https://github.com/Hakku/finnish-humanizer) (MIT)