Claude Code -taidot vuonna 2026: näin rakennat itsellesi taitokirjaston

Ailoot-dokumentaatio: API, avaimet ja käyttöönotto.

Mikä Claude Code -taito on, ja miksi se ei ole vain ”suurempi kehote”?#

Claude Code -taidot ovat Claude Coden natiivi ominaisuus, jonka Anthropic julkaisi lokakuussa 2025 Pro/Max/Team/Enterprise-käyttäjille. Myöhemmin se avasi Agent Skills-määrityksen standardiksi, joka toimii myös Claudea laajemmin. Koodissa kyse on vain kansiosta:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Jokainen kansio on yksi taito. SKILL.md on Markdown-tiedosto, jonka alussa on YAML-etumääre ja sen jälkeen tavalliset ohjeet. Kun käyttäjä pyytää ”otetaan tuotantoon”, Claude näkee deploy-to-prod-taidon kuvauksen, tunnistaa ”otetaan tuotantoon” -käynnistysilmukkeen, lataa SKILL.md-tiedoston sisällön kontekstiin ja noudattaa vaiheita.

Progressiivisen lataamisen kolme tasoa

Anthropic rakensi taidot progressiivisesti ladattaviksi: tietoa ladataan kerroksittain tarpeen mukaan. Anthropic Engineering -blogissa tiimi kuvaa tätä ”Agent Skillsin joustavaksi ja skaalautuvaksi tekevänä keskeisenä suunnitteluperiaatteena” (Anthropic Engineering).

Kolme lataustasoa:

1. Metatiedot (aina) – istunnon alussa Claude näkee vain kunkin taidon name- ja description-kentät. Budjetti: noin 100 tokenia taitoa kohti.
2. Ohjeet (käynnistettäessä) – kun käyttäjä sanoo jotain olennaista, Claude lataa SKILL.md-tiedoston sisällön. Budjetti: alle 5000 tokenia.
3. Resurssit (pyydettäessä) – mukaan liitetyt tiedostot (esimerkit, mallit, aineistot) haetaan vasta, kun malli itse etsii niitä. Budjetti: rajaton.

Aiemmin CLAUDE.md-tiedostoon piti tallentaa kaikki, mitä tekoälyn pitäisi ”muistaa”, ja projekti, jossa oli 50 sääntöä, törmäsi nopeasti kontekstirajaan. Taitojen avulla yhdessä projektissa voi helposti olla kymmeniä taitoja, koska aloituskontekstiin tulee vain niiden kuvaukset.

Missä taidot sijaitsevat: neljä tasoa

Prioriteettijärjestys: enterprise ohittaa henkilökohtaisen, henkilökohtainen projektitason. Lisäosat käyttävät plugin-name:skill-name-nimiavaruutta eivätkä aiheuta ristiriitoja. Tämä on kätevää: sijoita yleiset ammatilliset taidot polkuun ~/.claude/skills/ ja projektikohtaiset taidot repositorion .claude/skills/-kansioon.

Mitä SKILL.md sisältää?#

Tässä on minimaalinen esimerkki – kaksikymmentä riviä, ja taito on valmis:

---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form video platforms. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---

# Weekly Content Plan

## Steps

1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan

Siinä kaikki. Jos käyttäjä kirjoittaa ”suunnitellaan viikon julkaisut”, Claude näkee kuvauksessa käynnistysilmukkeen, lataa SKILL.md:n, lukee nimetyt tiedostot ja tulostaa taulukon.

Huomioitavia rajoja

Virallisessa Claude API -dokumentaatiossa asetetaan tiukat rajat:

• name: enintään 64 merkkiä; vain pieniä kirjaimia, numeroita ja yhdysmerkkejä, eikä XML-tageja. anthropic ja claude ovat varattuja.
• description: API:ssa enintään 1024 merkkiä; pakollinen, eikä XML-tageja sallita.
• Listauksen budjetti: Claude Codessa kaikkien taitojen kuvaukset vievät yhdessä noin 1 % konteksti-ikkunasta. Jos taitoja on paljon, kuvauksia typistetään, jolloin Clauden tarvitsemat täsmäysavainsanat voivat kadota.
• SKILL.md-runko: Anthropic suosittelee pitämään rungon enintään 500 rivissä. Siirrä tätä pidemmät osat tiedostoihin references/, scripts/ ja examples/ ja lataa ne ohjeiden kautta.

Kontekstin tiivistämisen (/compact) jälkeen Claude säilyttää 5000 ensimmäistä tokenia kustakin aiemmin käyttöön otetusta taidosta; kaikkien uudelleen liitettyjen taitojen kokonaisbudjetti on 25 000 tokenia. Jos taito ei mahdu mukaan, sen toiminta ”unohtuu”.

Täysi etumäärityksen skeema

Käytä vähintään kenttiä name ja description. Tuotantotaidoissa käytetään myös muita kenttiä:

Kenttä disable-model-invocation: true on välttämätön kaikelle, minkä ei pidä käynnistyä automaattisesti. Esimerkiksi tätä lippua käyttävän deploy-to-prod-taidon voi ottaa käyttöön vain, jos käyttäjä kirjoittaa nimenomaisesti /deploy-to-prod. Ilman lippua Claude saattaisi ottaa tuotannon käyttöön, koska ”koodi näyttää valmiilta”.

Miksi kuvaus vastaa 90 prosentista työstä, ja miten sellainen kirjoitetaan?#

Yleisin vibe-koodaajien virhe on kirjoittaa kuvaukseksi ”Apu X:ään”. Taito on fyysisesti olemassa kansiossaan, mutta Claude ei ota sitä käyttöön.

Huono kuvaus

description: Build dashboards.

Claude ei voi päätellä tästä: liittyykö käyttäjän pyyntö ”näytä viikon myynti” koontinäyttöön? Tarkoittaako pyyntö ”liikevaihtokaavio” koontinäyttöä vai vain yleistä kaaviota? Eikö ”kuukausiraportti” varmasti liity koontinäyttöön?

Anthropicin oma skill-creator esittää suosituksen suoraan:

Hyvän kuvauksen kaava

Kolme osaa:

1. Mitä taito tekee – yksi tulosta kuvaava virke, ei kuvaus prosessista. Ei ”generoi SQL:ää”, vaan ”vie myyntitiedot Telegram-kanavan taulukkoon”.
2. Milloin se käynnistetään – 3–5 lainausmerkeissä olevaa ilmausta, joita käyttäjät todella käyttävät. Älä arvaa, vaan katso keskustelu- ja tukihistoriaa.
3. Milloin sitä EI käynnistetä – 1–2 ilmausta samankaltaisista tehtävistä, joihin taito ei saa vastata. Ilman tätä osaa kaksi samankaltaista taitoa ovat jatkuvasti ristiriidassa.

Esimerkki vahvasta kuvauksesta omasta projektistani (yksinkertaistettu ja anonymisoitu):

description: |
  Writes and publishes an SEO guide to the blog, following the editorial policy.
  Triggers: "write a guide about X", "let's make a new pillar",
  "a blog article about Y", "build a blog guide about Z".
  Do not activate if the request is about an email newsletter,
  a Telegram post, or an internal team instruction—
  those are other skills.

Mikä tässä toimii:

• Verbi ”writes and publishes” määrittää konkreettisen tuloksen, toisin kuin ”helps with”.
• Neljä käynnistysilmausta lainausmerkeissä kattaa erilaiset sanamuodot.
• Mukana on myös englanninkielinen käynnistin: jos käyttäjä vaihtaa tiimin kieleen, taito toimii silti.
• Erillinen ”do not activate if” -osio ehkäisee ristiriitoja sähköposti- ja julkaisutaidon kanssa.

Kuvauksen testaaminen

Anthropic rakensi skill-creator-taidon sisään käynnistysarviointimenetelmän: 20 kehotetta, joilla tarkistetaan, käynnistyykö taito. Kymmenen pitäisi käynnistää se ja kymmenen ei (mukaan lukien läheltä liippaavat tilanteet, joissa sanamuoto on samankaltainen mutta tehtävä eri).

Vibe-koodaajan näkökulmasta tämä tarkoittaa seuraavaa: kirjoitettuasi kuvauksen avaa tyhjä keskustelu ja kokeile viittä oikeasti käyttämääsi ilmausta sekä kolmea samankaltaiselta kuulostavaa ilmausta, jotka tarkoittavat jotakin muuta. Jos taito ei käynnisty silloin kun pitäisi tai käynnistyy silloin kun ei pitäisi, muokkaa kuvausta. Kirjoita ohjerunko vasta sen jälkeen.

Mitkä 5 taitoa asentaisin ensin?#

Omien taitojen kirjoittaminen ensimmäiset kaksi viikkoa on häviävä strategia. Aloita asentamalla valmiita taitoja ja katsomalla, miten ne on rakennettu; lisää sitten omasi samalla menetelmällä. Muiden tekemien hyväksi havaittujen kokoelmien mukauttaminen itselle on halvempaa kuin kaiken rakentaminen alusta asti. Tässä on viisi kokoelmaa, joista aloittaisin:

1. anthropics/skills – virallinen kokoelma, jossa on skill-creator

Repositorio: github.com/anthropics/skills. 138 000 GitHub-tähteä. Se sisältää Anthropicin tiimin virallisia taitoja: skill-creator (metataito, joka kirjoittaa muita taitoja), claude-api (auttaa API-integraatioiden rakentamisessa) ja valmiita dokumenttitaitoja PowerPointiin, Exceliin, Wordiin ja PDF:ään.

Asenna Claude Codessa:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Tärkein arvo on skill-creator. Se kirjoittaa kuvauksen perusteella SKILL.md-tiedoston, suorittaa sitten 20 käynnistysarviointia ja muokkaa kuvausta, kunnes taito alkaa käynnistyä oikeissa tilanteissa. Käytännössä se on ”taito taitojen luomiseen”.

2. mattpocock/skills – TypeScript-asiantuntijan viraali kokoelma

Se sisältää 12 aktiivista taitoa, kuten:

Asenna:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills – kokoelma markkinoijille

Jos vedät verkkokursseja, työskentelet freelancer-markkinoijana tai pyörität toimistoa, sinun ei tarvitse käyttää kuutta kuukautta omien taitojesi kirjoittamiseen. Puolet tehtävistä on jo paketoitu.

4. vercel-labs/agent-skills – suunnittelua ilman tekoälyn näköistä jälkeä

Repositorio: github.com/vercel-labs/agent-skills. Sen johtava taito on web-design-guidelines, jolla on noin 133 000 asennusta viikossa. Se tarkastaa käyttöliittymäkoodin yli 100 saavutettavuus-, suorituskyky- ja käytettävyysvaatimusta vasten.

Sen rinnalla on Anthropicin frontend-design, jolla on yli 110 000 asennusta viikossa. Se saa tekoälyn valitsemaan tyylin ennen koodin kirjoittamista. Ilman sitä jokaisella Clauden luomalla sivulla on Inter-fontti, violetti liukuväri ja ruudukkomaiset kortit. Lopputulos on kaikilla sama.

5. obra/superpowers – usean agentin työnkulku

Kaiken kaikkiaan, jos asennat tämän listan kolme ensimmäistä kokoelmaa – anthropics/skills, mattpocock/skills ja coreyhaines31/marketingskills – Claude Codessasi on kymmeniä valmiita taitoja, jotka kattavat suurimman osan yrittäjän tehtävistä ensimmäisen kuukauden aikana.

Haluatko valmiiden taitojen asentamisen lisäksi rakentaa kokoonpanon, joka tekee Claudesta aidosti avustajasi? Taidot ovat yksi menetelmän kolmesta tukipilarista. Toimiva kokoonpano koostuu kolmesta osasta: AI-klooni (paketoitu asiantuntemus taitoina) + Second Brain (kontekstin tietorakenne) + kontekstitekniikka (miten Claude näkee projektin kokonaisuutena). Tämä kokoonpano muuttaa Clauden arvailevasta avustajasta työkaluksi, joka ajattelee sinun logiikallasi.

Mitkä toistuvat tehtävät kannattaa muuttaa taidoksi?#

Olen nähnyt tämän kaavan kymmeniä kertoja asiakastöissä ja muiden projekteissa. Jollakulla on ”se juttu, jonka hän tekee joka kerta alusta”. Hän kirjoittaa joka maanantai samantyyppisen raportin. Aina uuden asiakkaan tullessa mukaan hän käy läpi saman menettelyn. Jokainen julkaisu noudattaa samaa mallia. Ja joka kerta siihen kuluu 30–90 minuuttia, koska hänen täytyy palauttaa vaiheet mieleen, avata oikeat tiedostot ja muotoilla Claude-kehote uudelleen.

Ratkaisu on paketoida se kerran taidoksi. Sen jälkeen sanot yhden ilmauksen, ja Claude lataa menetelmän, lukee tarvittavat lähteet ja tuottaa tuloksen. Tässä on kolme esimerkkiä eri aloilta:

Esimerkki 1. Freelance-markkinoija – weekly-content-plan-taito

Mitä hän tekee käsin: joka maanantai hän valmistelee viikon Telegram-julkaisut kolmelle asiakkaalle. Hän avaa asiakkaan brändiäänioppaan, käy läpi viimeisimmät julkaisut, keksii aiheita tuotekalenterin pohjalta ja laatii taulukon koukuista ja luettelokohdista.

Taitona tästä tulee viisivaiheinen ohje: lue asiakkaan äänensävyä käsittelevä tiedosto, lue tuotekalenteri, tarkista viimeiset 10 julkaisua toiston varalta, keksi seitsemän aihetta tyypin mukaan jaoteltuna (myynnillinen, asiantuntijasisältö, henkilökohtainen) ja tulosta taulukko.

Komento ”suunnitellaan asiakkaan X julkaisut tälle viikolle” muuttaa tunnin valmistelun kolmen minuutin odotteluksi. Markkinoija tarkistaa tuloksen, tekee kohdennetut muutokset ja lähettää sen asiakkaalle.

Esimerkki 2. Ulkoistettu kirjanpitäjä – monthly-receipts-close-taito (kirjoittajan esimerkki)

Mitä hän tekee käsin: jokaiselle asiakasportfolion asiakkaalle hän vie kuukausittain tiliotteen, täsmäyttää sen kirjanpitojärjestelmän maksuihin, merkitsee luokittelemattomat maksut, laatii alustavan tuloraportin ja vertaa tulojen rakennetta edelliseen kuukauteen.

Taito on kuusivaiheinen ohje sekä pari komentotulkkiskriptiä scripts/-kansiossa tiliotteiden jäsentämiseen. Käynnistin ”päätä toukokuu asiakkaalle X” saa Clauden tuottamaan raportin, jossa poikkeamat on merkitty, 4–5 minuutissa.

Esimerkki 3. Verkkokurssin järjestäjä – welcome-letter-new-participant-taito

Mitä hän tekee käsin: uusi osallistuja on maksanut, ja hänelle pitää kirjoittaa tervetuloviesti. Hyvä tervetulo on henkilökohtainen: siinä huomioidaan kanava, josta osallistuja tuli, ostettu tuote, kohortti ja mukaan lähetettävät materiaalit. ”Hei, kiva kun tulit” -malli ei tee tätä.

Taito ohjeistaa Claudea lukemaan knowledge/audience.md-tiedoston (keitä nämä ihmiset ovat), knowledge/products/<product>.md-tiedoston (mitä he saavat) ja kolme viimeisintä tervetuloviestiä (toiston välttämiseksi) ja kirjoittamaan sitten sähköpostin seuraavalla rakenteella: koukku – tuotteen erityispiirteet – kolme ensimmäistä askelta – lopputervehdys.

Moninkertaisesti nopeammin kuin käsin. Laatu on tasaisempaa, koska Claude muistaa tarkistaa kolme lähdettä, kun taas kiireinen ihminen jättää yhden niistä väliin.

Mitä EI kannata muuttaa taidoksi

• Kertaluonteiset tehtävät. Jos teet sen kerran vuodessa veroilmoitusta jättäessäsi, kuvaile se vain Claudelle keskustelussa. Taito kannattaa 3+ toiston jälkeen.
• Liian yleiset tehtävät. ”Auta markkinoinnissa” ei ole taito, vaan koko markkinoinnin ala. Taito on ”viikoittainen sisältösuunnitelma” – tietty toiminta, jolla on tietty tulos.
• Tehtävät, joissa ei ole toistettavia vaiheita. Jos prosessi muuttuu joka kerta, kyse ei ole taidosta vaan kertaluonteisesta työstä.

Miten Skill Creator kirjoittaa taitoja puolestasi?#

Haasteena on, että hyvää taitoa on vaikea kirjoittaa kerralla. Kuvaus jää usein liian suppeaksi tai laajaksi, siitä puuttuvat käyttäjien todella käyttämät ilmaukset tai se on ristiriidassa viereisen taidon kanssa. Anthropic ratkaisi tämän julkaisemalla skill-creatorin, metataidon, joka pystyy luomaan muita taitoja.

Asennettuasi anthropics/skills-kokoelman kerro Claudelle /skill-creator (tai sano vain ”tehdään taito viikkoraportille”) ja noudata kuusivaiheista työnkulkua:

1. Luonnostelu – skill-creator kysyy, mitä taidon pitäisi tehdä, mitä käynnistysilmauksia käyttää, mitä lähteitä lukea ja mitä vaiheita noudattaa. Tuloksena syntyy SKILL.md:n ensimmäinen versio.
2. Testaus – skill-creator luo 20 testikehotetta: 10, joiden pitäisi käynnistää taito, ja 10, jotka kuulostavat käynnistimiltä mutta joiden ei pitäisi (läheltä liippaavat tapaukset).
3. Arviointi – se suorittaa kunkin kehotteen uudessa keskustelussa ja tarkistaa, käynnistyikö taito. Jos taito käynnistyy väärissä tilanteissa tai ei käynnisty silloin kun pitäisi, tulos merkitään.
4. Iterointi – se kirjoittaa kuvauksen uudelleen virheiden perusteella ja suorittaa testit uudestaan.
5. Optimointi – viimeistelyssä tarkistetaan, ylittyykö 1024 merkin raja ja onko ristiriitoja projektin nykyisten taitojen kanssa.
6. Paketointi – lopullinen SKILL.md ja viitetiedostot paketoidaan oikeaan rakenteeseen.

Käytännössä tämä näyttää tältä: keskustelet Clauden kanssa 15–20 minuuttia, vastaat 7–8 tarkentavaan kysymykseen ja saat lopuksi käyttövalmiin, testatun taidon, joka käynnistyy oikeiden käynnistimien perusteella.

Toinen hyöty on se, että skill-creator näyttää esimerkillistä tyyliä SKILL.md-tiedostojen kirjoittamiseen. Voit avata sen oman tiedoston ja nähdä vaiheiden muodon, sävyn ja rakenteen. Työkalu opettaa itse: luet sitä ja opit kirjoittamaan omiasi.

Taidot, CLAUDE.md, aliagentit, MCP ja koukut: mitä kannattaa käyttää?#

Yleisin ongelma tarkastelemissani projekteissa on se, että CLAUDE.md sisältää samassa tiedostossa projektin säännöt, vaiheittaiset julkaisuohjeet, commit-mallin ja tietokannan kuvauksen. Tämä kuormittaa kontekstia ja epäonnistuu myös käytännössä: Claude ei suorita ohjetta ”kun käyttäjä pyytää julkaisemaan”, koska malli käsittelee koko CLAUDE.md:tä yleisenä kontekstina ilman nimenomaisia käynnistimiä.

Ratkaisu on sijoittaa kukin asia oikeaan perusvälineeseen:

Lyhyesti: taidot ja MCP kattavat useimmat työnkulut; koukut automatisoivat rutiinitehtäviä, kuten koodin tarkistuksia, testejä ja suojauksia. Aliagentteja tarvitaan, kun konteksti kasvaa raskaaksi. Yleisin virhe on luoda aliagentti silloin, kun pitäisi käyttää taitoa.

Päätöspuu

Kun ajattelet ”haluan Clauden tekevän X:n”:

1. Tarvitaanko tätä tietoa koko ajan? Esimerkiksi ”projektissa on määritelty kieli” tai ”emme käytä em-viivoja”. → Lisää se tiedostoon CLAUDE.md.
2. Onko kyse käynnistettävästä menettelystä, jonka teet nyt käsin? Esimerkiksi ”kirjoitan raportin joka maanantai”. → Tee siitä taito.
3. Tarvitsetko pääsyn ulkoiseen järjestelmään? Esimerkiksi Stripe-APIin tai CRM-järjestelmääsi. → Yhdistä MCP-palvelin.
4. Pitäisikö Claude Coden reagoida tapahtumaan automaattisesti? Esimerkiksi suorittaa linteri jokaisen Edit-tapahtuman jälkeen. → Kirjoita koukku.
5. Onko tehtävä raskas, viekö se kaiken kontekstin, ja pitääkö samalla tehdä jotain muuta rinnakkain? → Suorita se aliagentissa.

90 % yrittäjien ja vibe-koodaajien tehtävistä kuuluu luokkiin 1–3. Koukut ja aliagentit ovat seuraavan tason työkaluja tilanteisiin, joissa on päästy yli ”yksi tehtävä kerrallaan” -vaiheesta.

Vinoviivakomennot ja taidot ovat sama asia

Claude Codessa on tapahtunut tärkeä muutos: vanha vinoviivakomantojärjestelmä (.claude/commands/) ja taidot ovat käytännössä yhdistyneet. Tiedostot .claude/commands/deploy.md ja .claude/skills/deploy/SKILL.md luovat molemmat komennon /deploy. Jos nimet täsmäävät, taito voittaa. Jos käytät yhä vanhaa vinoviivakomentomuotoa, siirry taitoihin: syntaksi on selkeämpi ja ominaisuuksia on enemmän.

7 virhettä, joiden vuoksi taito ei toimi#

1. Kuvaus ilman käynnistimiä: taito ei käynnisty

Oire: kirjoitit taidon, tarkistit rakenteen ja kaikki on kelvollista, mutta Claude ei ota sitä käyttöön käyttäjän pyytäessä. Syy on lähes aina sama: kuvaus, kuten ”Apua sisällön kirjoittamiseen”. Claude ei tiedä, mihin ilmauksiin sen pitäisi reagoida. Korjaus: lisää kuvaukseen 3–5 todellista käyttäjän ilmaisua lainausmerkkeihin.

2. Yli 500-rivinen SKILL.md: huomio harhailee

Anthropic suosittelee nimenomaisesti, että tiedoston runko pysyy enintään 500 rivissä. Jos ohjeesi ovat 2 000 riviä pitkiä, Claude menettää keskittymisensä, noudattaa vaiheita vain osittain ja menee järjestyksessä sekaisin. Korjaus: siirrä suuret osat lähellä oleviin tiedostoihin, kuten examples/, references/ ja scripts/, ja viittaa niihin SKILL.md-tiedostosta.

3. Yksi taito ”kaikkeen sisältöön” kolmen pienen sijaan

Houkutteleva ratkaisu on yksi suuri content-taito, joka sisältää Telegram-julkaisut, laskeutumissivut ja sähköpostit. Se ei toimi. Taito käynnistyy väärissä pyynnöissä, sekoittaa menetelmät ja tuottaa keskiarvoistetun tuloksen. Korjaus: yksi taito = yksi toistettava toiminto. Jos sinulla on oikeasti kolme ”sisältöön” liittyvää rutiinia, tee kolme taitoa: telegram-post, landing-section, email-broadcast.

4. Taito ilman ”Milloin EI pidä käyttää” -osiota: ristiriitoja

Oire: projektissa on kaksi samankaltaista taitoa, ja Claude ottaa käyttöön väärän. Toinen taito voi koskea sähköpostiuutiskirjettä, toinen nimenomaan ohjelmaan osallistuvien tervetuloviestejä. Jos kuvauksessa ei ole nimenomaista ehtoa, jonka mukaan taitoa ei oteta käyttöön yleistä postituslistaa koskevissa pyynnöissä, tervetulosähköpostitaito käynnistyy aina, kun mainitaan ”sähköposti”. Korjaus: kirjoita negatiiviset tapaukset kuvaukseen.

5. Projektissa 50 taitoa: kuvaukset typistyvät

Claude Code -dokumentaation mukaan:

Jos latasit markkinapaikalta 50 taitokokoelmaa, joidenkin kuvauksia typistetään. Avainsanat, joihin luotit, saattavat kadota. Korjaus: pidä aktiivisessa projektissa 10–15 hyödyllisintä taitoa. Säilytä loput passiivisessa arkistossa kaikkien löydettävien skills-hakemistojen ulkopuolella, esimerkiksi omien aineistojesi erillisessä skill-archive/-kansiossa. Asenna vain tarvittavat skillit projekti- tai henkilökohtaiseen käyttöalueeseen. ~/.claude/skills/ on asennettu henkilökohtainen kirjasto, joka näkyy projekteissa; siirtäminen sinne ei poista skilliä löydettävyydestä.

6. Taidot vahvistamattomista lähteistä: tietoturvariski

Anthropic varoittaa tästä virallisessa dokumentaatiossa:

Satunnainen GitHub-repositorio voi sisältää taidon, joka vuotaa API-avaimesi jo ensimmäisellä käyttökerralla. Korjaus: avaa SKILL.md ja lue se itse ennen asentamista. Älä suorita tuntemattomien tekijöiden taitoja tärkeissä projekteissa.

7. Taito ilman tietokansiota tuottaa ”keskiverto-ChatGPT:tä”

Hienovaraisin ja yleisin toimintamalli, jota kannattaa välttää. Taito on menetelmä, mutta menetelmä yksin ei merkitse mitään ilman kontekstia. Jos kirjoitat ”kirjoita tervetulosähköposti” -taidon, mutta projektissa ei ole yleisöä kuvaavaa tiedostoa eikä brändiääntä käsittelevää tiedostoa, Claude kirjoittaa keskinkertaisen ChatGPT-sähköpostin, joka ei erotu muiden tekemistä.

Taito toimii parhaiten vasta, kun olet jo rakentanut projektin Second Brainin CLAUDE.md-oppaassa kuvattujen periaatteiden mukaan. Rakenna ensin tietorakenne ja luo sitten siihen tukeutuvat taidot. Jos teet asiat päinvastaisessa järjestyksessä, saat rutiininomaista keskinkertaista laatua yksilöllisen, omaa tyyliäsi noudattavan työn sijaan.

Miten rakennat ensimmäisen taitosi 30 minuutissa?#

Tässä on konkreettinen suunnitelma, jota käytin rakentaessani ensimmäisiä taitoja projekteihini:

Vaihe 1. Valitse yksi toistettava toiminto

Avaa viime kuukauden kalenteri. Etsi tehtävä, jonka olet tehnyt vähintään 4–5 kertaa ja johon kuluu joka kerralla 30–60 minuuttia. Älä valitse laajaa ”markkinointia”, vaan jokin tarkka asia: ”maanantain myyntiraportti”, ”uuden asiakkaan perehdytys” tai ”hinnaston päivittäminen kampanjaa varten”.

Mitä tarkemmin muotoilet asian, sitä yksinkertaisempi taito ja selkeämpi käynnistin.

Vaihe 2. Kirjoita prosessi auki käsin

Kirjoita erilliseen tiedostoon tai Claude-keskusteluun (ei vielä taitoa varten, vaan luonnokseksi) noudattamasi vaiheet:

1. Open the client database
2. Filter by status "awaiting welcome email"
3. Check which channel the client came from
4. Get the email template for that channel from the "templates" folder
5. Fill in the name, product, and start date
6. Send

Tämä ei vielä ole taito, vaan muistiinpanoja. Ilman niitä SKILL.md-tiedoston kirjoittaminen alkaa helposti sekoilulla.

Vaihe 3. Luo kansiorakenne

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Tai jos haluat käyttää taitoa kaikissa projekteissasi, sijoita se polkuun ~/.claude/skills/.

Vaihe 4. Kirjoita SKILL.md mallin avulla

Runko:

---
name: welcome-email-new-client
description: |
  Prepares a welcome email for a new client using the template for their acquisition channel.
  Triggers: "write a welcome email for new client X",
  "onboard new participant Y", "welcome email for client from channel Z".
  Do not activate if the request is about a general mailing list
  or an email campaign—those are other skills.
---

# Welcome Email for a New Client

## Steps

1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format

## Important

- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two

Vaihe 5. Testaa 5–8 kehotteella

Avaa tämän projektin Claude Codessa uusi keskustelu. Kokeile viittä oikeasti käyttämääsi ilmausta ja kolmea samankaltaista, joiden ei pitäisi käynnistää taitoa:

Käynnistämiseen kuuluvat:

• ”Kirjoita tervetulosähköposti uudelle asiakkaalle Ivanoville”
• ”Perehdytä uusi osallistuja, joka osti ohjelman X”
• ”Tervetulosähköposti asiakkaalle, joka tuli Instagramista”

Ei pitäisi käynnistää:

• ”Lähetä kampanjasähköposti koko listalle”
• ”Uudenvuoden sähköpostikampanja”
• ”Kirjoita jatkoviesti asiakkaalle, joka ei ole maksanut”

Tarkista jokaisen ilmauksen kohdalla, käynnistyikö taito. Jos se käynnistyy väärissä tapauksissa, rajaa kuvausta. Jos se ei käynnisty silloin kun pitäisi, laajenna käynnistysilmauksia.

Vaihe 6. Toista kuvauksen muokkausta

Muokkaa jokaisen epäonnistuneen testin jälkeen vain kuvausta – älä koske ohjerunkoon. 2–3 kierroksen jälkeen taito alkaa käynnistyä luotettavasti. Tallenna se, commitoi se ja käytä sitä sitten joka päivä.

Lopuksi: älä yritä tehdä ensimmäisestä taidostasi täydellistä. Tee siitä toimiva. Viimeistele se viidennen tai kymmenennen taidon kohdalla, kun alat huomata toistuvia malleja omissa ilmauksissasi ja Clauden vastauksissa.

Valitse kalenteristasi yksi toistuva tehtävä tälle viikolle, varaa siihen 30 minuuttia ja noudata yllä olevia kuutta vaihetta. Sen jälkeen Claude toimii menetelmäsi mukaan arvailun sijasta.

Toimiva kokoonpano on AI-klooni + Second Brain + kontekstitekniikka. Kolme osaa yhdessä menetelmässä.

Jos tarvitset pääsyn tekoälymalleihin Ailootin kautta, tutustu Ailootiin.