
Claude Skills -opas: Rakenna ensimmäinen SKILL.md kymmenessä minuutissa (2026)
Skills on todennäköisesti tärkein Claude Code -ominaisuus, jota et vielä käytä. Claude skill on kansio, jossa on SKILL.md-tiedosto ja jonka Claude lataa automaattisesti heti, kun kehote vastaa sen kuvausta — ei enää kehotteiden kopiointia ja liittämistä, ei turvonnutta CLAUDE.md-tiedostoa eikä miettimistä, minkä mallineen valitsisi. Olemme julkaisseet 4 skilliä tämän repon .claude/skills/agent/-kansiossa, ja Skills 2.0:n sekä Anthropic Marketplacen saapuessa vuoden 2026 alussa formaatti vihdoin lunastaa potentiaalinsa. Tässä toimiva malli sudenkuoppien jälkeen.
Keskeiset opit
- Claude skill on kansio, joka sisältää
SKILL.md-tiedoston YAML-etumäärittelyllä, ja Claude lataa sen automaattisesti tarvittaessa.- Skillit sijaitsevat kansiossa
~/.claude/skills/(henkilökohtainen) tai.claude/skills/(projekti); Claude tarkistaa molemmat käynnistyksen yhteydessä.- Käytä Skillejä toistuviin työnkulkuihin, MCP:tä reaaliaikaiseen ulkoiseen dataan, aliagentteja monivaiheiseen suunnitteluun ja hookkeja deterministisiin tapahtumiin.
- Nopein tapa päästä ensimmäiseen skilliin on pyytää Claudea käynnistämään oma
skill-creator-skillinsä — se kirjoittaa SKILL.md:n puolestasi.
Mitä ovat Claude Skillsit?
Claude-skilli on kansio, joka sisältää SKILL.md-tiedoston YAML-otsakkeella (name, description, valinnainen allowed-tools) ja jonka Claude Code lataa automaattisesti kontekstiin, kun kehotteesi vastaa kuvausta. Skillit paketoivat uudelleenkäytettäviä työnkulkuja, kuten /commit tai /explain-code, turvottamatta järjestelmäkehotettasi.
Anthropicin virallisen dokumentaation mukaan jokaisessa skill-kansiossa on kolme asiaa: pakollinen SKILL.md, valinnaiset mukaan pakatut skriptit (mikä tahansa Python-apurista JSON-asetukseen) ja valinnaiset viitedokumentit, jotka latautuvat rungon rinnalla. Siinä kaikki. Ei rakennusvaihetta, ei asennusta, ei manifestia.
Nerokas osa on progressiivinen paljastaminen. Käynnistyksessä Claude skannaa vain jokaisen skillin description-kentän. Runko – ohjeet, esimerkit, työkalukutsukuviot – pysyy levyllä, kunnes kehotteesi todella vastaa sitä. Voit siis pitää 50 skilliä asennettuna etkä maksa token-kustannuksia lainkaan, ennen kuin jokin niistä aktivoituu.
Ajattele skillejä kuin keittokirjan reseptejä, jotka Claude avaa nähdessään ainekset kehotteessasi. Skilli on kansio, jonka Claude lukee tarpeen mukaan, ei kehotetta, jonka muistat liittää. Siinä koko idea.
Minimaalinen SKILL.md näyttää tältä:
---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---
Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.Kymmenen riviä. Oikea skilli. Valmis aktivoitumaan.
Pika-aloitus: Rakenna ensimmäinen taitosi 10 minuutissa
Rakenna ensimmäinen Claude-taitosi 10 minuutissa: (1) luo hakemisto ~/.claude/skills/explain-code/, (2) lisää SKILL.md-tiedosto, jossa on name, description ja työnkulun runko, (3) käynnistä Claude Code uudelleen, jotta se skannaa uuden hakemiston, (4) aktivoi se kehotteella, joka vastaa kuvausta.
Tässä on koko kulku.
Vaihe 1: Luo hakemisto
mkdir -p ~/.claude/skills/explain-codeHenkilökohtaiset taidot (vain sinulle) sijoitetaan hakemistoon ~/.claude/skills/. Projektitaidot (tiimin kanssa gitin kautta jaettavat) sijoitetaan .claude/skills/-hakemistoon repositoriosi juureen. Valitse henkilökohtainen päivittäiseen käyttöön tarkoitetuille työnkuluille; valitse projekti, kun haluat jokaisen repositorion osallistujan perivän sen.
Vaihe 2: Kirjoita SKILL.md
Sijoita tämä tiedosto sijaintiin ~/.claude/skills/explain-code/SKILL.md:
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---
You are explaining code to a developer who is new to this codebase.
1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.Siinä on koko skill. Frontmatter on sopimus; body on pelikirja.
Vaihe 3: Käynnistä Claude Code uudelleen
Live-havaitseminen on Skills 2.0 -ominaisuus, ja vanhemmat Claude Code -versiot tarvitsevat uudelleenkäynnistyksen havaitakseen uuden hakemiston. Jos et ole varma, mitä versiota käytät, yksi uudelleenkäynnistys ei maksa mitään.
Vaihe 4: Käynnistä se
Avaa projekti ja kirjoita kehote:
walk me through what auth/middleware.ts doesClaude vertaa kehotettasi description-kenttään, löytää explain-code-skillin ja lataa SKILL.md-tiedoston sisällön hiljaisesti kontekstiin. Näet "Using skill: explain-code" -viestin työkalulokissa. Valmis.
Pro-vinkki: Etkö jaksa kirjoittaa tiedostoa itse? Avaa Claude Code ja sano
Use the skill-creator skill to scaffold an explain-code skill for me.Anthropicin mukana tulevaskill-creatoron metaskilli, joka haastattelee sinua, valitsee järkevätallowed-tools-asetukset ja kirjoittaa SKILL.md-tiedoston oikeaan kansioon. Nopein reitti ensimmäiseen skilliisi, piste.
Siinä kymmenen minuutin lupaus: viisi minuuttia kirjoittamista, yksi uudelleenkäynnistys, yksi testikehote.

SKILL.md:n sisällä: frontmatter-viite
SKILL.md-frontmatter on YAML-muotoa, joka kääritään ----erotinmerkkeihin. Kaksi kenttää on pakollisia: name (enintään 64 merkkiä, käytetään slash-komennon nimenä) ja description (laukaisuteksti, jota Claude vertaa kehotteeseesi). Valinnaiset kentät ohjaavat työkalujen käyttöoikeuksia, mallin kutsumista, tiedostojen globeja ja suorituskontekstia.
Tässä on täydellinen viite, joka on peräisin Anthropicin skills-dokumentaatiosta:
| Kenttä | Pakollinen? | Tyyppi | Käyttötilanne |
|---|---|---|---|
name | kyllä | merkkijono, enintään 64 merkkiä | aina, tästä tulee slash-komennon nimi |
description | kyllä | merkkijono, enintään 1024 merkkiä | aina, Claude skannaa tämän päätelläkseen, vastaako skill kehotetta |
allowed-tools | ei | työkalukuvioiden taulukko | kun skill lukitaan tiettyihin työkaluihin (esim. Bash(git *), Read, Grep) |
disable-model-invocation | ei | totuusarvo | kun skillistä tehdään vain käyttäjän kutsuma (slash-komento, ei koskaan automaattisesti laukaistu) |
user-invocable | ei | totuusarvo | kun merkitään skill, jonka pitäisi näkyä /skill-name-muodossa slash-komentovalikossa |
argument-hint | ei | merkkijono | kun käyttäjälle annetaan vihje siitä, mitä $ARGUMENTS-muuttujan tulisi sisältää |
model | ei | merkkijono | kun skill sidotaan tiettyyn malliin (esim. claude-opus-4-7) |
context | ei | default tai fork | (Skills 2.0) kun skill suoritetaan haarautetussa konteksti-ikkunassa, jotta se ei saastuta pääsäiettä |
globs | ei | glob-kuvioiden taulukko | kun skilliä ehdotetaan automaattisesti, kun glob-kuvioita vastaavat tiedostot ovat näkyvissä |
references | ei | tiedostopolkujen taulukko | kun skillin rungon mukana ladattavat viitedokumentit niputetaan |
bundled-files | ei | tiedostopolkujen taulukko | kun skillin suorittamat skriptit niputetaan |
tags | ei | merkkijonojen taulukko | kun skillejä järjestetään marketplace-listauksissa |
Rivi context: fork ansaitsee erityishuomion. Se on Skills 2.0 -primitiivi, joka suorittaa skillin eristetyssä konteksti-ikkunassa, mikä on hyödyllistä pitkäkestoisille tutkimus-skilleille tai mille tahansa, joka tuottaa paljon välillisiä tokeneita, joita et halua pääsäikeeseen. Jos tämä idea on sinulle uusi, konteksti-insinöörin oppaamme käsittelee kompromisseja.
Maksimalistinen SKILL.md-frontmatter, jokainen kenttä täytettynä:
---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---Ammattilaisvinkki: Suurin virhe
description-kentässä: sen kirjoittaminen ihmisille. Kirjoita se Claudelle — konkreettisia laukaisulauseita, ei markkinointipuhetta. Huono: "Tehokas Git-automaatiotaito." Hyvä: "Käytä, kun käyttäjä haluaa commitoida muutoksia, kirjoittaa commit-viestin tai avata PR:n."
Kaksi oikeaa taitoa, alusta loppuun
Kaksi taitomallia kattaa 80 % todellisesta käytöstä: (1) käyttäjän käynnistämä /commit-taito, jossa on disable-model-invocation: true ja allowed-tools: Bash(git *) deterministisiä toimintoja varten; (2) automaattisesti käynnistyvä /explain-code-taito, jossa on oletusarvoinen frontmatter ja jonka Claude käynnistää, kun kehotteet vastaavat sen kuvausta.
Useimmat oppaat näyttävät vain katkelmia. Tässä on kaksi kokonaista tiedostoa, jotka voit kopioida hakemistoon ~/.claude/skills/ jo tänään.
/commit-taito (käyttäjän käynnistettävissä)
---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
- "Bash(git status:*)"
- "Bash(git diff:*)"
- "Bash(git add:*)"
- "Bash(git commit:*)"
---
1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.Testikehote: /commit
Näin tapahtuu: Claude tutkii git-tilan, luonnostelee viestin, pyytää sinua vahvistamaan ja suorittaa vasta sen jälkeen git commit -komennon. disable-model-invocation: true tarkoittaa, ettei se koskaan käynnisty automaattisesti epämääräisestä "tallenna muutokseni" -kehotteesta, vaan se toimii vain, kun kirjoitat /commit. allowed-tools-sallittujen lista lukitsee sen git-alikomentoihin; se ei fyysisesti pysty suorittamaan rm -rf-komentoa tai pushaamaan etäpalvelimelle. Tämä on yksi niistä, jotka toimitamme tuotantokäytössä omassa putkessamme.
Deterministisiä commitin jälkeisiä toimintoja varten (lint-ajot, tyyppien uudelleengenerointi, Slack-webhookin pingaus) kannattaa sen sijaan turvautua Claude Code -koukkuihin, sillä taidot ovat probabilistisia, kun taas koukut laukeavat joka kerta.
/explain-code-taito (mallin kutsuma)
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---
1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.Testikehote: walk me through what auth/middleware.ts does
Mitä tapahtuu: huomaa, ettei käyttäjä kirjoittanut /explain-code. Claude sovittaa ilmauksen "walk me through" description-kenttään, löytää taidon ja kutsuu sen automaattisesti. Siinä taika — description hoitaa reitityksen. model: claude-opus-4-7 -kenttä lukitsee tämän taidon Opukseen riippumatta siitä, minkä mallin olet asettanut oletukseksesi, joten syvälliset koodiläpikäynnit saavat aina älykkäämmän mallin. (Lisää Claude Coden käyttämisestä eri malleilla.)
Miksi kaksi mallia? Taito #1 on käyttäjän kutsuma + lukittu tiettyihin työkaluihin, ennustettava, turvallinen, täydellinen gitiin tai julkaisuihin. Taito #2 kutsutaan automaattisesti + on avoin, taitojen taika, mutta luota
description-kenttääsi. Käyttäjän kutsumat taidot antavat ennustettavuutta; mallin kutsumat taidot antavat taikaa. Valitse taitokohtaisesti, ei repokohtaisesti.
Lisää oikeita esimerkkitaitoja löydät virallisesta anthropics/skills-reposta ja yhteisön ylläpitämästä awesome-claude-skills-listasta.
Skills vs MCP vs Subagents vs Hooks: milloin mitäkin käyttää
Käytä Skills-ominaisuutta uudelleenkäytettäviin työnkulkuihin, jotka Claude käynnistää automaattisesti tai jotka kutsut slash-komentoina. Käytä MCP-palvelimia, kun tarvitset reaaliaikaista ulkoista dataa (tietokannat, API:t, työskentelyhakemiston ulkopuoliset tiedostojärjestelmät). Käytä subagenteja monivaiheisiin suunnitelmiin, jotka Claude delegoi uuteen kontekstiin. Käytä hookeja deterministisiin tapahtumiin (pre-commit, post-tool-use), joiden on aina laukeuduttava – ei koskaan todennäköisyyden perusteella.
Pikaerottelu: skillit ovat työnkulkuja, Model Context Protocol on dataa, subagentit ovat suunnitelmia, hookit ovat tapahtumia. Jokainen toimii eri kerroksessa Claude Codea, ja väärä kerros tarkoittaa väärää työkalua. Anthropicin oman Skills explained -artikkelin mukaan tämä on juuri se ajattelutapa, jonka he haluavat sinun sisäistävän.
| Kysymys | Skills | MCP | Subagents | Hooks |
|---|---|---|---|---|
| Laukaisee | promptin osuma tai /slashcmd | malli päättää kutsua työkalua | malli delegoi tehtävän | Claude Code -tapahtuma (pre-tool-use, post-edit) |
| Sijainti | .claude/skills/ | ulkoinen palvelin (stdio tai SSE) | .claude/agents/ | settings.json-tiedoston hooks-lohko |
| Paras käyttö | uudelleenkäytettävät työnkulut, loogiset prompt-pohjat | reaaliaikainen data, kolmannen osapuolen API:t, tiedostojärjestelmäpääsy cwd:n ulkopuolelle | monivaiheinen suunnittelu, rinnakkaistyö, eristetyt kontekstit | deterministiset tapahtumat, joiden on aina laukeuduttava |
| Deterministisyys | probabilistinen (Claude valitsee) | probabilistinen (Claude valitsee) | probabilistinen (Claude valitsee) | deterministinen (laukeaa aina) |
| Token-kustannus | matala (vain description latautuu skannauksessa) | keskitaso–korkea (työkalumääritykset + vastaukset) | korkea (uusi konteksti jokaista delegointia kohden) | ei lainkaan (out-of-band shell-suoritus) |
| Milloin EI kannata käyttää | reaaliaikainen data, deterministiset tapahtumat | staattiset työnkulut, prompt-logiikka | yksittäiset deterministiset toiminnot | haarautuva logiikka, mikä tahansa probabilistinen |
Ne yhdistyvät. Skill voi kutsua MCP-työkalua allowed-tools-asetuksen kautta. Hook voi laukeutua skillin valmistuttua. Subagentti voi käyttää skillejä, joihin sille on annettu pääsy. Selkein ajatusmalli: valitse ensin oikea kerros ja anna niiden sitten pinoutua. Skills on kontekstisuunnittelun primitiivi, johon tartut, kun haluat työnkulun, jonka Claude voi valita; automatisoit hookeilla, kun haluat jotain, mitä Claude ei voi ohittaa.
Pahimmat tavat käyttää kutakin väärin: Skills reaaliaikaiselle datalle (käytä MCP:tä); MCP yksittäisille prompt-malleille (käytä Skillsiä); subagentit deterministisille tiedostomuokkauksille (käytä hookeja); hookit haarautuvalle logiikalle (käytä Skillsiä). Skills ovat työnkulkuja, MCP on dataa, subagentit ovat suunnitelmia, hookit ovat tapahtumia. Valitse kerroksen perusteella, älä muotisanojen.
Missä skillit sijaitsevat: henkilökohtainen, projekti, lisäosa ja yritys
Claude-skillit asennetaan neljään laajuuteen: henkilökohtainen (~/.claude/skills/, vain sinä), projekti (.claude/skills/ repon juuressa, tiimisi gitin kautta), lisäosa (jaetaan Anthropic Marketplacen tai minkä tahansa lisäosa-URL:n kautta) ja yritys (IT:n työntämä MDM-/hallintakäytännön kautta). Claude skannaa kaikki neljä käynnistyksen yhteydessä.
| Laajuus | Polku | Jakaminen | Paras käyttötarkoitus |
|---|---|---|---|
| Henkilökohtainen | ~/.claude/skills/ | ei jaeta | omat päivittäiset työnkulut (commit, review, PR:n kirjoitus) |
| Projekti | .claude/skills/ (repon juuri) | git, kaikki repon osallistujat | tiimin käytännöt, koodikantakohtaiset mallit |
| Lisäosa | asennetaan komennolla /plugin install <url> | Anthropic Marketplace tai URL | repojen välinen uudelleenkäyttö, jakelu yhteisölle |
| Yritys | organisaation ylläpitäjän työntämä (hallitut asetukset) | pakotettu koko organisaatiossa | vaatimustenmukaisuuden edellyttämät työnkulut, turvallisuussyistä lukitut työkalut |
| Mukana tuleva (sisäänrakennettu) | toimitetaan Claude Coden mukana | – | dokumentti-skillit (pdf, docx, pptx, xlsx), /debug, /simplify |
Mukana tulevat dokumentti-skillit on helppo unohtaa: Claude Code sisältää valmiiksi pdf-, docx-, pptx- ja xlsx-skillit sekä pienen kirjaston /debug-, /simplify- ja vastaavia sisäänrakennettuja komentoja. (Sisartyökalu Claude Design sisältää omat mukana tulevat työnkulkuskillinsä suunnittelun generointiin; sama malli, eri toimialue.)
Milloin kannattaa julkaista lisäosana projektiskillin sijaan? Lisäosat voittavat, kun sama työnkulku hyödyttää useita repoja: /release-skilli, jota käytät viidessä asiakkaan koodikannassa, kuuluu lisäosaan eikä copy-pasteattuna jokaisen repon .claude/skills/-kansioon. Projektiskillit voittavat koodikantakohtaisissa käytännöissä (tiimisi PR-malli, mukautettu testiajuri). Anthropic Marketplace ja /plugin install mistä tahansa URL:stä tekevät lisäosista oikean ratkaisun repojen väliseen uudelleenkäyttöön. Lisäosadokumentaation mukaan löytäminen ja päivitykset hoidetaan automaattisesti.

Edistyneet kuviot: $ARGUMENTS, dynaaminen shell-injektio, context: fork
Kolme edistynyttä skill-kuviota ovat merkityksellisimpiä: $ARGUMENTS antaa käyttäjien välittää parametreja käyttäjän käynnistämiin skilleihin (/translate $ARGUMENTS); dynaaminen shell-injektio (allowed-tools: Bash(...) -asetuksella) antaa skillin suorittaa skriptejä ja ohjata tulosteet kontekstiin; ja context: fork (Skills 2.0) suorittaa skillin eristetyssä konteksti-ikkunassa. Anthropicin Complete Guide -whitepaper on vakiintunut viite context: fork -toiminnolle toukokuussa 2026.
$ARGUMENTS parametrisoiduille taidoille
---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---
Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.Testikehote: /translate spanish. Claude korvaa spanish-arvon $ARGUMENTS-muuttujalla suoritusaikana. Siistein tapa tehdä taidosta monikäyttöinen kirjoittamatta erillisiä versioita.
Dynaaminen shell-injektio allowed-tools-asetuksen kautta
---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---
Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.Skilli suorittaa shell-komentoja, putkittaa diffin kontekstiin ja tarkistaa sen. Lukitse allowed-tools tiettyihin komentoihin (Bash(git diff HEAD~1:*)), ei koskaan pelkkään Bash-oikeuteen — pelkkä Bash-käyttöoikeus on tämän toimintamallin tietoturva-ansaversio.
context: fork (Skills 2.0)
---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---
Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.Haarauttaminen antaa taidolle oman konteksti-ikkunan, jolloin 50 000 tokenin välitutkimusmuistiinpanot eivät vuoda pääistuntoosi. Hyödyllistä pitkässä tutkimuksessa, suurten refaktorointien suunnittelussa tai missä tahansa, mikä tuottaa paljon poisheitettäviä tokeneita. Vain Skills 2.0:ssa — vanhemmat Claude Code -versiot jättävät kentän huomiotta.
Vianmääritys: Miksi taitosi ei käynnisty
Taidot jäävät yleensä käynnistymättä jostain neljästä syystä: (1) description on liian yleisluontoinen, jotta Claude voisi sovittaa sen kehotteeseesi, (2) hakemisto on väärässä polussa (.claude/skills/ eikä claude/skills/), (3) Claude Codea ei käynnistetty uudelleen taidon lisäämisen jälkeen (vain ennen Skills 2.0:aa), tai (4) taidon nimi on ristiriidassa paketoidun tai korkeamman prioriteetin taidon kanssa. Claude Coden GitHub-ongelmaseurannan googletetuimpien virhetilanteiden mukaan nämä neljä kattavat noin 95 % "miksi tämä ei toimi" -ilmoituksista.
Vikatila 1: "Taitoni ei näy lainkaan"
Yleisin syy on väärä polku — .claude/skills/ (pisteellä) ja claude/skills/ (ilman pistettä) on kirjoitusvirhe, jonka olemme kaikki tehneet yöllä kello yhdeltä. Suorita ls -la ~/.claude/skills/ varmistaaksesi, että hakemisto on olemassa pisteellä. Jos hakemisto on olemassa eikä Claude silti näe sitä, käynnistä Claude Code kerran uudelleen. Skills 2.0:tä edeltävät versiot lukevat taidot vain käynnistyksen yhteydessä.
Virhetila 2: ”Claude ei kutsu skilliäni automaattisesti”
description-kenttä on liian epämääräinen tai kirjoitettu ihmisille eikä Claudelle. Kirjoita se uudelleen konkreettisilla laukaisulauseilla, jotka vastaavat sitä, miten käyttäjät todella muotoilevat pyyntönsä. Kun olin rakentanut tähän repoon 4 skilliä, ansa johon lankesin oli kuvauksien jättäminen muotoon ”Hyödyllinen SEO-skill.” Hyödytöntä. Kirjoita mieluummin: ”Käytä, kun käyttäjä haluaa lisätä JSON-LD-skeeman, meta-tunnisteita tai SEO-frontmatteria Markdown-artikkeliin.” Laukaisutarkkuus nousi noin 30 prosentista noin 95 prosenttiin. Laukaisutarkkuus elää tai kuolee description-kentän varassa. Kirjoita se Claudelle, älä ansioluetteloasi varten.
Vikatila 3: "Kuvaus katkesi slash-komentovalikossa"
Joko description on yli 1024 merkkiä pitkä tai name on yli 64 merkkiä pitkä. Molemmilla on ehdottomat rajat. Korjaus: jaa taito kahdeksi kapeammaksi taidoksi tai siirrä pitkät yksityiskohdat SKILL.md-tiedoston runko-osaan. Frontmatter on reititystä varten, ei dokumentaatiota.
Vikatila 4: "Reaaliaikainen muutostunnistus ei toimi"
Skills 2.0:aa edeltävä Claude Code vaatii täydellisen uudelleenkäynnistyksen jokaisen SKILL.md-muokkauksen jälkeen. Jos kehität skilliä iteratiivisesti eivätkä muutoksesi tule voimaan, käytät todennäköisesti vanhempaa versiota. Joko päivitä Claude Code -versioon, joka sisältää Skills 2.0:n (reaaliaikainen tunnistus), tai totu uudelleenkäynnistämään jokaisen tallennuksen jälkeen. Ärsyttävää, mutta halpaa.
Taidot Clauden tuolla puolen: Avoin Agent Skills -standardi
Kyllä, taidot ovat avoin standardi. Agent Skills -standardi osoitteessa agentskills.io määrittelee SKILL.md-muodon toimittajasta riippumatta. OpenAI:n Codex CLI ja ChatGPT Desktop ottivat standardin käyttöön joulukuussa 2025; sama SKILL.md, jonka kirjoitat Claude Codea varten, toimii Codexissa pienin frontmatter-säädöin.
Tässä työkalujen välinen tukimatriisi toukokuussa 2026: Claude Code tukee Agent Skillsiä täysimääräisesti (referenssitoteutus). OpenAI:n Codex CLI tukee täysimääräisesti. ChatGPT Desktop tukee osittain: name, description ja runko toimivat, mutta allowed-tools-vastaavuutta ei vielä ole. Gemini CLI ilmoitti tuesta vuoden 2026 alussa, mutta ei ollut julkaissut sitä tätä kirjoitettaessa. Cursor on poikkeus — se käyttää omaa Cursor-sääntöjen muotoa eikä lue SKILL.md-tiedostoja natiivisti, joskin yhteisön sovittimia on olemassa.
Mitä kirjoittaa jo tänään, jotta taitosi säilyvät vuoden yli: pidä name ja description selkeinä ja työkalusta riippumattomina. Eristä mahdolliset toimittajakohtaiset frontmatter-määreet nimiavaruuden (claude: tai codex:) alle, jos käytät useampaa työkalua. Siirrettävä pinta — name, description, runko ja $ARGUMENTS — toimii kaikkialla; edistyneet kentät, kuten context: fork, ovat Claude-kohtaisia, kunnes muut toimittajat julkaisevat vastaavat. Anthropic ajaa myös syvempää marketplace-integraatiota vuodetun Claude Code -tiekartan mukaan, joten siirrettävyys helpottuu entisestään.
Kolme paikkaa, joista etsiä esimerkkitaitoja: anthropics/skills (virallinen), awesome-claude-skills (yhteisö) ja agentskills.io (standardin määrityssivu). Taidot eivät ole enää Clauden ominaisuus. Ne ovat avoin standardi, jonka Claude julkaisi ensimmäisenä.
UKK
Mitä eroa on Claude-taidolla ja MCP-palvelimella?
Claude-taito on SKILL.md-tiedosto, joka sisältää työnkulun ohjeet ja jonka Claude lataa, kun kehote vastaa sen kuvausta. MCP-palvelin on erillinen prosessi, jota Claude kutsuu hakeakseen reaaliaikaista dataa (tietokannat, rajapinnat, työskentelyhakemiston ulkopuoliset tiedostojärjestelmät). Käytä taitoja työskulkuihin ja MCP:tä dataan. Ne toimivat yhdessä: taidot voivat kutsua MCP-työkaluja.
Ovatko Claude-taidot ilmaisia?
Kyllä, Skills on Claude Coden sisäänrakennettu ominaisuus ilman lisämaksua. Maksat vain mallin tokeneista, joita kuluu taidon suorituksen aikana. Anthropic Marketplacesta asentamasi taidot voivat olla maksullisia (tällä hetkellä harvinaista), mutta virallinen anthropics/skills-repo ja yhteisön awesome-listat ovat kaikki ilmaisia kopioida ja käyttää.
Mihin Claude-taidot asennetaan?
Henkilökohtaiset taidot tallennetaan kansioon ~/.claude/skills/{skill-name}/ ja projektikohtaiset taidot repositoriosi juuressa olevaan kansioon .claude/skills/{skill-name}/. Lisäosataidot asennetaan komennolla /plugin install <url>, ja ne sijaitsevat lisäosahakemistossasi. Yritystaidot organisaatiosi IT-osasto jakaa hallittujen asetusten kautta. Claude Code skannaa kaikki neljä aluetta käynnistyksen yhteydessä.
Miten luon Claude-taidon alusta alkaen?
Luo kansio hakemiston ~/.claude/skills/ alle, lisää SKILL.md-tiedosto, jossa on YAML-otsaketiedot (name, description) ja niiden jälkeen työnkulun ohjeet, ja käynnistä Claude Code uudelleen. Nopein tapa: avaa Claude Code ja pyydä sitä käynnistämään mukana tuleva skill-creator-taito, niin se luo SKILL.md-rungon puolestasi alle minuutissa.
Miksi Claude-taitoni ei käynnisty?
Neljä yleisintä syytä: (1) description on liian epämääräinen, jotta Claude voisi sovittaa sen kehotteeseesi — kirjoita se uudelleen konkreettisilla käynnistysilmauksilla; (2) taito on väärässä polussa (.claude/skills/ eikä claude/skills/); (3) Claude Code on käynnistettävä uudelleen Skills 2.0:aa edeltävissä versioissa; (4) taidon nimi on ristiriidassa sisäänrakennetun taidon kanssa. Tarkista komennolla ls -la ~/.claude/skills/.
Voivatko ChatGPT tai Cursor käyttää Claude-taitoja?
ChatGPT Desktop ja Codex CLI tukevat samaa Agent Skills -standardia kuin Claude, ja sama SKILL.md toimii molemmissa pienillä frontmatter-muutoksilla. Cursor käyttää omaa Cursor rules -formaattiaan eikä lue SKILL.md-tiedostoja natiivisti. Gemini CLI ilmoitti tuesta vuoden 2026 alussa, mutta sitä ei ollut vielä julkaistu toukokuussa 2026.
Mikä on skill-creator-taito?
skill-creator on anthropics/skills-repositorioon sisältyvä meta-taito, joka auttaa Claudea kirjoittamaan uusia SKILL.md-tiedostoja puolestasi. Kerro Claudelle, mitä haluat taidon tekevän, niin skill-creator haastattelee sinua kuvauksen laatimiseksi, valitsee järkevät allowed-tools ja kirjoittaa SKILL.md-tiedoston oikeaan kansioon. Nopein mahdollinen pohja.
Mitä disable-model-invocation tekee?
Kun asetat disable-model-invocation: true skillin frontmatteriin, Claude ei käynnistä skilliä automaattisesti promptin vastaavuuden perusteella. Skillistä tulee vain käyttäjän käynnistettävissä oleva: se näkyy slash-komentovalikossa muodossa /skill-name ja toimii vain, kun se kutsutaan eksplisiittisesti. Käytä sitä tuhoaville tai deterministisille toiminnoille, kuten /commit tai /deploy.
Rakenna muutama skilli, julkaise ne projektissa ja katso, mikä toimii. Jos tiimisi törmää useissa repoissa "skilli ei käynnisty" -ongelmiin ja haluat toisen parin silmiä katsomaan .claude/skills/-asetustasi, ota yhteyttä — käyn sen mielelläni läpi.