Herramientas de usuario

Herramientas del sitio


cursos:sdd:09-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
Próxima revisión
Revisión previa
cursos:sdd:09-creando-skills [2026/11/05 22:22] – ↷ El nombre de la página cambió de cursos:sdd:08-creando-skills a cursos:sdd:09-creando-skills claudecursos:sdd:09-creando-skills [2026/11/05 22:39] (actual) – Quitados enlaces a secciones del tema 8 que ya no existen claude
Línea 1: Línea 1:
-====== 8. Estructura de un skill ======+====== 9. Estructura de un skill ======
  
-Qué es una //skill//, su frontmatter y cómo se redacta están en [[cursos:sdd:07-skills-agentes|Skills y agentes]]. Aquí, la estructura completa de una //skill//: qué carpetas y ficheros puede tener, qué secciones lleva el ''SKILL.md'' según el tipo. Cómo se prueba está en [[cursos:sdd:19-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]]. Aquí, la estructura completa de una //skill//: qué carpetas y ficheros puede tener, qué secciones lleva el ''SKILL.md'' según el tipo. Cómo se prueba está en [[cursos:sdd:20-evaluacion-skills|Evaluación de skills]]. 
 Más información: Más información:
  
Línea 26: Línea 26:
   * **Las que hacen cosas**: ejecutan un proceso por fases (crear un servicio, revisar un PR). Las lanzas tú con ''/''.   * **Las que hacen cosas**: ejecutan un proceso por fases (crear un servicio, revisar un PR). Las lanzas tú con ''/''.
  
-Lo que hace una //skill// que hace cosas es, en el fondo, el trabajo de un [[cursos:sdd:07-skills-agentes#agente_principal_y_subagentes|agente]]. Pero crear un //skill// que actúa de agente, no como agente tiene las siguientes ventajas:+Lo que hace una //skill// que hace cosas es, en el fondo, el trabajo de un [[cursos:sdd:08-skills-agentes#agente_principal_y_subagentes|agente]]. Pero crear un //skill// que actúa de agente, no como agente tiene las siguientes ventajas:
  
   * **Un agente no tiene carpeta propia.** Es un único fichero en ''.claude/agents/'', así que sus plantillas, scripts o ejemplos no pueden ir junto a él. Una //skill// es una carpeta y lleva dentro todo lo que usa ([[#estructura_de_carpetas_y_ficheros|ver la estructura]]).   * **Un agente no tiene carpeta propia.** Es un único fichero en ''.claude/agents/'', así que sus plantillas, scripts o ejemplos no pueden ir junto a él. Una //skill// es una carpeta y lleva dentro todo lo que usa ([[#estructura_de_carpetas_y_ficheros|ver la estructura]]).
Línea 69: Línea 69:
  
 ==== Qué hay en cada carpeta ==== ==== Qué hay en cada carpeta ====
- 
-Qué hace cada pieza está en [[cursos:sdd:07-skills-agentes#la_carpeta|Skills y agentes]]: 
  
 ^ Carpeta o fichero ^ Contiene ^ Ejemplo ^ ^ Carpeta o fichero ^ Contiene ^ Ejemplo ^
Línea 81: Línea 79:
 | ''scripts/'' | Script en bash o python , etc que ejecuta el skill para hacer su tarea. Si algo se puede hacer con un script en vez de usar más tokens, es mejor crear un script. | sin-transaccion.py | | ''scripts/'' | Script en bash o python , etc que ejecuta el skill para hacer su tarea. Si algo se puede hacer con un script en vez de usar más tokens, es mejor crear un script. | sin-transaccion.py |
 | ''assets/'' | Esquemas, XSD, imágenes, etc | errores.schema.json | | ''assets/'' | Esquemas, XSD, imágenes, etc | errores.schema.json |
-| ''evals/'' | Dentro hay carpetas con los test unitarios para probar el skill ([[cursos:sdd:19-evaluacion-skills|cómo se hacen]]) | update-sin-filtrar/ |+| ''evals/'' | Dentro hay carpetas con los test unitarios para probar el skill ([[cursos:sdd:20-evaluacion-skills|cómo se hacen]]) | update-sin-filtrar/ |
  
  
Línea 147: Línea 145:
 ==== La description y la frase de entrada ==== ==== La description y la frase de entrada ====
  
-La ''description'' del frontmatter ([[cursos:sdd:07-skills-agentes#el_frontmatter|cómo es]]) y la frase que va justo después del H1 se parecen, pero el modelo las lee en momentos distintos:+La ''description'' del frontmatter ([[cursos:sdd:08-skills-agentes#el_frontmatter|cómo es]]) y la frase que va justo después del H1 se parecen, pero el modelo las lee en momentos distintos:
  
 ^ ^ ''description'' ^ Frase de entrada ^ ^ ^ ''description'' ^ Frase de entrada ^
Línea 176: Línea 174:
 ===== 5. El índice ===== ===== 5. El índice =====
  
-La tabla índice del ''SKILL.md'' ([[cursos:sdd:07-skills-agentes#el_skillmd|cómo es]]) va **justo después de la frase de entrada**, antes de cualquier otra sección, y tiene **todos** los ficheros:+La tabla índice del ''SKILL.md'' ([[cursos:sdd:08-skills-agentes#el_skillmd|cómo es]]) va **justo después de la frase de entrada**, antes de cualquier otra sección, y tiene **todos** los ficheros:
  
   * **Un fichero que no está en la tabla es un huérfano**: no lo carga nadie.   * **Un fichero que no está en la tabla es un huérfano**: no lo carga nadie.
Línea 319: Línea 317:
 | ''**LIMIT**'' | Un número máximo: preguntas, vueltas, ficheros | | ''**LIMIT**'' | Un número máximo: preguntas, vueltas, ficheros |
  
-Solo en lo que de verdad no puede fallar ([[cursos:sdd:07-skills-agentes#como_se_redacta|cómo se redacta]]). El resto, en imperativo y en segunda persona: «lee», «valida», no «podrías leer».+Solo en lo que de verdad no puede fallar. El resto, en imperativo y en segunda persona: «lee», «valida», no «podrías leer».
  
 ==== Si genera un fichero: checklist y vueltas ==== ==== Si genera un fichero: checklist y vueltas ====
cursos/sdd/09-creando-skills.1793913744.txt.gz · Última modificación: por claude