> ## Documentation Index > Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Skillit > Luo uudelleenkäytettäviä paketteja ulkoisille agenteille ja Automaatioille Skillit ovat uudelleenkäytettäviä ohjepaketteja, joihin voi liittyä valinnaisia tukitiedostoja. Niiden avulla tiimisi voi määrittää toistettavan tavan suorittaa tehtävä kerran ja soveltaa sitä sitten johdonmukaisesti kaikkialla Flowgladissa. Jokaisella Skillillä on nimi, slash-komennon slug, kuvaus ja Markdownilla kirjoitetut ohjeet. Tukitiedostot voivat tarjota lisäkontekstia tai resursseja, joita ohjeiden noudattaminen edellyttää. ## Käytä Flowgladia tiimisi Skill-kirjastona Flowglad säilyttää jokaisen Skillin versioituna pakettina. Muutoksen julkaiseminen luo uuden revision sen sijaan, että edellinen paketti korvattaisiin paikallaan. Organisaation adminit voivat avata Skillin **History**-näkymän tarkastellakseen sen revisioita, vertaillakseen muutoksia, palauttaakseen aiemman revision tai hylätäkseen luonnoksen, kun nämä toiminnot ovat käytettävissä. Näin tiimilläsi on yksi hallittu paikka uudelleenkäytettävien ohjeiden ylläpitoon, ja samalla säilyy tieto siitä, mikä versio oli aktiivinen milläkin hetkellä. Luonnos- ja hylätyt revisiot eivät korvaa aktiivista versiota. ### Hallitse Skillejä MCP:n kautta Kun olet yhdistänyt Flowglad MCP -palvelimen, agentti voi tarkastella ja hallita organisaatiosi Skill-kirjastoa puolestasi: * `skills.list` palauttaa yhteydelle näkyvät Skillit. * `skills.get` palauttaa yhden Skillin uusimman ja aktiivisen revision metatiedot. * `skills.create` lähettää uuden Skill-paketin. * `skills.create_candidate` lähettää olemassa olevan Skillin uuden revision. * `skills.publish_revision` varmentaa ja julkaisee lykätyn revision. * `skills.create_package_upload_session` ja `skills.finalize_package_upload_session` siirtävät paketit, jotka ovat liian suuria lähetettäviksi inline-muodossa. * `skills.get` raportoi hyväksytyn pyynnön varmennuksen ja ylennyksen tuloksen. Skillien luominen tai päivittäminen edellyttää `skills:write`-käyttöoikeutta sekä tiimiläisen organisaatiojäsenyydessä että MCP-yhteyden myönnössä. Jos lisäät käyttöoikeuden palvelimen yhdistämisen jälkeen, yhdistä Flowglad MCP uudelleen ja valtuuta `skills:write`, jotta kirjoitustyökalut tulevat käyttöön. **Käyttöoikeudet:** Admineilla on oletuksena Skillien laatimisoikeus. Jos haluat antaa Contributorille saman oikeuden, avaa **Settings** → **Team**, valitse tiimiläinen ja ota käyttöön **Skill Authoring**. Tämä antaa oikeuden luoda ja päivittää organisaation Skillejä tekemättä tiimiläisestä adminia. ## Lataa Flowglad MCP -Skillit agenttiisi Flowglad MCP -palvelin ilmoittaa `io.modelcontextprotocol/skills`-ominaisuuden MCP-alustuksen aikana. Tämä kertoo yhteensopiville asiakkaille, että palvelin toteuttaa agentin Skill-metodit `skills/list` ja `skills/get`. Jokainen palautettu Skill sisältää `skill://`-resurssien URI:t ja sisältötiivisteet; asiakkaat voivat noutaa tiedostot metodilla `resources/read`. Palvelimen yhdistäminen ei takaa, että asiakas kutsuu `skills/list`-metodia tai asentaa palautetut paketit. Asiakastuki vaihtelee. Lisää käynnistysohje ChatGPT:lle / Codexille tai Claudelle, kun haluat agentin päivittävän Flowglad-rekisterin jokaisen istunnon alussa. **MCP-nimeäminen:** Nimet ovat tarkoituksella erilaiset. Pisteellinen `skills.list` on Flowgladin työkalu organisaatiosi versioiduille Skill-tietueille. Kauttaviivallinen `skills/list` on MCP-protokollan laajennusmetodi agenteille tarkoitettujen Skill-pakettien löytämiseen. ### Lisää käynnistysohje Luo kohdehakemisto kerran ennen uuden istunnon aloittamista ja lisää sitten alla oleva vastaava ohjelohko. #### ChatGPT / Codex Luo ChatGPT:n / Codexin kohdehakemisto komennolla `mkdir -p ~/.agents/skills`. Lisää seuraava lohko tiedostoon `~/.codex/AGENTS.md`, jotta se koskee jokaista projektia, tai repositorion tiedostoon `AGENTS.md`, jotta se jaetaan kyseisen repositorion tiimin kanssa. ```markdown AGENTS.md theme={null} ## Flowglad MCP Skill bootstrap At the start of every new session, before handling the first task: 1. Confirm that the Flowglad MCP server is connected. 2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`. 3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`. 4. Synchronize the package into `~/.agents/skills//`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills. 5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation. 6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed. ``` #### Claude Luo Clauden kohdehakemisto komennolla `mkdir -p ~/.claude/skills`. Lisää seuraava lohko tiedostoon `~/.claude/CLAUDE.md`, jotta se koskee jokaista projektia, tai repositorion tiedostoon `CLAUDE.md`, jotta se jaetaan kyseisen repositorion tiimin kanssa. ```markdown CLAUDE.md theme={null} ## Flowglad MCP Skill bootstrap At the start of every new session, before handling the first task: 1. Confirm that the Flowglad MCP server is connected. 2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`. 3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`. 4. Synchronize the package into `~/.claude/skills//`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills. 5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation. 6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed. ``` Voit pyytää ChatGPT:tä / Codexia tai Claudea lisäämään sopivan lohkon omaan käyttäjätason ohjetiedostoonsa. Tarkista ehdotettu muokkaus ennen sen hyväksymistä, koska tiedosto vaikuttaa tuleviin istuntoihin. Ohje on parhaan yrityksen periaatteella toimiva agentin bootstrap; jos ympäristösi on päivitettävä Skillit deterministisesti, toteuta sama synkronointi luotetussa `SessionStart`-hookissa tai MCP-asiakasintegraatiossasi. ## Missä Skillejä käytetään Skilleillä on tällä hetkellä kaksi käyttäjää: * Yhteensopivat ulkoiset agentit löytävät ja synkronoivat käytössä olevat paketit Flowglad MCP:n kautta ja joko yhdistävät ne automaattisesti tai kutsuvat niitä nimellä. * Automaatiot kiinnittävät tarkan julkaistun Skill-revision OWS:n `skill-revision`-koodiresurssina. Automaatio valitsee paketin polun ja aloituspisteen; agenttivaiheet saavat vain ne Skillit, jotka sinetöity ajon capability-joukko valtuuttaa. Ensimmäinen polku tarjoaa uudelleenkäytettäviä ohjeita ulkoiselle agentille. Toinen tarjoaa muuttumatonta koodia ja tukitiedostoja toistettavalle Automaation ajolle. Julkaistut Skillit ovat organisaation laajuisia, joten valtuutettu Automaatio voi valita saman Skill-revision missä tahansa Spacessa. Skilliä käyttävä Automaatio ja sen ajot pysyvät oman Spacensa omistamina; Skillin valitseminen ei muuta tätä rajaa. ## Skillien luominen ja ylläpito Avaa **organisaatiovalikko** → **Skills** → **New Skill**. Syötä **Skill**-välilehdellä **Name**, **Slug**, valinnainen **Description** sekä uudelleenkäytettävät ohjeet kenttään **Markdown**. Käytä **Files**-välilehteä paketin tukitiedostoille ja valitse sitten **Create Skill**. Slug koostuu pienistä kirjaimista, numeroista ja yhdysmerkeistä, alkaa kirjaimella tai numerolla, ja käyttäjät kirjoittavat sen merkin `/` jälkeen. Skillin luominen tai muokkaaminen tuottaa luonnoksen. Skillin tietosivulla muokkaukset tallentuvat automaattisesti; valitse **Publish Draft** varmentaaksesi ja julkaistaksesi luonnoksen. Jos varmennus epäonnistuu, korjaa luonnos näytetyn diagnostiikan avulla ja julkaise uudelleen. Käytä **History**-näkymää revisioiden tarkasteluun, korvatun revision palauttamiseen tai muokattavan luonnoksen hylkäämiseen, kun nämä toiminnot ovat käytettävissä. **Disable Skill** poistaa Skillin ulkoisten agenttien löydettävistä ja Automaatioiden resoluutiosta poistamatta revisiohistoriaa; **Enable Skill** ottaa sen jälleen käyttöön. ## Luo tai muokkaa Skilliä MCP:llä Käytä yhdistettyä ulkoista MCP-asiakasta pakettilähtöiseen laatimiseen. Kutsu `skills.get` ennen olemassa olevan Skillin muokkaamista. Käytä `skills.create`-kutsua uudelle paketille tai `skills.create_candidate`-kutsua revisiolle, joka perustuu nykyiseen aktiiviseen revisioon. Pienet paketit voi toimittaa inline-muodossa. Suuremmille paketeille kutsu `skills.create_package_upload_session`, lataa pyydetyt objektit ja viimeistele kutsulla `skills.finalize_package_upload_session`. Jos varmennusta lykättiin, kutsu `skills.publish_revision`. Kysele `skills.get`-kutsulla hyväksytyn elinkaaripyynnön tilaa sekä sen varmennuksen tai ylennyksen tulosta. Skillin julkaiseminen ei luo, muokkaa tai aktivoi Automaatiota; käytä Automaation MCP-elinkaarta eksplisiittisesti, kun sellaista tarvitaan. ## Aloita Skill-mallipohjasta **Skills**-sivulla on **Skill Templates**. Hae tai suodata katalogia, esikatsele mallipohjaa ja valitse **Copy Skill**. Kopiosta tulee organisaation Skill, jota voi muokata ja julkaista kuten mitä tahansa muuta Skilliä. ## Skillit ja Automaatiot Skill määrittää, miten uudelleenkäytettävä työ tehdään. Se ei päätä, milloin työ suoritetaan. Käytä Automaatiota, kun työ on suoritettava manuaalisesti, aikataulun mukaan tai vastauksena tapahtumaan. Automaatio voi kiinnittää yhden tai useamman Skill-revision, jotta samaa toteutusta käytetään uudelleen ajosta toiseen. ## Related topics - [MCP](/docs/fi/mcp-server.md) - [Tervetuloa](/docs/fi/agents/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.