Guía de lectura localizada
writing-skillsFinalidad, uso y origen
Úselo al crear nuevas habilidades, editar habilidades existentes o verificar que las habilidades funcionen antes de su implementación.
Fuente recuperada:
- Repositorio de origen
- obra/superpowers
- SKILL.md
skills/writing-skills/SKILL.md- Estrellas del repositorio
- 309,479
- Actualización del repositorio
- 2026-10-30
- Clasificación de habilidades
- Flujo de trabajo del agente
- Última recopilación
Licencia: MIT
Los extractos del flujo de trabajo son guías de lectura, no instrucciones ejecutables de Codez. No se utilizó ninguna habilidad de terceros para generar esta página.
Los siguientes fragmentos sobre el propósito y el flujo de trabajo son material preliminar, organizado y traducido para su lectura. Son distintos del análisis editorial de Codez, que se presenta por separado.
Lo que hace esta habilidad
Úselo al crear nuevas habilidades, editar habilidades existentes o verificar que las habilidades funcionen antes de su implementación.
Cómo funciona el flujo de trabajo ascendente
Flujo de trabajo de descubrimiento
Cómo los futuros agentes encuentran tu habilidad: Encuentra un problema ("las pruebas son inestables") Busca habilidades (busca en las descripciones, explora las categorías) Encuentra la HABILIDAD (la descripción coincide)
Paso río arriba · L388 ↗Descripción general
Las habilidades de escritura son Desarrollo Dirigido por Pruebas aplicado a la documentación de procesos. Las habilidades personales se encuentran en el directorio de habilidades de su entorno de ejecución (~/.claude/skills/(sobre el Código Claude) — vercodex-tools.mdogemini-tools.mdpara la ruta en esos entornos de ejecución. Codex, Copilot CLI y Gemini CLI también reconocen~/.agents/skills/Como un alias entre entornos de ejecución. Escribes casos de prueba (escenarios de presión con subagentes), observas cómo fallan (comportamiento de referencia), escribes la habilidad (documentación), observas cómo se ejecutan las pruebas (los agentes cumplen) y refactorizas (corriges las vulnerabilidades). Principio fundamental: si no has visto fallar a un agente sin la habilidad, no sabes si la habilidad enseña lo correcto.
Cuándo crear una habilidad
La técnica no te resultó intuitivamente obvia. Volverías a consultarla en varios proyectos. El patrón se aplica de forma general (no es específico de un proyecto). Otros se beneficiarían.
Paso río arriba · L47 ↗skills/
skill-name/
SKILL.md # Main reference (required)
supporting-file.* # Only if neededRequisitos y configuración
Habilidades para hacer cumplir la disciplina (rules/requirements)
Ejemplos: TDD, verificación antes de la finalización, diseño antes de la codificación. Preguntas académicas: ¿Entienden las reglas?
Paso río arriba · L188 ↗Límites y controles de calidad
No se seleccionó ningún pasaje con límites específicos en este archivo. Esto no significa que la habilidad sea segura para cualquier entrada o entorno. Revise el código fuente completo y valide su propio resultado.
Comience con una prueba segura.
- Verifique el host compatible y las instrucciones de instalación del repositorio. Mantenga juntos el directorio Skill y sus scripts, recursos y documentación a los que hace referencia;SKILL.mdsolo puede omitir dependencias.
- Proporcione al agente sus datos reales, el resultado deseado y los criterios de aceptación. La sintaxis de invocación y las herramientas disponibles dependen del sistema anfitrión; este sitio no presupone un comando de instalación universal.
- Pruebe el flujo de trabajo original en un proyecto desechable o en una copia. Revise las operaciones que modifican archivos, servicios remotos o recursos facturables antes de autorizarlas.
- Valide el resultado comparándolo con los controles de calidad de origen y sus propios requisitos. Un activador exitoso o un alto número de estrellas en el repositorio no garantizan un resultado correcto.
Lea más en la fuente
- Descripción general
- ¿Qué es una habilidad?
- Mapeo de habilidades mediante TDD
- Cuándo crear una habilidad
- Técnica
- Patrón
- Referencia
- Estructura de directorios
- EscribiendoSKILL.md
- Diagramas de flujo
- Ejemplos de código
- Habilidad autónoma
- Habilidad con herramientas reutilizables
- Habilidad con referencias importantes
- La Ley de Hierro (igual que TDD)
- Evaluando todo tipo de habilidades
- Habilidades para hacer cumplir la disciplina (rules/requirements)
- Técnicas y habilidades (guías prácticas)
- Habilidades de patrones (modelos mentales)
- Habilidades de referencia (documentation/APIs)
- Justificaciones comunes para omitir las pruebas
- Relaciona el formulario con el fallo
- Protección contra la racionalización
- RED-GREEN-REFACTOR para Habilidades
- ROJO: Escribir prueba fallida (línea base)
- VERDE: Escribir Habilidad mínima
- REFACTOR: Cerrar lagunas
- Redacción de micropruebas antes de los escenarios completos
- ❌ Ejemplo narrativo
- ❌ Dilución multilingüe
Habilidades relacionadas
Traducción y alcance
Esta guía de lectura selecciona pasajes de la sección fijada en la parte superior.SKILL.mdLa traducción es asistida. No se trata de un manual completo ni garantiza la compatibilidad. Lea el original y los archivos a los que hace referencia antes de usarlo.
Esta introducción hace referencia a la versión fijada a continuación; la actividad actual del repositorio y la hora de recopilación se muestran por separado.
- Fuente fijada
- Lee el original ↗
- Fuente recuperada
- Confirmación de origen
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- Fuente SHA-256
8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe