Zure skilla mantentzea

Argitaratzea hasiera da, ez amaiera. Skillek eguneraketak behar dituzte agente-runtimea garatu ahala, erabiltzaileen iritziak pilatu ahala eta SKILL.md espezifikazioak ezaugarri berriak gehitzen dituen heinean.

Bertsionatzea

Jarraitu bertsionatze semantikoari:

Aldaketa-mota	Bertsio-igoera	Adibidea
Akats tipografikoa edo hitzak argitzea	Patch	1.0.0 → 1.0.1
Adibide berriak edo hautazko portaera gehitzea	Minor	1.0.0 → 1.1.0
Argibideak berridaztea edo triggerra aldatzea	Major	1.0.0 → 2.0.0

Bertsio berri bat GitHubera igotzean, marketplace-aren indexatzaileak bertsio-aldaketa detektatzen du eta eguneratutako skilla automatikoki birpuntuatzen du. Ez da eskuz berriro bidali behar.

Eguneraketak igotzea

# Make your changes to SKILL.md
# Bump the version field in frontmatter
git add SKILL.md
git commit -m "fix: clarify trigger wording (1.0.1)"
git push

Marketplacea zure biltegiarekin sinkronizatzen da zure adar lehenetsiko push-a egin eta 15 minutuan.

CI balioztatzea

Gehitu balioztatze automatikoa zure GitHub Actions workflow-ari, eskema-erroreak marketplacera iritsi aurretik harrapatzeko:

# .github/workflows/validate-skills.yml
name: Validate Skills

on: [push, pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npx @hordago/skill-validator ./ --recursive

Honek marketplaceko auto-scorerrak erabiltzen duen balioztatzaile bera exekutatzen du, beraz, arazoak lokalki ikusten dituzu push egin aurretik.

Skill bat zaharkitzea

Skill bat hobeago batekin ordezkatu baduzu, zaharkitu ezazu ezabatu beharrean. Skill zaharra instalatuta duten erabiltzaileek migrazio-jakinarazpena jasoko dute.

---
name: old-skill
# ... other fields ...
deprecated: true
deprecated_by: "new-skill"
---

Bidali eguneraketa GitHubera. Marketplaceak:

1. Skilla bilaketa-emaitzetatik kenduko du
2. Zaharkitze-oharra erakutsiko du skillaren xehetasun-orrian
3. Instalatuta duten erabiltzaileei new-skill-era aldatzeko jakinaraziko die

Ez ezabatu biltegia ez SKILL.md fitxategia — runtimeak fitxategia bertan behar du lehendik dauden erabiltzaileei zaharkitze-oharra zerbitzatzeko.

Erabiltzaileen iritziei erantzutea

Erabiltzaileen balorazioak eta iruzkinak zure marketplace-dashboardean agertzen dira. Eragiteko merezi duten eredu arruntak:

• “Triggerra ez da abiarazten” — Zure triggerraren deskribapena estuegia izan daiteke. Zabaldu eta igo patch bat.
• “Argibide argigabeak” — Gehitu adibideak edo zenbakitutako urratsak gorputzera.
• “X skillarekin gatazka” — Gehitu ohar bat triggerrera zure skilla NOIZ EZ erabili azalduz.

Artxibatzea

Skill bat jada mantentzen ez baduzu eta ordezkorik ez badago, artxibatu ezazu:

---
name: my-skill
deprecated: true
---

deprecated_by eremurik gabe, skilla artxibatuta markatzen da berbideratu beharrean. Artxibatutako skillak bilaketetatik ezkutatzen dira, baina URL zuzenaren bidez eskuragarri jarraitzen dute.