logongas

Herramientas de usuario

Herramientas del sitio

Ocultar Menú
Traza:
cursos:sdd:10-creando-skills

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
cursos:sdd:10-creando-skills [2026/11/06 08:47] – Corregir anclaje al apartado Agente: do- del tema 9 claudecursos:sdd:10-creando-skills [2026/11/06 08:49] (actual) – Nomenclatura del tema 9: skill (k-), agente (do-) y subagente, en vez de skill de conocimiento y de procedimiento claude
Línea 1: Línea 1:
 ====== 10. Estructura de un skill ====== ====== 10. Estructura de un skill ======
  
-Qué es una //skill//, su frontmatter y cómo se redacta están en [[cursos:sdd:08-skills-agentes|Skills y agentes]]; los tres tipos que usamos, ''k-'', ''do-'' y los subagentes, y por qué se llaman así, en [[cursos:sdd:09-skills-agentes-subagentes|Skills, agentes y subagentes]]. Aquí, la estructura completa de una //skill//: qué carpetas y ficheros puede tener y qué secciones lleva el ''SKILL.md'' de cada tipo. Cómo se prueba está en [[cursos:sdd:21-evaluacion-skills|Evaluación de skills]].+Qué es una //skill//, su frontmatter y cómo se redacta están en [[cursos:sdd:08-skills-agentes|Skills y agentes]]; los tres tipos que usamos, ''k-'', ''do-'' y los subagentes, y por qué se llaman así, en [[cursos:sdd:09-skills-agentes-subagentes|Skills, agentes y subagentes]]. Aquí, la estructura completa: qué carpetas y ficheros puede tener y qué secciones lleva el ''SKILL.md'' de una //skill//, el de un agente y el fichero de un subagente. Cómo se prueba está en [[cursos:sdd:21-evaluacion-skills|Evaluación de skills]].
  
 Más información: Más información:
Línea 7: Línea 7:
   * [[https://agentskills.io/specification|Specification - Agent Skills]]: el estándar de las //skills//: ''SKILL.md'', ficheros de apoyo y carga por niveles.   * [[https://agentskills.io/specification|Specification - Agent Skills]]: el estándar de las //skills//: ''SKILL.md'', ficheros de apoyo y carga por niveles.
   * [[https://code.claude.com/docs/en/skills|Claude Code: skills]]: dónde se guardan, cómo se lanzan y cómo se pasan argumentos con ''$ARGUMENTS''.   * [[https://code.claude.com/docs/en/skills|Claude Code: skills]]: dónde se guardan, cómo se lanzan y cómo se pasan argumentos con ''$ARGUMENTS''.
-  * [[https://github.com/github/spec-kit|GitHub Spec Kit]]: de sus comandos sale la estructura de las //skills// de procedimiento (Formato de entrada, Outline).+  * [[https://github.com/github/spec-kit|GitHub Spec Kit]]: de sus comandos sale la estructura de los agentes (Formato de entrada, Outline).
   * [[https://github.com/anthropics/skills/tree/main/skills/skill-creator|skill-creator]]: la //skill// de Anthropic para crear y evaluar //skills//.   * [[https://github.com/anthropics/skills/tree/main/skills/skill-creator|skill-creator]]: la //skill// de Anthropic para crear y evaluar //skills//.
  
Línea 40: Línea 40:
 ==== Qué carpetas tiene cada tipo ==== ==== Qué carpetas tiene cada tipo ====
  
-Las que suele tener cada [[cursos:sdd:09-skills-agentes-subagentes#lo_que_hacemos_nosotrostres_tipos|tipo de skill]]:+Las que suele tener una [[cursos:sdd:09-skills-agentes-subagentes#lo_que_hacemos_nosotrostres_tipos|skill y un agente]]:
  
-^ Carpeta ^ Skill de conocimiento (''k-'') ^ Skill que hace (''do-'') ^+^ Carpeta ^ Skill (''k-'') ^ Agente (''do-'') ^
 | ''SKILL.md'' | ✓ | ✓ | | ''SKILL.md'' | ✓ | ✓ |
 | ''<tema>.md'' | ✓ | | | ''<tema>.md'' | ✓ | |
Línea 53: Línea 53:
 | ''evals/'' | ✓ | ✓ | | ''evals/'' | ✓ | ✓ |
  
-La de conocimiento guarda lo que **se sabe**: temas, ejemplos y documentación. La que hace guarda lo que **se ejecuta**: subagentes, plantillas de lo que genera y scripts. Si una ''do-'' necesita las reglas, carga la ''k-''; no las copia.+La //skill// guarda lo que **se sabe**: temas, ejemplos y documentación. El agente guarda lo que **se ejecuta**: subagentes, plantillas de lo que genera y scripts. Si un agente necesita las reglas, carga la //skill//; no las copia.
  
 ==== Ejemplo: k-servicios ==== ==== Ejemplo: k-servicios ====
Línea 78: Línea 78:
 ==== Ejemplo: do-crear-servicio ==== ==== Ejemplo: do-crear-servicio ====
  
-La //skill// que crea un servicio a partir de un requisito de ''specs/''. Las reglas de los servicios no están aquí: las carga de ''k-servicios''.+El agente que crea un servicio a partir de un requisito de ''specs/''. Las reglas de los servicios no están aquí: las carga de ''k-servicios''.
  
 <sxh text;gutter:false> <sxh text;gutter:false>
Línea 106: Línea 106:
 | Cuándo la lee | Siempre: está en contexto junto con las de todas las //skills// | Solo cuando la //skill// ya está cargada | | Cuándo la lee | Siempre: está en contexto junto con las de todas las //skills// | Solo cuando la //skill// ya está cargada |
 | Para qué | Decidir si carga la //skill// | Saber qué es y cómo actuar | | Para qué | Decidir si carga la //skill// | Saber qué es y cómo actuar |
-| Qué dice | Qué es y **cuándo usarla**, con las palabras que escribiría el usuario | En las ''k-'', qué cubre y **quién la usa**. En las ''do-'', el **rol** y qué transforma en qué |+| Qué dice | Qué es y **cuándo usarla**, con las palabras que escribiría el usuario | En una //skill//, qué cubre y **quién la usa**. En un agente, el **rol** y qué transforma en qué |
  
 <sxh markdown;title:.claude/skills/do-crear-servicio/SKILL.md> <sxh markdown;title:.claude/skills/do-crear-servicio/SKILL.md>
Línea 145: Línea 145:
 ===== 4. El SKILL.md de cada tipo ===== ===== 4. El SKILL.md de cada tipo =====
  
-Cada uno de los [[cursos:sdd:09-skills-agentes-subagentes|tres tipos]] tiene su esqueleto: el ''SKILL.md'' de la ''k-'', el de la ''do-'' y el fichero de ''subagents/''.+Cada uno de los [[cursos:sdd:09-skills-agentes-subagentes|tres tipos]] tiene su esqueleto: el ''SKILL.md'' de la //skill//, el ''SKILL.md'' del agente y el fichero del subagente en ''subagents/''.
  
-==== Skill de conocimiento ====+==== El SKILL.md de una skill ====
  
 <sxh markdown;title:.claude/skills/k-servicios/SKILL.md> <sxh markdown;title:.claude/skills/k-servicios/SKILL.md>
Línea 186: Línea 186:
   * **Frase de entrada**: qué cubre y **quién la usa**, para que el modelo sepa si es la que busca.   * **Frase de entrada**: qué cubre y **quién la usa**, para que el modelo sepa si es la que busca.
  
-==== Skill de procedimiento ====+==== El SKILL.md de un agente ====
  
 Sigue la estructura de los comandos de [[https://github.com/github/spec-kit|Spec Kit]]: Sigue la estructura de los comandos de [[https://github.com/github/spec-kit|Spec Kit]]:
Línea 333: Línea 333:
 ==== El siguiente paso lo lanzas tú ==== ==== El siguiente paso lo lanzas tú ====
  
-Una //skill// de procedimiento **no lanza la siguiente** cuando decides tú cuándo se sigue: termina diciendo la orden exacta y para.+Un agente **no lanza el siguiente** cuando decides tú cuándo se sigue: termina diciendo la orden exacta y para.
  
 <sxh markdown> <sxh markdown>
Línea 342: Línea 342:
 ===== 5. Argumentos de entrada ===== ===== 5. Argumentos de entrada =====
  
-Lo que escribes detrás de ''/do-…'' llega entero en ''$ARGUMENTS'', el bloque de ''## Formato de entrada'' ([[#skill_de_procedimiento|ver la estructura]]). Si es un solo valor (''R-12''), basta con lo que ya hay. Pero muchas //skills// reciben varias piezas, como la ''/test'' de [[clase:daw:daw-proyecto:tema06#la_skill_do-testcrear_y_reparar|Despliegue y proyecto]]:+Lo que escribes detrás de ''/do-…'' llega entero en ''$ARGUMENTS'', el bloque de ''## Formato de entrada'' ([[#el_skillmd_de_un_agente|ver la estructura]]). Si es un solo valor (''R-12''), basta con lo que ya hay. Pero muchos agentes reciben varias piezas, como la ''/test'' de [[clase:daw:daw-proyecto:tema06#la_skill_do-testcrear_y_reparar|Despliegue y proyecto]]:
  
 <sxh bash> <sxh bash>
Línea 513: Línea 513:
 ==== Ejercicio 2 ==== ==== Ejercicio 2 ====
  
-Escribe la //skill// de conocimiento ''k-tests'' con las convenciones de los tests de tu proyecto: frontmatter, frase de entrada, tabla índice y las cinco secciones. Pon en ''templates/'' el esqueleto de una clase de test.+Escribe la //skill// ''k-tests'' con las convenciones de los tests de tu proyecto: frontmatter, frase de entrada, tabla índice y las cinco secciones. Pon en ''templates/'' el esqueleto de una clase de test.
  
 ==== Ejercicio 3 ==== ==== Ejercicio 3 ====
  
-Escribe la //skill// de procedimiento ''do-crear-test'', que recibe un identificador de requisito y escribe su test cargando ''k-tests''. Tiene que tener ''Formato de entrada'', ''Outline'' con sus ''STOP conditions'', una sección por fase y ''Quick Guidelines''. Pruébala con ''/do-crear-test R-3''.+Escribe el agente ''do-crear-test'', que recibe un identificador de requisito y escribe su test cargando ''k-tests''. Tiene que tener ''Formato de entrada'', ''Outline'' con sus ''STOP conditions'', una sección por fase y ''Quick Guidelines''. Pruébala con ''/do-crear-test R-3''.
  
  
cursos/sdd/10-creando-skills.1793951221.txt.gz · Última modificación: por claude