Agent skill

Oikeustutkimus

by akunikkola in akunikkola/claude-for-legal-finland

Suomalaisen voimassa olevan lainsäädännön ja oikeuskäytännön haku, lukeminen ja oikea viittaaminen oik.ai-, laki.ai- tai Finlex-MCP:n avulla.

MITAuto-check passed

Install Oikeustutkimus

skills CLI
$ npx skills add akunikkola/claude-for-legal-finland --skill oikeustutkimus -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install akunikkola/claude-for-legal-finland oikeustutkimus --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/akunikkola/claude-for-legal-finland.git skills-src && mkdir -p .claude/skills && cp -r skills-src/juristi/skills/oikeustutkimus .claude/skills/oikeustutkimus && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
oikeustutkimus
GitHub stars
109
Token cost
~1.9k tokens
SKILL.md length
708 words
Files
3 (incl. references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Suomalaisen voimassa olevan lainsäädännön ja oikeuskäytännön haku, lukeminen ja oikea viittaaminen oik.ai-, laki.ai- tai Finlex-MCP:n avulla.

  • Works in 5 steps: Tunnista, mitä haetaan → Hae ja lue → Varmista ajantasaisuus → …
  • SKILL.md covers Käytettävät työkalut, Työnkulku, Mitä EI tehdä and Esimerkki, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Oikeustutkimus is an agent skill from akunikkola/claude-for-legal-finland. Suomalaisen voimassa olevan lainsäädännön ja oikeuskäytännön haku, lukeminen ja oikea viittaaminen oik.ai-, laki.ai- tai Finlex-MCP:n avulla. Käytä tätä skilliä AINA kun tarvitaan ajantasaista lakitekstiä, pykälän sisältö, KKO:n tai KHO:n ennakkopäätös, hovioikeuden, markkinaoikeuden, työtuomioistuimen tai vakuutusoikeuden ratkaisu, hallituksen esityksen perusteluja, tai kun käyttäjä kysyy "mitä laki sanoo", "onko tästä oikeuskäytäntöä", "mikä on voimassa oleva pykälä", viittaa säädösnumeroon (esim. 410/2015) tai…

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/tyokalut.md`).

It works with Model Context Protocol. The repository describes itself as: Avoimen lähdekoodin Claude-skillit ja -plugarit suomalaiseen juridiseen työhön — Finnish legal skills & plugins for Claude (Finlex, oik.ai, KKO/KHO). The licence is MIT.

Example prompts

  • “mitä laki sanoo”
  • “onko tästä oikeuskäytäntöä”
  • “mikä on voimassa oleva pykälä”
  • “/oikeustutkimus”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Tunnista, mitä haetaan
  2. Hae ja lue
  3. Varmista ajantasaisuus
  4. Viittaa oikein
  5. Merkitse lähde

What it can do on your machine

Read from SKILL.md and the folder at commit 6294330. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Oikeustutkimus loads about 1.9k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 169 tokens; SKILL.md has 708 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~169
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from akunikkola/claude-for-legal-finland at commit 6294330, republished under its MIT licence (© akunikkola). 708 words, ~1,922 tokens.

Download SKILL.mdSave it as .claude/skills/oikeustutkimus/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
oikeustutkimus
description
Suomalaisen voimassa olevan lainsäädännön ja oikeuskäytännön haku, lukeminen ja oikea viittaaminen oik.ai-, laki.ai- tai Finlex-MCP:n avulla. Käytä tätä skilliä AINA kun tarvitaan ajantasaista lakitekstiä, pykälän sisältö, KKO:n tai KHO:n ennakkopäätös, hovioikeuden, markkinaoikeuden, työtuomioistuimen tai vakuutusoikeuden ratkaisu, hallituksen esityksen perusteluja, tai kun käyttäjä kysyy "mitä laki sanoo", "onko tästä oikeuskäytäntöä", "mikä on voimassa oleva pykälä", viittaa säädösnumeroon (esim. 410/2015) tai ratkaisutunnukseen (KKO:2024:15). Triggeröi myös aina ennen kuin lainaat pykälää tai oikeustapausta muistista – tarkista se ensin lähteestä.

Oikeustutkimus — voimassa oleva laki ja oikeuskäytäntö lähteestä

Tämä skill varmistaa, että juridiset väitteet perustuvat todelliseen, voimassa olevaan lakitekstiin ja oikeisiin tuomioistuinratkaisuihin — ei mallin muistiin. Suomen lainsäädäntö muuttuu jatkuvasti, ja muistinvaraiset pykälät ja ratkaisutunnukset menevät usein pieleen. Hae lähde aina kun voit.

Perusperiaate: ennen kuin lainaat pykälän, säädösnumeron tai oikeustapauksen, hae se lähteestä. Jos lähdettä ei ole saatavilla, merkitse väite muistinvaraiseksi äläkä esitä sitä varmistettuna. Katso juristi/CLAUDE.md → Ajantasaisuuden pakko.


Käytettävät työkalut

Tämä skill käyttää oik.ai-MCP:tä tai vaihtoehtoisesti laki.ai-MCP:tä (tai muuta vastaavaa Finlex-MCP:tä). Molemmat tuovat saman: ajantasaisen lain, oikeuskäytännön ja esityöt lähteestä — vain työkalujen nimet eroavat. Käytä sitä konnektoria, joka on liitettynä. Tarkemmat hakustrategiat, työkalut ja laki.ai-vastineet: lue references/tyokalut.md. Asennus: juuren QUICKSTART.md.

TyökaluKäyttö
get_legislationHae ajantasainen säädös tai sen osa. Parametrit: year + number (esim. 2015 / 410), valinnaiset part / chapter / section, language (fin/swe). Jätä osat pois → koko laki; pelkkä chapter → koko luku. Tukee kirjainpäätteitä (esim. 226b).
search_decisionsHae oikeustapauksia hakusanoilla. Parametrit: query, valinnainen court (Korkein oikeus, Korkein hallinto-oikeus, Hallinto-oikeudet, Hovioikeudet, Markkinaoikeus, Työtuomioistuin, Vakuutusoikeus), limit, offset. Palauttaa tekstikatkelmia ja document_path-arvon.
get_decisionHae ratkaisun koko teksti document_path-arvolla, joka saatiin search_decisions-haun tuloksesta.

Jos MCP ei ole käytettävissä: kerro käyttäjälle, ettei lähdettä voitu tarkistaa, ja että vastaus perustuu muistiin. Merkitse jokainen lainkohta [muistinvarainen — tarkista Finlexistä/oik.ai:sta]. Älä esitä muistinvaraista pykälää varmistettuna.


Työnkulku

1. Tunnista, mitä haetaan
  • Tietty pykälä tai laki → get_legislation säädösnumerolla. Jos käyttäjä antaa vain lain nimen, päättele säädösnumero (tarkista hakemalla, älä arvaa numeroa).
  • Oikeudellinen kysymys ilman tunnettua pykälää → search_decisions kuvaavilla hakusanoilla, tarvittaessa court-rajauksella; tunnista relevantti laki ratkaisuista ja hae sitten pykälä get_legislation-työkalulla.
  • Tietty ennakkopäätös (esim. KKO:2024:15) → search_decisions tunnuksella, sitten get_decision.
2. Hae ja lue
  • Hae ajantasainen versio, ei alkuperäistä säädöstä. Tarkista, ettei pykälää ole kumottu tai muutettu.
  • Lue varsinainen pykäläteksti — älä tyydy hakukatkelmaan, jos sisältö on olennainen.
  • Oikeustapauksissa lue ratkaisun lopputulos ja perustelut koko tekstistä (get_decision), älä pelkkää otsikkoa tai hakukatkelmaa. Hakukatkelma voi olla harhaanjohtava ilman kontekstia.
3. Varmista ajantasaisuus
  • Onko laki voimassa? Onko pykälää muutettu äskettäin? Onko siirtymäsäännöksiä?
  • Onko ennakkopäätöksen jälkeen tullut uudempaa, tulkintaa muuttavaa käytäntöä?
  • Huomioi: Finlexin/oik.ai:n ajantasainen versio voi olla muutaman viikon jäljessä uusimmista muutoksista. Jos asia on tuore, mainitse tämä varaus.
4. Viittaa oikein

Käytä vakiintuneita suomalaisia viittausmuotoja (täydet ohjeet: ../juristi/references/viittaukset.md ja ../juristi/references/lahteet.md):

  • Säädös, ensimaininnalla nimi + numero: kuntalain (410/2015) 7 §:n 1 momentin mukaan…
  • Ennakkopäätös: Korkein oikeus on ratkaisussaan KKO:VVVV:NN katsonut, että… (tunnus paikkamerkki — täytä vain lähteestä tarkistetulla ratkaisulla)
  • Alempi tuomioistuin (ei prejudikaatti): Helsingin hovioikeuden tuomio 15.3.2024 nro 312 (S 23/1234)
  • Hallituksen esitys: HE 268/2014 vp, s. 145
5. Merkitse lähde

Liitä jokaiseen lainattuun pykälään ja ratkaisuun lähdemerkintä: (oik.ai), (laki.ai) tai (Finlex, ajantasainen). Erota selvästi:

  • mikä on suora sisältö lähteestä,
  • mikä on sinun tulkintasi/yhteenvetosi, ja
  • mikä vaatii asiantuntijan vahvistuksen ([varmista — juristin arvioitava]).

Show full SKILL.md (277 more words)Show less

Mitä EI tehdä

  • Älä keksi pykälää, säädösnumeroa, momenttia tai ratkaisutunnusta. Jos et löydä, sano se.
  • Älä lainaa hakukatkelmaa kuin se olisi koko pykälä tai ratkaisun lopputulos.
  • Älä esitä kumottua tai muutettua säännöstä voimassa olevana.
  • Älä tee lopullista oikeudellista johtopäätöstä — tuotos on tarkistettava luonnos (CLAUDE.md → Vastuuvapaus).

Esimerkki

Käyttäjä: Mitä kuntalaki sanoo kunnan toiminta-ajatuksesta ja saako valtuusto delegoida toimivaltaansa?

  1. get_legislation (year 2015, number 410) → hae relevantit luvut (esim. kunnan tehtävät, toimielimet ja toimivallan siirto).
  2. Lue varsinaiset pykälät; poimi toimivallan siirtoa koskeva säännös täsmällisesti.
  3. search_decisions (query "kunnan toimivallan siirtäminen delegointi", court "Korkein hallinto-oikeus") → tunnista relevantti KHO-käytäntö; get_decision koko tekstille.
  4. Vastaa: lainaa pykälä lähdemerkinnällä, tiivistä KHO-linja, ja merkitse selvästi tulkinnanvaraiset kohdat tarkistettaviksi.

Mitä tämä skill EI tee

  • Ei korvaa juristin oikeudellista arviota eikä kanna vastuuta lopputuloksesta. Skill tuo lähteen pöytään; sen soveltaminen tapaukseen ja lopullinen vastuu kuuluvat pätevälle ihmiselle.
  • Ei vahvista pykälää eikä ratkaisutunnusta muistista. Jos MCP:tä ei ole saatavilla, jokainen lainkohta merkitään [muistinvarainen — tarkista Finlexistä/oik.ai:sta] — sitä ei esitetä varmistettuna.
  • Ei takaa ehdotonta ajantasaisuutta. Finlexin/oik.ai:n ajantasainen versio voi olla viikkoja jäljessä tuoreimmista muutoksista; tuoreissa muutoksissa tästä on mainittava varaus.
  • Ei tee lopullista oikeudellista johtopäätöstä lähteen pohjalta. Tuotos erottaa suoran lähdesisällön, oman tiivistyksen ja asiantuntijan vahvistusta vaativan tulkinnan toisistaan.
  • Ei tulkitse hakukatkelmaa koko pykäläksi tai ratkaisun lopputulokseksi. Olennainen sisältö luetaan varsinaisesta pykälä- tai ratkaisutekstistä.
  • Ei kata muiden maiden lainsäädäntöä eikä yleistä oikeuskirjallisuutta. Vain Suomen voimassa oleva laki ja oikeuskäytäntö (sekä relevantti EU-oikeus) MCP-lähteistä.

Jatka tästä

  • Viittausten muoto, taivutus tai lakikielen säännöt kaipaavat tarkistusta → /juristi:juristi
  • Tarkistetut lähteet pitää koota asiakirjan laaduntarkistukseen → /juristi:asiakirjan-tarkistus
  • Lähdehausta jatketaan sopimusehdon laatimiseen tai tarkistukseen → /sopimukset:sopimuksen-laatiminen tai /sopimukset:sopimuksen-tarkistus
  • Haettu oikeuskäytäntö liittyy työsuhteen päättämiseen tai riita-asiaan → /tyooikeus:tyosuhteen-paattaminen tai /riidanratkaisu:todistelu
  • Lähde koskee hallintopäätöstä tai muutoksenhakua → /hallinto-oikeus:hallintopaatos tai /hallinto-oikeus:muutoksenhaku

© akunikkola, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in juristi/skills/oikeustutkimus of akunikkola/claude-for-legal-finland.

  • SKILL.md
  • agents/openai.yaml
  • references/tyokalut.md

Open the folder on GitHubat commit 6294330

Compare with similar skills

Oikeustutkimus next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Oikeustutkimus compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Oikeustutkimus this skillakunikkola/claude-for-legal-finland109—~1.9kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Figma use_figma Plugin API Ruleswarpdotdev/warp65k4 repos~4.4kAutomated safety check: PassAGPL-3.0
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills8.5k6 repos~3.2kAutomated safety check: NotesApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Stitch to Remotion Walkthrough Videos

    google-labs-code/stitch-skills

    Official

    Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.

    8.5k GitHub starsUsed in 6 repos~3.2k tokens
    Media & CreativeAuto-check: notes
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed

More from akunikkola/claude-for-legal-finland

All 62 skills in this repo
  • Source-Cited Document Comparison Tables

    akunikkola/claude-for-legal-finland

    Turns a batch of similar documents, or a single one, into a table where every cell cites its source clause and carries a confidence score, with missing data marked as not mentioned.

    109 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Finnish Legal Document Review

    akunikkola/claude-for-legal-finland

    Checks a Finnish legal document, such as a contract, statement, appeal or decision, in eight stages, looking for errors, gaps and risks before it is signed or submitted.

    109 GitHub stars~3.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Kaytantoprofiili

    akunikkola/claude-for-legal-finland

    Plugarikokoelman räätälöinti organisaation omiin käytäntöihin.

    109 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Finnish Legal Matter Intake

    akunikkola/claude-for-legal-finland

    Starts a new Finnish legal matter by scanning documents for deadlines first, then summarizing parties and goals, interviewing for missing details and setting up a case workspace.

    109 GitHub stars~2.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Avioliitto Ja Ositus

    akunikkola/claude-for-legal-finland

    Avioliiton varallisuussuhteet ja niiden purkautuminen Suomessa (avioliittolaki 234/1929).

    109 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Esitutkinta Ja Pakkokeinot

    akunikkola/claude-for-legal-finland

    Esitutkinta ja pakkokeinot Suomen rikosprosessissa (esitutkintalaki 805/2011, pakkokeinolaki 806/2011) avustajan näkökulmasta.

    109 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Oikeustutkimus

What does Oikeustutkimus do?

Suomalaisen voimassa olevan lainsäädännön ja oikeuskäytännön haku, lukeminen ja oikea viittaaminen oik.ai-, laki.ai- tai Finlex-MCP:n avulla. Oikeustutkimus is an agent skill from akunikkola/claude-for-legal-finland.ai- tai Finlex-MCP:n avulla.

How do I install Oikeustutkimus in Claude Code?

Run `npx skills add akunikkola/claude-for-legal-finland --skill oikeustutkimus -a claude-code`. Or copy the skill folder (juristi/skills/oikeustutkimus in akunikkola/claude-for-legal-finland) into .claude/skills/oikeustutkimus in your project. Claude Code loads it when a task matches its description.

How do I install Oikeustutkimus in Codex?

Run `npx skills add akunikkola/claude-for-legal-finland --skill oikeustutkimus -a codex`. Or copy the skill folder (juristi/skills/oikeustutkimus in akunikkola/claude-for-legal-finland) into .agents/skills/oikeustutkimus in your project. Codex loads it when a task matches its description.

Can I use Oikeustutkimus in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add akunikkola/claude-for-legal-finland --skill oikeustutkimus -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oikeustutkimus, .gemini/skills/oikeustutkimus, .github/skills/oikeustutkimus and .opencode/skills/oikeustutkimus in your project.

What does Oikeustutkimus need to run?

SKILL.md names no scripts, command-line tools or credentials: Oikeustutkimus is instructions for the agent only.

Does Oikeustutkimus access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Oikeustutkimus safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Oikeustutkimus use?

Oikeustutkimus is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Oikeustutkimus use?

About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Oikeustutkimus?

Skills that share tags, products or a category with Oikeustutkimus: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Figma use_figma Plugin API Rules (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oikeustutkimus?

akunikkola (a GitHub user) maintains it in akunikkola/claude-for-legal-finland, which has 109 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on July 6, 2026.

Source: akunikkola/claude-for-legal-finland on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.