← Claude Code Hub
Jul 4, 2026 · 3 min de lectura ✦ Tip #124

Una skill, mil usos: pásale argumentos en Claude Code

Escribes una skill, funciona, y para el siguiente caso casi idéntico… la duplicas. Una skill puede recibir argumentos y comportarse distinta en cada llamada: named args, posicionales o `$ARGUMENTS`. De comando fijo a plantilla.

Una skill de Claude Code como plantilla: un SKILL.md con arguments name type y los slots $name y $type, que tres invocaciones distintas (SearchBar form, Modal overlay, Table data) rellenan por posición

TL;DR Una skill deja de ser un guión fijo cuando le pasas argumentos. Declara arguments: name type en el frontmatter y usa $name / $type en el cuerpo (la vía más legible); o tira de posicionales 0-based ($0 el primero, $1 el segundo) o de $ARGUMENTS (todo de golpe). argument-hint te lo autocompleta, y editar el texto del SKILL.md se recoge en vivo.

Escribes una skill para revisar un componente y funciona. Luego quieres casi la misma para otro caso y acabas duplicando el SKILL.md. No hace falta: una skill puede recibir argumentos y comportarse distinto en cada llamada. Ese es el salto de comando fijo a plantilla.

Lo que ves

/component SearchBar form
           └ $name    └ $type

→ "Crea un componente Vue llamado SearchBar, de tipo form…"

Las tres formas de recibir argumentos

1. $ARGUMENTS — todo lo que escribes

Lo más simple: $ARGUMENTS se sustituye por la cadena entera que va tras el comando. Si no lo pones en el cuerpo, Claude Code te lo anexa igual como ARGUMENTS: <valor>, así que nunca se pierde.

2. Posicionales $0, $1 — ojo, son 0-based

$0 es el primer argumento, $1 el segundo (equivalen a $ARGUMENTS[0] y $ARGUMENTS[1]). El desliz típico es esperar que $1 sea el primero: no lo es. Para valores con espacios, comíllalos: /skill "hello world" second deja $0 = hello world y $1 = second.

3. Named arguments — la más legible

Declara los nombres en el frontmatter y úsalos por nombre. Se auto-documenta y sobrevive a que reordenes el texto:

---
name: component
description: Genera un componente Vue con sus tests.
argument-hint: [name] [type]
arguments: name type
disable-model-invocation: true
---

Crea un componente Vue 3 llamado `$name`, de tipo `$type`.

- Estructura clara (lógica, template, estilos).
- Props tipadas y con valores por defecto.
- Un test que cubra el caso principal.

Invócala:

/component SearchBar form

$name → SearchBar, $type → form. Los nombres mapean a las posiciones en orden.

Referencia

Sustitución Qué inserta
$ARGUMENTS Todo lo que escribes tras el comando
$ARGUMENTS[0] / $0 El primer argumento (0-based)
$ARGUMENTS[1] / $1 El segundo argumento
$name El argumento nombrado en arguments:, por posición
Frontmatter Qué hace
arguments Nombra los posicionales para usar $name en el cuerpo (string o lista YAML)
argument-hint Pista en el autocompletado: [name] [type]
disable-model-invocation true para que solo tú lo invoques (lo normal en un comando con args)

Gotchas reales:

  • 0-based: si esperas el primer argumento, es $0, no $1.
  • $ literal: escápalo con backslash (\$1.00) para que no lo trate como argumento.
  • En vivo: cambiar el texto del SKILL.md se recoge sin reiniciar; solo los hooks/, .mcp.json o agents/ de un plugin necesitan /reload-plugins.

Esto amplía Crea comandos reutilizables con skills: allí montas el SKILL.md, aquí lo conviertes en una plantilla que rellenas por llamada. Y recuerda que ahí custom commands y skills son ya lo mismo: .claude/commands/deploy.md y .claude/skills/deploy/SKILL.md crean el mismo /deploy.

Documentación oficial: Extender Claude con skills

Relacionado: Crea comandos reutilizables con skills

Requisitos

  • Una skill de Claude Code (~/.claude/skills/<nombre>/SKILL.md para tenerla en todos tus proyectos).

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
GUÍA GRATUITA

No necesitas Opus siempre.

Modelo y effort son dos ajustes, no uno. 8 páginas con la configuración que de verdad mueve la factura, el diagnóstico en tres preguntas cuando algo falla y la escalera de precios.

  • 1. Qué es «mejor» capacidad, tiempo y dinero
  • 2. Modelo a quién mandas
  • 3. Effort cuánta cuerda le das
  • 4. Diagnóstico tres preguntas cuando algo falla
  • 5. La factura por dónde llega
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 8
#

Wmedia · 8 páginas
GUÍA GRATUITA · 8 páginas · 2 mandos

No necesitas Opus siempre.

Modelo y effort son dos ajustes, no uno. 8 páginas con la configuración que de verdad mueve la factura, el diagnóstico en tres preguntas cuando algo falla y la escalera de precios.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras
Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver las skills

¿Usas Opus para todo? Mira cuándo no hace falta.