typescript-magician
por mcollinatypescript-magician ayuda a resolver problemas difíciles de TypeScript: diseño profundo de genéricos, limpieza de tipado estricto, errores del compilador, type guards y transformaciones avanzadas de tipos. Úsalo cuando necesites generación de código con seguridad de tipos, eliminar `any`, trabajar con `infer`, tipos condicionales, tipos mapeados, template literal types, branded types o utility types.
Este skill obtiene 84/100, así que es un buen candidato para el directorio: se activa con claridad para tareas de TypeScript, ofrece instrucciones de flujo de trabajo concretas y da a los usuarios evidencia suficiente para decidir su instalación. Quienes consulten el directorio pueden esperar un asistente práctico para TypeScript avanzado, no un skill genérico y amplio.
- Activación muy clara: la descripción menciona casos de uso concretos como genéricos, inferencia de tipos, type guards, eliminación de `any`, `infer`, tipos condicionales, tipos mapeados y errores del compilador.
- El flujo de trabajo operativo está bien definido: indica ejecutar `tsc --noEmit`, diagnosticar la causa raíz, aplicar correcciones seguras para los tipos y volver a compilar.
- Buen nivel de profundidad de apoyo: el repositorio incluye 14 archivos de reglas enfocadas en temas avanzados de TypeScript, como patrones builder, inferencia profunda, template literal types y diagnóstico de errores.
- No se proporciona un comando de instalación en SKILL.md, así que los usuarios quizá tengan que inferir la configuración o el uso en lugar de seguir una ruta de instalación ya preparada.
- La evidencia visible es más documental que orientada a herramientas; no hay scripts ni archivos de referencia que refuercen o automaticen el flujo de trabajo.
Descripción general de la skill typescript-magician
Qué hace typescript-magician
La skill typescript-magician te ayuda a resolver problemas difíciles de TypeScript que los prompts habituales manejan mal: diseño de genéricos complejos, limpieza de tipado estricto, errores del compilador, type guards y transformaciones avanzadas de tipos. Resulta especialmente útil cuando la tarea real no es “escribir algo en TS”, sino “hacer que esta API o esta base de código sea type-safe sin romper las llamadas existentes”.
Casos de uso ideales
Usa la skill typescript-magician cuando necesites ayuda con la eliminación de any, infer, extends, conditional types, mapped types, template literal types, branded or opaque types, utility types o fallos de inferencia. Encaja muy bien en tareas de generación de código en las que la salida debe ser a la vez cómoda de usar y correcta en tipos, no solo válida sintácticamente.
Por qué esta skill es distinta
Esta skill está organizada en torno a la reparación “compiler-first”: capturar la salida de tsc, identificar el problema de tipos de raíz, aplicar una corrección precisa y luego verificar que compila de nuevo. Eso hace que typescript-magician sea más práctico que un prompt genérico de TypeScript para equipos que valoran la seguridad, la confianza al refactorizar y el comportamiento de tipos avanzado.
Cómo usar la skill typescript-magician
Instálala y actívala
Usa el flujo typescript-magician install de tu gestor de skills y después apunta al repositorio donde está el problema de TypeScript. El comando de instalación de referencia en la skill original es:
npx skills add mcollina/skills --skill typescript-magician
Si tu entorno usa otro instalador o una disposición de workspace distinta, mantén la misma intención: carga la skill antes de pedirle que modifique tipos o diagnostique un error del compilador.
Dale una tarea con forma de error de compilación
El mejor typescript-magician usage empieza con un fallo concreto o un objetivo acotado. Buenos insumos son:
- un bloque completo de error de
tsc --noEmit - la función, tipo o archivo que está fallando
- el comportamiento deseado en tiempo de ejecución y el comportamiento deseado en tipos
- cualquier restricción como “evita
as any”, “preserva la API pública” o “soporta TS 5.x”
Un prompt sólido sería:
“Corrige este error de tsc --noEmit sin cambiar el comportamiento en tiempo de ejecución. Conserva la API pública, elimina any y mantén la inferencia para los consumidores.”
Lee primero estos archivos
Para un typescript-magician guide práctico, empieza por SKILL.md y después revisa rules/ buscando el patrón más cercano a tu problema. Los puntos de entrada más útiles suelen ser:
rules/error-diagnosis.mdrules/generics-basics.mdrules/conditional-types.mdrules/type-narrowing.mdrules/utility-types.md
Si tu problema tiene que ver con valores en tiempo de ejecución que alimentan tipos, revisa también rules/as-const-typeof.md y rules/deep-inference.md.
Flujo de trabajo que da mejores resultados
Primero captura el error exacto, luego reduce el problema al tipo o función mínima que falla y después pide una corrección type-safe que mantenga funcionando las llamadas existentes. Para typescript-magician for Code Generation, incluye desde el principio la forma objetivo: genéricos esperados, entrada aceptada, tipo devuelto y cualquier caso límite como uniones, valores nulos, indexación de arrays u overloads.
Preguntas frecuentes sobre la skill typescript-magician
¿typescript-magician es solo para errores del compilador?
No. La skill typescript-magician también es útil para diseñar tipos para código nuevo, sobre todo cuando necesitas inferencia avanzada o utility types reutilizables. Su mayor valor aparece cuando los tipos forman parte del contrato del producto, no solo son anotaciones.
¿Cuándo no debería usarla?
Evita typescript-magician si la tarea es sobre todo lógica de ejecución, formateo o código de aplicación sin complejidad del sistema de tipos. También resulta menos útil si no puedes aportar un error real de TypeScript, contexto del archivo o criterios de aceptación.
¿Es apta para principiantes?
Sí, si le das un problema acotado y le pides que explique el razonamiento de tipos en lenguaje claro. Resulta menos amigable para principiantes cuando la tarea depende de conditional types avanzados o reglas de inferencia sin código de ejemplo.
¿En qué se diferencia de un prompt normal de TypeScript?
Un prompt normal suele producir una corrección plausible; typescript-magician está optimizada para dar una solución que pase tsc, conserve la inferencia en las llamadas y use la característica correcta de TypeScript para cada caso. Eso importa especialmente en librerías compartidas, SDKs y refactors donde una respuesta que “parece correcta” no basta.
Cómo mejorar la skill typescript-magician
Aporta el ejemplo mínimo que falla
La mayor mejora de calidad llega al reducir el problema al fragmento mínimo reproducible de TypeScript. Incluye el tipo, la firma de la función, la llamada que falla y el error del compilador. Cuanto más pequeño sea el input, más probable es que la skill typescript-magician elija la restricción, overload o conditional type adecuados.
Explica las restricciones que importan
Dile a la skill qué debe preservar: el comportamiento en ejecución, la forma de la API, la compatibilidad hacia atrás, el modo estricto o la compatibilidad con versiones antiguas de TS. Si quieres typescript-magician for Code Generation, especifica también si la salida debe priorizar helpers explícitos, tipos de retorno inferidos o utility types genéricos reutilizables.
Vigila los fallos más comunes
Los fallos más habituales son correcciones demasiado amplias que esconden errores, atajos basados en any y definiciones de tipos que funcionan para un ejemplo pero se rompen con uniones, arrays o propiedades opcionales. Si la primera respuesta queda demasiado laxa, pide una versión más estricta e incluye uno o dos contraejemplos que sigan compilando.
Itera con llamadas reales
Después de la primera corrección, pruébala con usos representativos: una entrada union, una entrada nullable, un array o tuple y una entrada “mala” que debería fallar. Devuelve esos resultados al prompt de typescript-magician guide para que la siguiente pasada ajuste la inferencia en lugar de limitarse a parchear el error original.