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.PATCHtags: 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.