Frontmatter erreferentzia

SKILL.md fitxategi guztiek YAML frontmatterra sartu behar dute --- mugatzaileen artean, fitxategiaren goialdean.

Beharrezko eremuak

Eremua	Mota	Deskribapena
name	string	kebab-case identifikatzaile bakarra. Direktorioaren izenarekin bat etorri behar du.
title	string	Marketplacean agertzen den izen irakurgarria.
description	string	Skillak zer egiten duen deskribatzen duen esaldi bakarra.
version	string	Bertsio semantikoaren katea (adibidez, "1.2.0").
author	string	Zure GitHub kontuaren izena.
trigger	string	Agenteak skill hau noiz aktibatu behar duen. Izan zehatza.

Gutxieneko frontmatter baliozkoa

---
name: my-skill
title: "My Skill"
description: "Does one specific thing clearly."
version: "1.0.0"
author: "your-github-handle"
trigger: "Use when the user asks to do X."
---

Hautazko eremuak

Eremua	Mota	Balio lehenetsia	Deskribapena
tags	string[]	[]	Bilaketak iragazteko kategoria-etiketak. Gehienez 5.
license	string	"MIT"	SPDX lizentzia-identifikatzailea.
homepage	string	—	Zure skillaren dokumentazio edo biltegiaren URLa.
repository	string	—	GitHub biltegiaren URLa (automatikoki detektatzen da GitHub bidez bidaltzen bada).
min_runtime	string	—	Claude Code-ren gutxieneko bertsioa (adibidez, "1.4.0").
tools	string[]	[]	Skillak deitzen dituen tresnen zerrenda (adibidez, ["Bash", "Read", "Write"]).
deprecated	boolean	false	Markatu skilla zaharkitua gisa. Bilaketetatik kentzen du.
deprecated_by	string	—	Hau ordezkatzen duen skillaren izena.
experimental	boolean	false	Esperimentala gisa markatu. Abisu-txapa erakusten du.

Adibide osoa hautazko eremuekin

---
name: rna-qc
title: "Single-Cell RNA QC"
description: "Performs quality control on scRNA-seq data using Seurat and scran."
version: "2.1.0"
author: "bioinformatics-jeff"
trigger: "Use when the user wants to perform QC on single-cell RNA-seq data, filter low-quality cells, or assess mitochondrial content."
tags:
  - bioinformatics
  - single-cell
  - R
  - quality-control
license: MIT
homepage: "https://github.com/bioinformatics-jeff/rna-qc"
repository: "https://github.com/bioinformatics-jeff/rna-qc"
min_runtime: "1.3.0"
tools:
  - Bash
  - Read
  - Write
experimental: false
---

Eremuen balioztatze-arauak

• name: letra minuskulak, zenbakiak eta marratxoak soilik. Tarterik gabe. Direktorioaren izenarekin zehatz-mehatz bat etorri behar du.
• version: semver jarraitu behar du — MAJOR.MINOR.PATCH
• tags: tag bakoitza minuskuletan, tarterik gabe (erabili marratxoak). Gehienez 5 tag skill bakoitzeko.
• trigger: gutxienez 10 hitz. Trigger lausoek (< 10 hitz) ez dute balioztatzea gainditzen.
• description: gehienez 160 karaktere (bilaketa-emaitzen txarteletan kabitzeko).

Eskema-balioztatzea

Exekutatu npx @hordago/skill-validator zure frontmatterra eskema osoaren aurka egiaztatzeko bidali aurretik. Balioztatze-erroreak lerro-zenbakiekin eta konponketa-iradokizunekin jakinarazten dira.