How to use the Finnish Humanizer agent skill

What is an agent skill, and what does this one do?

An agent skill is a folder of instructions and optional files that an AI agent loads when a task matches the skill's description. This one is called finnish-humanizer and is defined in a SKILL.md file.

When it is active, the agent checks Finnish text against 26 patterns: 12 specific to Finnish and 14 that appear in any language but are fixed in Finnish. Examples include overused passives, missing particles such as -han/-hän, pa/-pä, kyllä and vaan, English-style sentence structure, and inflated praise. The agent then rewrites those parts while keeping the original meaning and formality level.

• Keeps the factual content unchanged and does not add new claims or examples.
• Keeps formal text formal; only the AI patterns are removed.
• Leaves code samples, technical terms and quotations as they are.
• Works on the Finnish parts of mixed Finnish and English text and leaves English sections alone.

How do you install the finnish-humanizer skill?

Download the skill ZIP from this page and unzip it. For Claude Code, put the unzipped folder in your personal skills directory ~/.claude/skills/, or in a project's .claude/skills/ folder if you want it only for that project.

In the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.

• Personal use across projects: ~/.claude/skills/
• Single project only: .claude/skills/ inside the project folder
• Claude apps: Settings → Capabilities → Skills, then upload the ZIP

How do you trigger the skill with natural requests?

You do not need a special command. The skill is meant to load when you ask the agent to humanize, naturalize or remove the AI feel from Finnish text, or when you edit .md or .txt files that contain Finnish content.

Paste the text and say what you want in plain words. You can also name the file if the text lives in a document.

• "Humanize this Finnish email so it sounds like I wrote it."
• "Remove the AI feel from this Finnish blog post."
• "Naturalize the Finnish text in docs/article.md."
• "Tee tästä suomenkielisestä tekstistä luonnollisempi."

What happens with short and long texts?

For texts under 500 words, the agent rewrites the text directly and returns the revised version with a short list of changes. For longer texts, it first lists the patterns it found and where they occur, shows you the findings, and asks about unclear cases before making changes. An unclear case is one where it cannot tell whether a feature is an AI pattern or a deliberate choice by the author.

If you only want the rewritten text with no explanation, say so and the agent will leave out the change summary.

What examples show the difference?

The skill's examples show how common patterns are fixed. In one, a passive-heavy sentence about an app is rewritten in active Finnish. In another, a sentence without particles gains natural ones: "Tämä on totta" becomes "Onhan se totta. Tilanne on vaan monimutkainen."

Inflated praise is also removed. "Hyvä kysymys! ..." is replaced with a plain statement of the topic.

• Passive overuse: "Sovellus on suunniteltu tarjoamaan..." becomes "Sovelluksella hallitset omat tietosi."
• Universal inflation: a sentence calling everything "merkittävä" and "keskeinen" becomes "Tekoälystä tulee tärkeä työkalu moniin ongelmiin."

What does the skill need, and what about scripts and network?

The skill lists no required tools or packages. It does not run scripts and does not use the network, according to its description. It reads the SKILL.md instructions and the references/patterns.md file, which contains the full list of 26 patterns with examples.

Because it runs no scripts and makes no network calls, the main thing to review is the text you send it. Check the output before publishing, especially for legal or contractual documents.

• Required: nothing listed
• Runs scripts: no
• Uses network: no
• Files: SKILL.md and references/patterns.md

What are the limits and useful tips?

The skill is not a grammar checker or a translator. It may miss errors, and it can change meaning if used that way. The rewrite changes phrasing, so do not use it on texts whose exact wording must be kept, such as legal or contractual documents.

For best results, give the agent a short sample of your own writing so it keeps your voice, and review each change in the summary. Mixed Finnish and English text is handled by changing only the Finnish parts.

• Do not use it as a grammar checker or translator.
• Review the change list before you publish.
• Ask for the text only, without a summary, if you do not need the reasoning.
• Keep legal and contractual wording out of the rewrite.