Skills en Claude Code: Cómo Crear Comandos Personalizados

Las Skills son comandos personalizados que puedes invocar en Claude Code escribiendo una barra inclinada seguida del nombre, como /commit o /deploy. Son herramientas reutilizables que encapsulan lógica compleja en comandos simples. En esta guía, aprenderás a crear, configurar y compartir tus propias Skills.

¿Qué son las Skills?

Una Skill es un archivo SKILL.md que contiene un frontmatter YAML seguido de un prompt de instrucciones. Cuando invocas una Skill con /comando, Claude Code ejecuta el prompt de esa Skill en una nueva sesión aislada. Esto permite crear flujos de trabajo complejos reutilizables.

Las Skills se guardan en la carpeta .claude/skills/ de tu proyecto. Cada Skill es una carpeta con un archivo SKILL.md único.

Estructura de una Skill

Toda Skill sigue la estructura: frontmatter YAML + prompt de instrucciones. Aquí está un ejemplo completo de una Skill /commit:

---
name: commit
command: /commit
description: Create a conventional commit with AI assistance
author: Your Name
version: 1.0.0
arguments:
  - name: message
    type: string
    required: false
    description: Commit message (optional, will prompt if not provided)
tags:
  - git
  - automation
  - development
supportedLanguages:
  - es
  - en
---

# Skill: Smart Commit

You are an expert Git commit message generator. Your task is to create semantic, meaningful commits following the Conventional Commits standard.

## Task
1. Check current git status and staged changes
2. Analyze the diff of changes
3. Create a commit message following: type(scope): subject
4. Types: feat, fix, docs, style, refactor, perf, test, chore, ci
5. Subject: 50 chars max, lowercase, no period
6. Optionally add body and footer sections

If the user provided a message via $ARGUMENTS, enhance it. Otherwise, analyze the diff and suggest one.

Use `git commit -m "..."` to apply the commit.

Frontmatter Avanzado

El frontmatter YAML es donde defines la metadata de tu Skill. Los campos más importantes son:

•name: Identificador único, sin espacios
•command: El comando que escribirá el usuario (ej: /commit)
•arguments: Array de argumentos que acepta la Skill
•tags: Etiquetas para categorizar y buscar
•supportedLanguages: Idiomas en los que funciona

Argumentos Dinámicos

Dentro del prompt, accedes a los argumentos usando la variable $ARGUMENTS. Por ejemplo, si el usuario escribe /deploy production --wait, esos parámetros están disponibles en tu Skill:

---
name: deploy
command: /deploy
description: Deploy application with environment selection
arguments:
  - name: environment
    type: string
    required: true
    description: Environment to deploy to (production, staging, dev)
  - name: wait
    type: boolean
    required: false
    description: Wait for deployment to complete
---

# Smart Deploy

Your task is to deploy the application to the specified environment.

Environment: $ARGUMENTS.environment
Wait for completion: $ARGUMENTS.wait

## Steps:
1. Validate the environment name
2. Run `npm run build`
3. Execute appropriate deploy command based on environment
4. Verify deployment health
5. If wait=true, poll deployment status until complete

Compartir Skills con tu Equipo

Las Skills se guardan en .claude/skills/, que normalmente está en control de versiones. Esto significa que cuando haces push de tus cambios, todos en tu equipo tienen acceso automáticamente a tus Skills.

Para compartir entre equipos o públicamente, puedes:

•Crear un repositorio público de Skills reutilizables
•Usar el Skill Registry de Claude Code para publicar
•Incluirlas en una plantilla de proyecto

Las Skills son increíblemente potentes porque encapsulan expertise. Una Skill bien escrita puede ejecutar cientos de líneas de lógica compleja con un simple comando. En el módulo de Productividad Avanzada, aprenderás a crear 10+ Skills profesionales para diferentes workflows: commits inteligentes, reviews de código, deployment seguro, y más.