https://github.com/Hakku/finnish-humanizer
27 patterns that make AI-generated Finnish sound human
https://github.com/Hakku/finnish-humanizer
ai-humanizer chatgpt claude claude-code claude-skills finnish humanizer llm nlp
Last synced: 2 days ago
JSON representation
27 patterns that make AI-generated Finnish sound human
- Host: GitHub
- URL: https://github.com/Hakku/finnish-humanizer
- Owner: Hakku
- License: mit
- Created: 2026-02-15T10:02:39.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T18:09:43.000Z (2 months ago)
- Last Synced: 2026-04-15T20:14:20.295Z (2 months ago)
- Topics: ai-humanizer, chatgpt, claude, claude-code, claude-skills, finnish, humanizer, llm, nlp
- Language: Python
- Homepage:
- Size: 195 KB
- Stars: 15
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Finnish Humanizer
[](LICENSE)
[](https://github.com/Hakku/finnish-humanizer/releases)
[](#tuetut-alustat)
**Finnish Humanizer** detects and removes AI-generated patterns from Finnish text — passive voice overuse, missing particles, translation structures, and flattery — making it read like a human wrote it.
Supports 15 platforms: Claude Code, Claude.ai, Cursor, GitHub Copilot, Windsurf, Cline, Continue, JetBrains AI, ChatGPT, Gemini Gems, and more.
**Quick start:** Download your platform's file from [`dist/`](dist/) and follow the installation guide below.
---
*Dokumentaatio jatkuu suomeksi.*
Tunnistaa ja poistaa AI-generoidun suomenkielisen tekstin tunnusmerkit.
## Sisältö
- [Ongelma](#ongelma)
- [Ratkaisu](#ratkaisu)
- [Tuetut alustat](#tuetut-alustat)
- [Asennus](#asennus)
- [Käyttö](#käyttö)
- [Rajoitukset](#rajoitukset)
- [Kehitys](#kehitys)
- [Lisenssi](#lisenssi)
## Ongelma
AI-generoitu suomi on tunnistettavaa: passiivin ylikäyttö, puuttuvat partikkelit, käännösrakenteet, mielistelevä sävy. Samat patternit toistuvat mallista riippumatta.
## Ratkaisu
27 AI-patternia (12 suomenkielistä + 15 universaalia) ja 5 tyylimerkintää. Näillä teksti muunnetaan luonnolliseksi suomeksi. Ei käännä, ei yksinkertaista. Poistaa vain AI-tunnusmerkit ja tuo kirjoittajan äänen esiin.
**Ennen:**
> 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.
**Jälkeen:**
> Iso juttu alalle. Tästä hyötyvät monet.
Täysi patternilista esimerkkeineen: [`finnish-humanizer/references/patterns.md`](finnish-humanizer/references/patterns.md)
## Tuetut alustat
| Alusta | Tyyppi | Tiedosto |
|--------|--------|----------|
| Claude Code | Editori | `finnish-humanizer/SKILL.md` |
| Cursor | Editori | `dist/cursor/finnish-humanizer.mdc` |
| GitHub Copilot | Editori | `dist/copilot/finnish-humanizer.instructions.md` |
| Windsurf | Editori | `dist/windsurf/finnish-humanizer.md` |
| Cline | Editori | `dist/cline/finnish-humanizer.md` |
| Continue | Editori | `dist/continue/finnish-humanizer.md` |
| JetBrains AI | Editori | `dist/jetbrains/finnish-humanizer.md` |
| Aider | Editori | `dist/generic/finnish-humanizer.md` |
| Bolt.new | Editori | `dist/generic/finnish-humanizer.md` |
| Amazon Q | Editori | `dist/generic/finnish-humanizer.md` |
| Claude.ai | Chat | `dist/finnish-humanizer.skill` |
| ChatGPT | Chat | `dist/chatgpt/instructions.md` |
| Gemini Gems | Chat | `dist/generic/finnish-humanizer.md` |
| Perplexity Spaces | Chat | `dist/generic/finnish-humanizer.md` |
| AGENTS.md | Cross | `dist/agents/AGENTS.md` |
## Asennus
### Koodieditorit
Claude Code
1. Kopioi `finnish-humanizer/`-kansio (sisältää `SKILL.md` + `references/`) polkuun `~/.claude/skills/finnish-humanizer/`
2. Käynnistä Claude Code uudelleen
3. Kutsu: `/finnish-humanizer [tiedostopolku tai teksti]`
Cursor
1. Kopioi `dist/cursor/finnish-humanizer.mdc` projektin `.cursor/rules/`-kansioon
2. Skill aktivoituu automaattisesti `.md`- ja `.txt`-tiedostoille
GitHub Copilot
1. Kopioi `dist/copilot/finnish-humanizer.instructions.md` projektin `.github/instructions/`-kansioon
2. Copilot aktivoi ohjeet automaattisesti `applyTo`-frontmatterin perusteella `.md`- ja `.txt`-tiedostoille
Windsurf
1. Kopioi `dist/windsurf/finnish-humanizer.md` projektin `.windsurf/rules/`-kansioon
2. Tai lisää globaalisti: Windsurf Settings → Rules → lisää tiedoston sisältö
Cline
1. Kopioi `dist/cline/finnish-humanizer.md` projektin `.clinerules/`-kansioon
2. Tai lisää Cline-asetuksista: Custom Instructions → liitä tiedoston sisältö
Continue
1. Kopioi `dist/continue/finnish-humanizer.md` projektin `.continue/rules/`-kansioon
2. Ohjeet aktivoituvat automaattisesti `.md`- ja `.txt`-tiedostoille (`globs`-kentän perusteella)
JetBrains AI
1. Kopioi `dist/jetbrains/finnish-humanizer.md` projektin `.junie/guidelines.md`-tiedostoksi (Junie)
2. Tai AI Assistant: Settings → AI Assistant → Project-level prompt → liitä sisältö
Aider
```
aider --read dist/generic/finnish-humanizer.md
```
Lisää `references/patterns.md` tarvittaessa:
```
aider --read dist/generic/finnish-humanizer.md --read finnish-humanizer/references/patterns.md
```
Bolt.new
1. Avaa projekti Bolt.new:ssa
2. Liitä `dist/generic/finnish-humanizer.md`:n sisältö **Project Prompt** -kenttään
Amazon Q
1. Kopioi `dist/generic/finnish-humanizer.md` projektin `.amazonq/rules/`-kansioon
2. Amazon Q lukee ohjeet automaattisesti
### Chat-alustat
Claude.ai (projekti)
1. [Lataa `finnish-humanizer.skill`](https://github.com/Hakku/finnish-humanizer/releases/latest/download/finnish-humanizer.skill) (tai `dist/finnish-humanizer.skill` reposta)
2. Avaa [claude.ai](https://claude.ai) ja luo uusi projekti
3. Lisää `.skill`-tiedosto projektin **Project knowledge** -osioon
Vaihtoehtoisesti: kopioi `finnish-humanizer/SKILL.md`:n sisältö projektin **Custom instructions** -kenttään ja lisää `references/patterns.md` tiedostona.
ChatGPT
**Custom GPT (valmis):** [Finnish Humanizer — Luonnollista suomea](https://chatgpt.com/g/g-69930f3ef1bc8191b2b998e0e01dc99e-finnish-humanizer-luonnollista-suomea) (vaatii Plus/Pro)
**ChatGPT Projects:**
1. Luo uusi projekti ChatGPT:ssä
2. Lataa `dist/chatgpt/instructions.md` projektin Custom instructions -kenttään
3. Lataa `dist/chatgpt/patterns.md` projektin tiedostoiksi (ChatGPT-optimoitu patternilista)
4. Ohjeet aktivoituvat projektin keskusteluissa
Huom: `instructions.md` on ChatGPT-optimoitu rakenne (ei XML-tageja)
Gemini Gems
1. Avaa [Gemini](https://gemini.google.com) → Gem Manager → Create
2. Liitä `dist/generic/finnish-humanizer.md`:n sisältö Gem-ohjeiksi
3. Lataa `finnish-humanizer/references/patterns.md` liitteeksi
4. Tallenna ja käytä Gemiä keskustelussa
Perplexity Spaces
1. Luo uusi Space [Perplexity](https://perplexity.ai):ssä
2. Lataa `dist/generic/finnish-humanizer.md` ja `finnish-humanizer/references/patterns.md` Spacen tiedostoiksi
3. Ohjeet vaikuttavat Spacen keskusteluissa
### Cross-platform
AGENTS.md
Projektitason AI-agenttiohjeet. Kopioi `dist/agents/AGENTS.md` projektin juureen. Kaikki AI-agentit (Claude Code, Cursor, Copilot jne.) lukevat AGENTS.md-tiedoston automaattisesti.
API (system prompt)
Lisää `finnish-humanizer/SKILL.md`:n sisältö system-promptiin ja `references/patterns.md` kontekstina.
## Käyttö
Liitä suomenkielinen teksti ja pyydä luonnollistamaan:
```
Luonnollista tämä teksti:
[tekstisi tähän]
```
Muita toimivia komentoja:
- "Poista AI-tuntu tästä tekstistä"
- "Tee tästä ihmismäisempää"
- "Humanisoi tämä"
### Analysointi vs. suora korjaus
- **Oletus:** Luonnollistaa tekstin suoraan ja palauttaa korjatun version + muutosyhteenvedon.
- **Pitkä teksti (>500 sanaa):** Analysoi automaattisesti ensin (näyttää löydetyt patternit), sitten luonnollistaa. Estää massiiviset sokkorewritet.
- **"Analysoi ensin":** Palauttaa vain löydetyt AI-patternit ilman korjauksia, voit valita mitkä korjataan.
### Muutosyhteenveto
Oletuksena skill palauttaa tekstin lisäksi lyhyen listan tehdyistä muutoksista. Jos haluat pelkän tekstin:
```
Luonnollista tämä teksti. Älä selitä muutoksia.
```
## Rajoitukset
- Toimii vain suomenkieliselle tekstille
- Ei muuta asiasisältöä, vain esitystapaa
- Ei yksinkertaista, virallinen teksti pysyy virallisena
- Ei korvaa ihmisen editointia — poistaa AI-tunnusmerkit, mutta ei tee tekstistä "hyvää"
## Kehitys
Generoi dist-tiedostot kanonisesta lähteestä (`finnish-humanizer/SKILL.md`):
```bash
py build.py
```
Arkkitehtuuripäätökset ja eval-kehys: [DEVELOPMENT.md](DEVELOPMENT.md).
## Lisenssi
MIT. Katso [LICENSE](LICENSE)