← DokumentationMarkdownLogga in

Agenthandbok

Korta instruktioner för kodningsagenter som använder MCP.

Du är ansluten till Skillvad, ett personligt och team-skillbibliotek (inte en marketplace eller skillbutik). Publika skills kan synas på en profil; det är delning, inte en butik. Skills följer det öppna Agent Skills-formatet: en SKILL.md (instruktioner med name- och description-frontmatter), plus valfria filer i references/, scripts/ och assets/.

Varumärke: alltid Skillvad. Domän: skillvad.tech.

Första stegen

  1. Anropa get_docs med topic agent (eller läs resource https://skillvad.tech/docs/agent.md) om du behöver en uppfräschning.
  2. Använd list_skills för att kolla användarens skills och deras teams bibliotek innan du skapar dubbletter. För att öppna någon annans delade skill, använd get_skill med id:t från dess länk.
  3. På Free-planen kan en användare spara upp till 25 skills; upsert_skill returnerar ett fel vid gränsen. Jobba inte runt det.
  4. Agentetikett (en gång per konversation): innan första upsert_skill i den här konversationen, föreslå en kort etikett (t.ex. Cursor on Mac, Claude Desktop) och be användaren bekräfta eller redigera den. Skapa eller uppdatera ingen skill förrän de bekräftar. Skicka sedan samma värde som agentLabel på varje upsert_skill resten av konversationen.
  5. Använd upsert_skill med en tydlig titel. Den uppdaterar din egen skill med den titeln, eller skapar en ny. Skicka team för att arbeta i ett team-bibliotek.
  6. Bifoga alltid minst ett exempel när du publicerar en ny skill (add_example).

Använda en skill

  1. Ladda den med get_skill och följ dess instruktioner.
  2. get_skill listar medföljande files efter sökväg. Läs en med get_skill_file bara när instruktionerna pekar på den eller uppgiften behöver den.
  3. Använd skillens exempel som referens för format, ton och kvalitet.

Skriva en bra skill

  • Description: vad skillen gör och när den ska användas, med de ord en användare faktiskt skulle säga. Agenter avgör om de ska ladda en skill enbart från detta.
  • Instructions (content): rå Markdown, inte HTML. Steg, regler och hur bra output ser ut. Håll den under cirka 500 rader.
  • References: flytta långt material (stilguider, API-anteckningar, checklistor) till references/ med put_skill_file, och namnge varje fil med dess sökväg i instruktionerna, t.ex. "For banned words, read references/banned-words.md". Mallar och data hör hemma i assets/, körbar kod i scripts/.
  • License: sätt bara license (t.ex. MIT, Apache-2.0, CC-BY-4.0, Proprietary) när användaren väljer en. Fråga; välj inte åt dem.
  • Requirements: sätt compatibility bara om skillen behöver specifika verktyg eller åtkomst.

Ladda upp en skill-mapp

När användaren ber dig ladda upp en lokal skill (till exempel ~/.claude/skills/pdf-processing/):

  1. Läs SKILL.md. Använd dess name (som en läsbar titel), description och license; brödtexten efter frontmatter är content.
  2. Anropa upsert_skill med de fälten. Om mappen har en LICENSE-fil, skicka dess text som licenseText.
  3. För varje fil under references/, scripts/ och assets/, anropa put_skill_file med samma relativa sökväg, t.ex. references/forms.md.
  4. Endast textfiler upp till 100 KB vardera, 30 per skill, en undermappsdjup. Hoppa över binärer (bilder, PDF:er) och berätta för användaren vilka filer du hoppade över.
  5. Ge användaren skillens länk när du är klar.

Åt andra hållet kan användaren ladda ner vilken skill som helst som zip från dess sida och packa upp den i sin apps skills-mapp.

Synlighet

Nya skills är Privat som standard (bara ägaren). Skicka team utan visibility för att skapa i ett teambibliotek.

Ägaren kan sätta visibility på upsert_skill till private, unlisted, public eller team (med team-slug). Utelämna vid uppdatering för att lämna oförändrat. Ändra bara när användaren ber om det. Dela aldrig en skill med hemligheter. Olistad är öppen med länken; Publik syns också på profilen på https://skillvad.tech/u/<username>.

Auth-kontext

Din anslutning tillhör en användare. Allt du skapar ägs av den användaren, och du kan bara ändra det den användaren kan ändra.

URL:er att citera

  • App: https://skillvad.tech/app
  • Skill: använd url som tools returnerar. Den ser ut som https://skillvad.tech/u/<username>/skills/<id>.
  • Exempel: skill-URL:en plus /examples. Referenser: skill-URL:en plus /references.
  • Docs: https://skillvad.tech/docs
  • Agent-doc (rå): https://skillvad.tech/docs/agent.md

Gör inte

  • Kalla inte Skillvad en marketplace, skillbutik eller plats att köpa skills. Det är ett bibliotek.
  • Radera inte skills eller filer om inte användaren bekräftar.
  • Klistra inte in hemligheter i skills, filer eller exempel.
  • Förlita dig inte på klientrendering; lagra Markdown-källan.