Guía de ClaudeNivel 2 · OrdenarLevel 2 · Getting organized

De proceso repetido a skillFrom repeated process to skill

Instrucciones que Claude carga solo cuando las necesita.Instructions that Claude loads only when it needs them.

Una skill es una carpeta con instrucciones (y, si hace falta, scripts) para una tarea concreta. La diferencia con el archivo general es que no se carga siempre: Claude la lee solo cuando el pedido la necesita. Si esas instrucciones vivieran en el archivo general, las pagaría en cada mensaje.

Mi regla es simple: lo que hice dos veces se vuelve skill.

Las que uso

  • Corregir texto. Corrección ortotipográfica y de estilo de mis textos, con mi hoja de estilo y el manual de voz. Devuelve los cambios como “original → corregido” y nunca reescribe en una voz que no es la mía.
  • Preparar un parcial. A partir de la carpeta con la bibliografía de una materia, ordena y renombra los archivos, hace el OCR en mi compu (sin gastar cuota), arma apuntes por eje con subagentes en esfuerzo bajo, un plan de estudio, un simulacro y un cuadernillo para imprimir. La armé con la primera materia y ya la usé en tres.
  • Las de mi app de escritura: fichar textos nuevos, seguir concursos y armar presentaciones. Viven dentro del proyecto de la app, porque solo sirven ahí.
  • Las de las tareas programadas: cada tarea es, en el fondo, una skill que corre a una hora fija.

Cómo armo una

  1. Escribo qué hace, cuándo se usa y qué criterios sigue. La descripción importa: es lo que Claude lee para decidir si la carga.
  2. El paso a paso, con todo lo pesado en scripts que corren en mi compu: convertir, renombrar, contar, validar. Lo que hace un script no gasta tokens.
  3. La pruebo con un caso real y la comparo con lo que hicimos a mano.
  4. Después de cada uso, si algo se trabó, la ajusto en el momento.

Las skills personales van en ~/.claude/skills/ y sirven en todos los proyectos; las de un proyecto, en .claude/skills/ dentro de su carpeta.

Las de otras personas

También se instalan skills ajenas, y algunas son muy buenas: grill me y wayfinder son de Matt Pocock, y la de criterio de diseño es de otro autor. Pero la primera vez el instalador me ofreció 38 de un repositorio, le di a todas y quedé con 45 skills. Uso unas cinco. Cada skill instalada suma su descripción a lo que Claude lee para decidir cuál cargar, así que las que sobran no son gratis.

Lo que hago ahora: instalo de a una, leo su SKILL.md antes y, si sirve solo para un proyecto, la instalo en ese proyecto y no en todos. Y el instalador lo corro yo: Claude, con buen criterio, no ejecuta solo código de terceros que baja de internet.

El prompt

Esto ya lo hicimos dos veces: [proceso]. Convertilo en una skill. Primero escribí qué hace, cuándo se usa y qué criterios sigue; después el paso a paso, con los scripts que hagan falta para que lo pesado corra en mi compu y no en la conversación. Si lanza subagentes para lotes, que vayan con esfuerzo bajo. Probala con un caso real y comparala con lo que hicimos a mano.

A skill is a folder with instructions (and, if needed, scripts) for a specific task. The difference from the general file is that it isn't always loaded: Claude reads it only when the request calls for it. If those instructions lived in the general file, I'd pay for them in every message.

My rule is simple: whatever I've done twice becomes a skill.

The ones I use

  • Proofread a text. Typographic and style correction of my texts, with my style sheet and the voice manual. It returns the changes as “original → corrected” and never rewrites in a voice that isn't mine.
  • Prepare an exam. From the folder with a course's readings, it organizes and renames the files, does the OCR on my computer (without spending quota), builds notes by topic with subagents at low effort, a study plan, a mock exam and a printable booklet. I built it with the first course and I've already used it on three.
  • The ones in my writing app: logging new texts, tracking contests and building presentations. They live inside the app's project, because they're only useful there.
  • The ones behind the scheduled tasks: at heart, each task is a skill that runs at a fixed time.

How I build one

  1. I write what it does, when it's used and what criteria it follows. The description matters: it's what Claude reads to decide whether to load it.
  2. The step by step, with everything heavy in scripts that run on my computer: converting, renaming, counting, validating. What a script does doesn't spend tokens.
  3. I test it with a real case and compare it with what we did by hand.
  4. After each use, if something got stuck, I adjust it right then.

Personal skills go in ~/.claude/skills/ and work in every project; a project's own go in .claude/skills/ inside its folder.

Other people's

You can also install skills made by others, and some are very good: grill me and wayfinder are by Matt Pocock, and the one on design judgment is by another author. But the first time, the installer offered me 38 from one repository, I said yes to all and ended up with 45 skills. I use about five. Every installed skill adds its description to what Claude reads to decide which one to load, so the surplus ones aren't free.

What I do now: I install one at a time, read its SKILL.md first and, if it's only useful for one project, I install it in that project and not in all of them. And I run the installer myself: Claude, with good judgment, doesn't run third-party code on its own that it downloads from the internet.

The prompt

We've already done this twice: [process]. Turn it into a skill. First write what it does, when it's used and what criteria it follows; then the step by step, with whatever scripts are needed so the heavy stuff runs on my computer and not in the conversation. If it launches subagents for batches, run them at low effort. Test it with a real case and compare it with what we did by hand.