Asiakirjan Tarkistus logo

Asiakirjan Tarkistus

Community
akunikkola
asiakirjan-tarkistus

Juridisen asiakirjan järjestelmällinen monivaiheinen laaduntarkistus suomalaisessa kontekstissa. Käytä tätä skilliä, kun juridinen asiakirja pitää tarkistaa ennen käyttöä: sopimus, lausunto, valitus, hallintopäätös, muistio, sopimusluonnos, ohjesääntö tai muu oikeudellinen asiakirja. Triggeröi kun käyttäjä pyytää tarkistamaan, oikolukemaan tai laadunvarmistamaan juridisen tekstin, etsimään riskejä tai aukkoja, tai varmistamaan asiakirjan ennen allekirjoitusta, lähettämistä tai jättämistä viranomaiselle tai tuomioistuimeen.

Overview

Publisherakunikkola
Repositoryclaude-for-legal-finland
Skill nameasiakirjan-tarkistus
Stars
115
Forks
10
Bundled files
1
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 1 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by akunikkola on GitHub. Read the source before you install it.

Installation

Install the Asiakirjan Tarkistus AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/akunikkola/claude-for-legal-finland/tree/main/juristi/skills/asiakirjan-tarkistus
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/akunikkola/claude-for-legal-finland.git /tmp/claude-for-legal-finland
mkdir -p .claude/skills
cp -r /tmp/claude-for-legal-finland/juristi/skills/asiakirjan-tarkistus .claude/skills/asiakirjan-tarkistus
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Asiakirjan Tarkistus in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Asiakirjan Tarkistus on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Asiakirjan Tarkistus is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Asiakirjan tarkistus — monivaiheinen juridinen laaduntarkistus

Tämä skill tarkistaa juridisen asiakirjan järjestelmällisesti useassa vaiheessa. Tavoite on löytää virheet, aukot ja riskit ennen kuin asiakirja otetaan käyttöön. Perusteellisuus menee nopeuden edelle — huolellinen tarkistus säästää moninkertaisesti ajan, jonka se vie.

Vastuuvapaus: tämä on laadunvarmistuksen apuväline, joka täydentää mutta ei korvaa ihmisen oikeudellista harkintaa. Lopullisen arvion asiakirjan laadusta, riskin hyväksymisestä ja käyttöönotosta tekee aina pätevä ihminen. Katso juristi/CLAUDE.md → Vastuuvapaus.


Lähdetarkistus on pakollinen

Aina kun asiakirja viittaa lakiin, pykälään tai oikeuskäytäntöön ja viittauksen oikeellisuus on olennainen, käytä oikeustutkimus-skilliä ja tarkista lainkohta oik.ai-/Finlex-MCP:stä. Älä vahvista lakiviittausta muistista. Jos lähdettä ei voi tarkistaa, merkitse löydös [ei voitu tarkistaa lähteestä].

Koko asiakirjan viitteiden kertatarkistukseen voi käyttää tämän plugarin lahdetarkastaja-agenttia (agents/lahdetarkastaja.md): se poimii kaikki viittaukset, verifioi ne lähteestä ja palauttaa tarkistustaulukon (✅/⚠️/❌) — hyvä ajaa erillisenä vaiheena ennen asiakirjan lähettämistä.

Word-dokumentit (.docx)

Jos tarkistettava asiakirja on Word-tiedostona, käytä adeu-MCP:tä (kun saatavilla): read_docx lukee tekstin jälkimuutoksineen ja kommentteineen, ja mode: "appendix" paljastaa määritellyt termit, ankkurit ja ristiviittausten kohteet — hyödynnä tätä vaiheissa 3–4 (kieli, rakenne, määritelmät). Kun haluat viedä löydökset takaisin dokumenttiin, käytä process_document_batch, joka kirjoittaa korjaukset natiiveina Word-jälkimuutoksina ja kommentteina muotoilua rikkomatta. Aseta author_name selkeästi. Lue ID:t (Chg:N/Com:N) aina tuoreella read_docx-kutsulla ennen accept/reject/reply-toimia.


Löydös-skeema

Raportoi jokainen löydös tässä muodossa, jotta ne ovat jäljitettäviä:

TUNNUS: [vaihe#-vakavuus-juokseva]
VAKAVUUS: [Kriittinen / Merkittävä / Vähäinen]
VAIHE: [1–8]
SIJAINTI: [pykälä/kohta/sivu]
TYYPPI: [vaihekohtainen luokka]
KUVAUS: [mikä ongelma on]
MIKSI MERKITYKSELLINEN: [vaikutus ja riski]
KORJAUSEHDOTUS: [konkreettinen korjaus]
LUOTTAMUS: [Korkea / Keskitaso / Matala]
TILA: [Avoin / Ohjattu asiantuntijan tarkistukseen]

Jokaisessa vaiheessa ilmoitetaan luottamustaso ja mahdolliset pysäytysehdot (kriittiset ongelmat, jotka on ratkaistava ennen jatkamista).


Vaihe 1 — Asiakirjan ymmärtäminen ja konteksti

Selvitä ennen tarkistusta:

  • Asiakirjatyyppi: sopimus, lausunto, valitus/oikaisuvaatimus, hallintopäätös, muistio, ohje-/johtosääntö, sopimusluonnos, HE-/säädösluonnos, testamentti, valtakirja jne. Mitkä ovat tämän tyypin vakiintuneet vaatimukset?
  • Jurisdiktio ja oikeudenala: Suomen kansallinen oikeus, EU-oikeus, Ahvenanmaan erityisasema, alakohtainen sääntely. Mitkä lait ovat relevantteja?
  • Osapuolet ja yleisö: ketkä ovat osapuolia, kuka lukee, mikä on heidän juridinen osaamisensa ja valta-asemansa (esim. kuluttaja vs. elinkeinonharjoittaja, työnantaja vs. työntekijä, viranomainen vs. asianosainen)?
  • Tarkoitus: mitä asiakirjan on määrä saada aikaan?
  • Panokset ja riski: taloudelliset, oikeudelliset ja maineeseen liittyvät seuraukset, jos asiakirja epäonnistuu.

Pysäytysehto: jos asiakirjatyyppiä tai jurisdiktiota ei voi määrittää → kysy käyttäjältä ennen jatkamista.


Vaihe 2 — Käytettävyys ja rakenteen palvelevuus

Palveleeko asiakirjan muoto ja rakenne todellista käyttöä?

  • Onko muoto oikea sisällölle ja yleisölle? Löytääkö lukija olennaisen (otsikointi, sisällys, selkeät kohdat)?
  • Onko velvoitteet, oikeudet, määräajat ja toimet selvästi merkitty? Tietääkö lukija, mitä hänen pitää tehdä ja milloin?
  • Taloudelliset sitoumukset (jos asiakirjaan liittyy maksuja): ovatko hinnat, irtisanomis- ja peruutusehdot, automaattiset jatkumiset ja korotusmekanismit selvästi ja näkyvästi esillä — ei haudattuna alaviitteeseen?

Vaihe 3 — Kielen ja ilmaisun selkeys

Tunnista kielelliset ongelmat ennen sisällön tarkistusta (korjaukset muuttavat tekstiä).

  • Käytä juristi-skilliä ja sen referenssejä (references/lakikieli.md, references/suomen-kieli.md): yhdyssanat, pilkutus, pykäläviittausten muoto, 3-3-3-sääntö, johdonmukainen termistö.
  • Monitulkintaisuus: epämääräiset ilmaukset ("kohtuullinen aika", "viipymättä", "olennainen") — onko ne määritelty tai sidottu kontekstiin?
  • Johdonmukainen termistö: samasta asiasta sama termi, ei synonyymeja. Vaihteleva termi luo tulkintariidan.
  • Vääräperäinen täsmällisyys: lupaako teksti tarkkuutta, jota ei voi toteuttaa ("24 tunnin kuluessa", kun todellinen kyky on 2–3 arkipäivää)? Näyttävätkö esimerkkiluettelot tyhjentäviltä, vaikka ovat vain esimerkkejä (lisää "muun muassa")?

Vaihe 4 — Rakenteellinen eheys

  • Sisäiset viittaukset: osoittavatko kohta- ja liiteviittaukset olemassa oleviin kohtiin? Ei orpoja eikä kehäviittauksia.
  • Numerointi ja otsikot: juokseva ja yhtenäinen, ei kaksoiskappaleita.
  • Määritelmät: onko kaikki määritellyt termit todella määritelty ja käytetty johdonmukaisesti? Onko käyttämättömiä tai ristiriitaisia määritelmiä?
  • Ulkoiset viittaukset: jos olennainen sisältö on vain ulkoisen linkin tai erikseen viitatun asiakirjan takana, joka voi muuttua yksipuolisesti — se on hauras. Merkitse.
  • Täydellisyys: ovatko luvatut liitteet mukana, allekirjoituslohkot ja osapuolet täydellisiä?

Vaihe 5 — Sisällöllinen oikeellisuus

Jaa kahteen tasoon sen mukaan, mitä voidaan luotettavasti tarkistaa.

Taso 1 — sisäinen oikeellisuus (korkea luottamus)

  • Sisäinen johdonmukaisuus: eivätkö kohdat ole keskenään ristiriidassa faktoista?
  • Määritellyt termit: käytetäänkö niitä määritelmänsä mukaisesti?
  • Laskelmat ja päivämäärät: täsmäävätkö summat, prosentit ja määräaikalaskelmat? Ovatko päivämäärät loogisia? Tarkista määräaikojen laskenta (esim. arkipäivät vs. kalenteripäivät; pyhät; viikonloppuun osuva määräpäivä).
  • Ajantasaisuus: viittaako asiakirja kumottuun lakiin, vanhentuneeseen standardiin, lakkautettuun viranomaiseen tai vanhaan nimeen (esim. ennen organisaatiouudistusta)?

Taso 2 — ulkoiset oikeuslähteet (vaatii tarkistuksen lähteestä)

Tarkista nämä oikeustutkimus-skillillä (oik.ai/Finlex), älä muistista:

  • Lakiviittaukset: onko säädösnumero, pykälä ja momentti oikein ja voimassa?
  • Oikeustapausviittaukset: onko ratkaisutunnus oikea ja tukeeko ratkaisu väitettä?
  • Pakottava lainsäädäntö: onko ehto ristiriidassa pakottavan säännöksen kanssa (esim. työsopimuslaki, kuluttajansuojalaki)?
  • HE-viittaukset: onko numero ja sivu oikein?

Merkitse jokainen lähteestä tarkistettava kohta löydökseksi, jossa LUOTTAMUS: Matala ja TILA: Ohjattu asiantuntijan tarkistukseen, ellei sitä voitu tarkistaa MCP:stä.

Pysäytysehto: yli 5 tason 1 oikeellisuusvirhettä → korjaa ennen jatkamista. Keskeisiä lakiviittauksia ei voitu tarkistaa → ohjaa asiantuntijalle.


Vaihe 6 — Täydellisyys ja aukkoanalyysi

  • Kattavuus: ovatko kaikki tarpeelliset asiat käsitelty? Puuttuuko vakiolausekkeita (esim. sovellettava laki, riidanratkaisu, voimassaolo, irtisanominen, vastuunrajoitus)?
  • Hiljaisuus, joka sattuu:
    • Vastuunjako: onko selvää, kuka tekee mitä? Onko velvoite, jolle ei ole vastuutahoa?
    • Seuraamukset: mitä tapahtuu, jos velvoitetta rikotaan? Onko oikeus ilman täytäntöönpanokeinoa?
    • Etusijasäännöt: kumpi ehto voittaa ristiriidassa? Onko sovellettu pätevyysjärjestystä?
    • Siirtymämekaniikka: miten edetään tilasta A tilaan B — kuka hyväksyy, ilmoittaa, toimii, missä järjestyksessä?
  • Skenaariotestaus: mitä tapahtuu keskeisissä tilanteissa (sopimusrikkomus, viivästys, ylivoimainen este, irtisanominen)?
  • Asiakirjatyypin pakolliset osat: sopimukselta sopimuksen syntyedellytykset; valitukselta vaatimukset, perusteet ja määräaika; hallintopäätökseltä perustelut ja muutoksenhakuohje (hallintolaki).

Vaihe 7 — Riski ja pätevyys (riskisignaalit, ei johtopäätöksiä)

Kaikki tämän vaiheen löydökset ovat riskisignaaleja, jotka vaativat asiantuntijan arvion — eivät lopullisia oikeudellisia johtopäätöksiä.

  • Pätevyys ja täytäntöönpanokelpoisuus: voiko ehto olla pätemätön tai sovitteluun johtava? Suomalaisia kiinnekohtia: oikeustoimilain (228/1929) 36 §:n kohtuullistaminen, pakottava kuluttajansuoja, työoikeuden pakottavuus, kilpailukieltojen rajat, sopimussakon kohtuullisuus. Tarkista relevantit säännökset oikeustutkimus-skillillä.
  • Loogiset ja ehdolliset virheet:
    • "Jos X niin Y" -rakenteet, joissa ehto on poistettu tai mahdoton.
    • "Molemminpuolinen" velvoite, joka ei tosiasiassa ole symmetrinen.
    • Poikkeus, joka nielee pääsäännön ("paitsi kohdan X sallimissa tapauksissa", kun X sallii kaiken).
  • Sisällölliset epäjohdonmukaisuudet: vaihteleva huolellisuusstandardi, eri kynnysarvot tai määräajat samankaltaisissa tilanteissa, oikeus joka annetaan ja sitten kumotaan toisaalla.
  • Tasapaino ja yksipuolisuus: irtisanomis- ja exit-oikeuksien symmetria, kohtuuttomat sopimussakot, yksipuolinen muutosoikeus. Erityishuomio heikomman osapuolen suojaan (kuluttaja, työntekijä, pienyritys vakioehdoissa).

Suositus asteikolla: Etene varauksin / Asiantuntijan tarkistus suositeltava / Asiantuntijan tarkistus pakollinen / Ei käytettäväksi ilman merkittävää korjausta.

Pysäytysehto: kriittisiä riskisignaaleja → ohjaa asiantuntijalle ennen jatkamista.


Vaihe 8 — Valmius käyttöön

  • Tarkoituksenmukaisuus: täyttääkö asiakirja tehtävänsä? Onko jäljellä [TÄYDENNÄ]-kohtia tai paikkamerkkejä?
  • Ammattimaisuus ja muoto: onko muotoilu yhtenäistä? Onko kirjoitusvirheitä?
  • Allekirjoitus- ja jättövalmius: ovatko allekirjoituslohkot, osapuolet ja päivämäärät kunnossa? Täyttääkö asiakirja viranomaisen tai tuomioistuimen muotovaatimukset (esim. valituksen sisältö ja liitteet)?
  • Sävy ja etiikka: onko sävy asiallinen? Onko mitään harhaanjohtavaa?
  • Aiempien vaiheiden kriittiset löydökset: onko ne ratkaistu?

Lopullinen suositus: Valmis käyttöön / Valmis ehdolla [X] / Ei valmis — kriittisiä ongelmia jäljellä.


Loppuraportti

Tuota lopuksi tiivis yhteenveto:

========================================
JURIDISEN ASIAKIRJAN TARKISTUSRAPORTTI
========================================
Asiakirja: [nimi/tyyppi]
Päivämäärä: [pvm]
Tarkistaja: Claude (tekoälyavusteinen) — tarkistettava ihmisen toimesta

LÖYDÖSTEN YHTEENVETO
| Tunnus | Vakavuus | Vaihe | Sijainti | Ongelma |
|---|---|---|---|---|

Pikatilasto: Kriittisiä [X] · Merkittäviä [Y] · Vähäisiä [Z]

KOKONAISARVIO: [Valmis / Valmis varauksin / Ei valmis / Vaatii merkittävän korjauksen]

KRIITTISET LÖYDÖKSET: [lista tunnuksineen]

ASIANTUNTIJAN TARKISTUSTA VAATIVAT KOHDAT:
- [lakiviittausten varmistus oik.ai/Finlex]
- [pätevyys- ja kohtuullisuuskysymykset]
- [tulkinnanvaraiset oikeudelliset kannat]

SEURAAVAT TOIMET: [priorisoitu lista]

VASTUUVAPAUS: Tarkistuksen teki tekoäly ja se täydentää, ei korvaa, ihmisen
oikeudellista harkintaa. Käyttäjä vastaa lopputuloksesta.
========================================

Mitä tämä skill EI tee

  • Ei korvaa pätevän ihmisen lopullista tarkistusta eikä kanna vastuuta asiakirjan käyttöönotosta. Skill nostaa esiin löydökset; riskin hyväksymisen ja hyväksynnän tekee aina ihminen.
  • Ei vahvista lakiviittauksia, ratkaisutunnuksia eikä HE-numeroita muistista. Tason 2 löydökset tarkistetaan oikeustutkimus-skillillä lähteestä; muuten ne merkitään [ei voitu tarkistaa lähteestä].
  • Ei tee lopullisia oikeudellisia johtopäätöksiä. Vaiheen 7 havainnot ovat riskisignaaleja, jotka vaativat asiantuntijan arvion — eivät päätöksiä pätevyydestä tai täytäntöönpanokelpoisuudesta.
  • Ei laadi eikä korjaa asiakirjaa puolestasi. Se tunnistaa virheet, aukot ja riskit ja ehdottaa korjauksia; varsinaisen laatimisen tekee aihekohtainen skill ja ihminen.
  • Ei takaa, että kaikki riskit löytyvät. Perusteellisuudesta huolimatta tarkistus on apuväline, ei kattavuustakuu; tärkeimmät kohdat vaativat asiantuntijan silmän.
  • Ei kata muiden maiden oikeutta. Vain Suomen oikeus (ja relevantti EU-oikeus erikseen huomioituna); Ahvenanmaan erityisasema ja muut jurisdiktiot on todettava erikseen.

Jatka tästä

  • Löydös koskee lakiviittausta, oikeuskäytäntöä tai säännöksen voimassaoloa → /juristi:oikeustutkimus
  • Vaiheen 3 kielelliset löydökset pitää korjata ja teksti viimeistellä → /juristi:suomen-kieli tai /juristi:juristi
  • Tarkistettava asiakirja on sopimus, jonka ehdot kaipaavat syvempää läpikäyntiä → /sopimukset:sopimuksen-tarkistus
  • Asiakirja on haastehakemus, valitus tai muu prosessiasiakirja → /riidanratkaisu:haastehakemus tai /hallinto-oikeus:muutoksenhaku
  • Asiakirja liittyy työsuhteen päättämiseen tai tietosuojaan → /tyooikeus:tyosuhteen-paattaminen tai /tietosuoja:tietosuojaseloste

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Asiakirjan Tarkistus AI skill do?

Juridisen asiakirjan järjestelmällinen monivaiheinen laaduntarkistus suomalaisessa kontekstissa. Käytä tätä skilliä, kun juridinen asiakirja pitää tarkistaa ennen käyttöä: sopimus, lausunto, valitus, hallintopäätös, muistio, sopimusluonnos, ohjesääntö tai muu oikeudellinen asiakirja. Triggeröi kun käyttäjä pyytää tarkistamaan, oikolukemaan tai laadunvarmistamaan juridisen tekstin, etsimään riskejä tai aukkoja, tai varmistamaan asiakirjan ennen allekirjoitusta, lähettämistä tai jättämistä viranomaiselle tai tuomioistuimeen.

Why use Asiakirjan Tarkistus on TypingMind?

Because you install it once and use it with any model. Asiakirjan Tarkistus is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Asiakirjan Tarkistus in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/akunikkola/claude-for-legal-finland/tree/main/juristi/skills/asiakirjan-tarkistus. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Asiakirjan Tarkistus?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Asiakirjan Tarkistus?

As many as you like. As long as a model supports skills, you can use Asiakirjan Tarkistus with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Asiakirjan Tarkistus AI skill free?

Yes. It is published on GitHub by akunikkola under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇