Glosario
49 términos de «Claude Code Skills: crea tus propios flujos de trabajo con IA». Pasa el cursor sobre la primera aparición en la lección para ver la definición.
| Término | Definición | Fuente |
|---|---|---|
| Skill | Un directorio más un archivo SKILL.md: un paquete reutilizable de instrucciones de flujo de trabajo que le dice a Claude cómo hacer una tarea específica. | Blog de ingeniería de Anthropic: Equipping agents for the real world with Agent Skills |
| SKILL.md | El archivo central de una Skill, que contiene dos partes: frontmatter YAML (metadatos) e instrucciones en Markdown (las indicaciones que Claude sigue). | Documentación oficial de Claude Code: Extend Claude Code with skills |
| frontmatter YAML | El bloque de metadatos en la parte superior de SKILL.md, envuelto en marcadores de triple guion (---), que contiene campos como name y description. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| name | Un campo obligatorio del frontmatter que define el identificador único de la Skill; se convierte en el comando y debe usar letras minúsculas, dígitos y guiones. | Blog de ingeniería de Anthropic: Equipping agents for the real world with Agent Skills |
| description | Un campo obligatorio del frontmatter que le dice a Claude qué hace la Skill y cuándo usarla. Es la única base para la activación automática. | Building skills for Claude, en la práctica: frontmatter YAML y pruebas |
| activación automática | Cuando lo que dice el usuario coincide con la description de una Skill, Claude carga y ejecuta esa Skill por su cuenta, sin comando manual. | Building skills for Claude, en la práctica: frontmatter YAML y pruebas |
| invocación manual | Llamar a una Skill directamente con /skill-name, lo que obliga a Claude a cargarla sin depender de que la description coincida. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| instrucciones en Markdown | Todo lo que hay en SKILL.md después del frontmatter: las indicaciones concretas, paso a paso, que Claude sigue, escritas en Markdown. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| divulgación progresiva | Darle a Claude solo lo que necesita ahora mismo en vez de volcar cada detalle de una vez, de modo que la Skill quede corta y cargue rápido. | Documentación de la plataforma de Anthropic: Agent Skills overview |
| archivos de apoyo | Archivos en un directorio de Skill distintos de SKILL.md (checklists, configuración, scripts) que se cargan bajo demanda y no consumen contexto inicial. | Documentación de la plataforma de Anthropic: Agent Skills overview |
| skills personales | Skills almacenadas en ~/.claude/skills/, disponibles solo para ti pero utilizables en todos los proyectos. Buenas para hábitos personales y herramientas de propósito general. | Teach Claude Code your workflow: guía práctica de skills personalizadas |
| skills de proyecto | Skills almacenadas en el directorio .claude/skills/ de un proyecto, commiteadas en Git para que los compañeros las reciban automáticamente al clonar el repo. | Teach Claude Code your workflow: guía práctica de skills personalizadas |
| Repetición | Uno de los tres rasgos que hacen que un escenario se adecue a una Skill: haces lo mismo a diario, semanalmente, a veces cada hora. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Pasos fijos | Uno de los tres rasgos que hacen que un escenario se adecue a una Skill: el proceso se puede escribir como pasos claros en vez de cambiar cada vez. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Verificable | Uno de los tres rasgos que hacen que un escenario se adecue a una Skill: puedes saber si Claude obtuvo el resultado correcto. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| fórmula de la description | La guía para escribir una description eficaz: qué hace + cuándo usarla + capacidades clave. | Building skills for Claude, en la práctica: frontmatter YAML y pruebas |
| palabras disparadoras | Las palabras en una description que un usuario podría decir de forma plausible; Claude coteja sobre estas para decidir si auto-cargar la Skill. | Building skills for Claude, en la práctica: frontmatter YAML y pruebas |
| Formato de entrada | La sección de instrucciones que explica qué tipo de entrada acepta la Skill, incluyendo forma, fuente y un ejemplo concreto. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Pasos de procesamiento | Las operaciones ordenadas y concretas que ejecuta la Skill; el corazón de las instrucciones, donde cada paso debe ser lo bastante específico para ser inequívoco. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Formato de salida | La sección de instrucciones que define cómo debe verse el resultado, incluyendo estructura, símbolos y un ejemplo trabajado. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| casos límite | Entradas inusuales o anormales (entrada vacía, entrada mal formada, contenido demasiado largo) cuyo manejo debe explicarse explícitamente en las instrucciones. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| invocación directa | La prueba más simple: llamar a la Skill con /skill-name y observar si la salida coincide con las expectativas. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| casos de prueba | Pares de entrada-y-salida-esperada preparados usados para probar una Skill sistemáticamente antes de depender de ella. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| ciclo de iteración | El ciclo probar-encontrar-arreglar-reprobar por el que pasa una Skill; el camino de 'funciona' a 'funciona bien'. | Claude Code skills: flujos de trabajo .NET y prompts reutilizables |
| Compáralo A/B | Ejecutar la misma tarea con y sin la Skill y tomar el tiempo en ambos, para probar si la Skill es realmente más rápida y más consistente. | Claude Code skills: flujos de trabajo .NET y prompts reutilizables |
| patrón de checklist | Organizar una tarea compleja como una serie de ítems de revisión explícitos, cada uno de los cuales puede pasar o fallar de forma independiente. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| flujo de trabajo de varios pasos | Una Skill que ejecuta varios pasos secuenciales para terminar una tarea compleja, donde la salida de un paso puede alimentar el siguiente. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Graduar la salida | Dividir los hallazgos de una Skill por severidad (pasó, vale la pena mirar, hay que arreglar) de modo que el lector sepa qué actuar primero. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| control de versiones | Gestionar skills de proyecto con Git para que puedas ver historial, revertir y comparar versiones, del mismo modo que gestionas código. | Claude Code skills: flujos de trabajo .NET y prompts reutilizables |
| Revisar una Skill | Revisar una Skill nueva o cambiada del modo en que revisas código: revisar la description, las instrucciones y las pruebas antes de mergear. | Las skills de Claude como runbooks autodocumentados |
| convención de nombres | Un estilo acordado en todo el equipo para nombres de Skill: guiones, orden verbo-sustantivo o sustantivo-verbo, dos o tres palabras. | Claude Code skills: flujos de trabajo .NET y prompts reutilizables |
| hacer limpieza periódica | Revisar todas las Skills una vez por trimestre y borrar o mejorar las que apenas se usan, de modo que una pila sin usar no llene las opciones de Claude. | Claude Code skills: flujos de trabajo .NET y prompts reutilizables |
| anunciar los cambios | Después de cambiar una Skill existente, publicar el cambio y su impacto en el canal del equipo de modo que la gente no opere la nueva Skill con suposiciones viejas. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Componer Skills | Encadenar varias Skills de propósito único para manejar una tarea mayor, o referenciar una Skill desde dentro de otra. | Blog de ingeniería de Anthropic: Equipping agents for the real world with Agent Skills |
| allowed-tools | Un campo opcional del frontmatter que restringe una Skill a un conjunto especificado de herramientas, trazando una frontera de permisos para casos sensibles a seguridad. | Análisis a fondo de Claude Skills (una mirada desde los primeros principios) |
| disable-model-invocation | Un campo opcional del frontmatter que, cuando se establece, impide que Claude auto-cargue la Skill, dejando solo invocación manual, para evitar activaciones accidentales. | Análisis a fondo de Claude Skills (una mirada desde los primeros principios) |
| model | Un campo opcional del frontmatter que fija un modelo específico para la Skill, por ejemplo un modelo de razonamiento más fuerte cuando la tarea lo necesita. | Análisis a fondo de Claude Skills (una mirada desde los primeros principios) |
| servidor MCP | Un servidor de Model Context Protocol que provee herramientas (acceso a base de datos, llamadas a API) a Claude; una Skill provee el conocimiento de flujo de trabajo para usarlas. | The complete guide to building skills for Claude (PDF) |
| Skills de la comunidad | Skills construidas y compartidas por otros desarrolladores, encontrables en GitHub y otros lados. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Documentar las Skills | Listar cada skill de proyecto, con uso y ejemplos, en el README del proyecto o .claude/README.md. | Las skills de Claude como runbooks autodocumentados |
| un solo propósito | Cada Skill debería hacer una cosa y hacerla bien, en vez de intentar resolver varios problemas no relacionados en una Skill. | Blog de ingeniería de Anthropic: Equipping agents for the real world with Agent Skills |
| contexto | Cuando Claude carga una Skill, el contenido de SKILL.md ocupa la ventana de contexto; mientras más largo el archivo, más consume. | Documentación de la plataforma de Anthropic: Agent Skills overview |
| se cargan bajo demanda | El contenido de archivo de apoyo se lee solo cuando Claude realmente lo necesita, de modo que no ocupe contexto en la carga inicial de la Skill. | Documentación de la plataforma de Anthropic: Agent Skills overview |
| falsos positivos | Cuando una Skill marca código o contenido normal como problema; arréglalo agregando una categoría 'necesita confirmación' o ajustando los criterios. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Omisiones | Cuando una Skill falla en capturar un problema que debería haber encontrado; arréglalo agregando reglas de revisión o ajustando la lógica de juicio. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| falla de carga | Cuando una Skill no se auto-carga o una llamada manual falla, el proceso de diagnóstico de revisar ruta de archivo, formato de frontmatter y ortografía de name en ese orden. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| Ejemplos | Proveer ejemplos de entrada/salida de modo que Claude entienda el comportamiento esperado; un ejemplo trabajado hace más que descripción en prosa. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| rama de feature | Crear o cambiar una Skill experimental en una rama de Git y mergear a main solo una vez que se lo gana, de modo que el equipo no se interrumpa. | Documentación oficial de Claude Code: Extend Claude Code with skills |
| conocimiento de flujo de trabajo | Conocimiento sobre cómo organizar pasos, cuándo usar qué herramienta y cómo juzgar el resultado; el valor central que provee una Skill. | The complete guide to building skills for Claude (PDF) |