Skip to main content

Crea tu primer skill

Este inicio rápido te lleva de cero a un skill publicado en menos de 10 minutos.

Requisitos previos

  • Una cuenta de GitHub
  • Familiaridad básica con YAML y markdown

Paso 1 — Crea la estructura de directorios

Cada skill vive en su propio directorio. El nombre del directorio se convierte en el identificador del skill.

mkdir my-skills/
mkdir my-skills/hello-world/
touch my-skills/hello-world/SKILL.md

Paso 2 — Escribe el frontmatter

Abre SKILL.md y añade el frontmatter requerido:

---
name: hello-world
title: "Hello World"
description: "Greets the user with a friendly message."
version: "1.0.0"
author: "your-github-handle"
trigger: "Use when the user says hello, hi, or asks for a greeting."
tags:
  - utility
  - beginner
license: MIT
---

Todos los campos requeridos están listados en la Referencia de Frontmatter.

Paso 3 — Escribe el cuerpo del skill

Debajo del frontmatter, añade las instrucciones que el agente seguirá:

# Hello World

Greet the user warmly. Use their name if known. Keep the greeting to one or two sentences.

Always include:
- A friendly opening
- An offer to help with something specific

Example output:
> "Hello! I'm Hordago. What can I help you build today?"

Paso 4 — Valida localmente

Antes de enviarlo, valida tu SKILL.md contra el esquema:

npx @hordago/skill-validator ./my-skills/hello-world/SKILL.md

Salida esperada:

✓ Frontmatter valid
✓ Required fields present
✓ Trigger description is specific enough
✓ bc7score estimate: 72 / 100

Skill is ready to publish.

Si la validación falla, corrige los errores reportados y vuelve a ejecutar.

Paso 5 — Sube a GitHub

Sube el directorio de tu skill a un repositorio público de GitHub:

git init
git add .
git commit -m "feat: add hello-world skill"
git remote add origin git@github.com:your-handle/my-skills.git
git push -u origin main

Paso 6 — Envía al marketplace

Ve a hordago-labs.com/marketplace/submit y pega la URL de tu repositorio. El auto-scorer se ejecutará en unos minutos y abrirá una PR de revisión si tu skill supera el umbral mínimo.

Consulta Publicar para más detalles sobre el proceso de revisión.