● Comunidad
AltimateAI
⚡ Instantáneo
data-engineering-skills
por AltimateAI · AltimateAI/data-engineering-skills
9 Skills de Claude Code para ingeniería analítica: 7 flujos de trabajo de dbt + 2 optimizadores de consultas de Snowflake. 53% de éxito en tareas reales de dbt, 84% en optimización de Snowflake.
Skills para el trabajo diario de la ingeniería analítica. Los Skills de dbt cubren crear, depurar, probar, documentar, migrar, refactorizar e implementar modelos incrementales. Los Skills de Snowflake encuentran consultas costosas y las optimizan por texto o por query_id. Filosofía: 'Lee antes de escribir. Construye después de escribir. Verifica tu salida.'
Por qué usarlo
Características clave
- 7 Skills de dbt — crear, depurar, probar, documentar, migrar, refactorizar, incrementales
- 2 Skills de Snowflake — encontrar consultas costosas, optimizar por texto/id
- Los Skills se activan automáticamente según el contexto de la tarea
- Evaluado: 53% de tasa de éxito en dbt en el mundo real, 84% en optimización de Snowflake
- Incluye seguimiento de dependencias y pasos de verificación de salida
Demo en vivo
Cómo se ve en la práctica
data-engineering-skill.replay
▶ listo
Casos de uso
Usos del mundo real: data-engineering-skills
Cuándo usarlo: dbt run acaba de fallar con un error críptico y no sabes si es esquema, linaje o SQL.
Flujo
-
Proporciona a Claude el error + modelo
Usa debugging-dbt-errors. Aquí está el stderr y models/marts/fct_orders.sql. Diagnostica la causa raíz — no adivines.✓ Copiado
→ Claude lee las referencias ascendentes, diagnostica en orden: esquema → linaje → SQL
-
Aplica la corrección y verifica
Aplica la corrección y ejecuta dbt build --select fct_orders+. Muéstrame los recuentos de filas antes y después.✓ Copiado
→ Ejecución limpia + verificación de recuentos de filas
Resultado: CI en verde más una nota de la causa raíz para que no se repita.
Errores comunes
- Corregir un síntoma aguas abajo cuando el error está aguas arriba — El Skill aplica un diagnóstico ascendente primero; no omitas el paso de linaje
Cuándo usarlo: Finanzas marcó la factura de Snowflake y necesitas reducirla sin romper los paneles.
Requisitos previos
- Rol de Snowflake con acceso a ACCOUNT_USAGE — Típicamente ACCOUNTADMIN, o un rol dedicado de costos
Flujo
-
Identifica los peores infractores
Usa finding-expensive-queries para listar las 20 principales consultas en los últimos 30 días por costo de crédito. Agrupa por app/usuario.✓ Copiado
→ Tabla clasificada con créditos, tiempo de ejecución, almacén
-
Optimiza cada una de las principales
Para la principal, usa optimizing-query-by-id <query_id>. Propón reescrituras con ahorros estimados.✓ Copiado
→ SQL reescrito + plan de explain antes/después
-
Valida e implementa
Ejecuta la reescritura en un almacén de prueba — confirma el mismo recuento de filas y forma antes de cambiar.✓ Copiado
→ Candidato seguro para intercambio
Resultado: Una lista priorizada de correcciones con ahorros medibles en $.
Errores comunes
- Las reescrituras cambian el recuento de filas silenciosamente — Siempre haz diff antes de implementar — el Skill lo aplica
Cuándo usarlo: Has heredado un almacén de CTEs anidados y quieres que sean modelos dbt documentados y probados.
Flujo
-
Apunta el Skill a la SQL de origen
Usa migrating-sql-to-dbt. Aquí está proc_monthly_revenue.sql. Conviértelo a modelos dbt con refs, documentación, y al menos 2 pruebas por modelo.✓ Copiado
→ Uno o más archivos .sql, schema.yml con documentación y pruebas
-
Construye y verifica
dbt construye los nuevos modelos y compara los recuentos de filas con la salida heredada.✓ Copiado
→ Los recuentos de filas coinciden dentro de la tolerancia
Resultado: La lógica heredada vive como modelos dbt comprobables.
Errores comunes
- Efectos secundarios ocultos en el procedimiento (UPDATEs) — El Skill marca los efectos secundarios — sepáralos, no los conviertas ciegamente
Cuándo usarlo: Un modelo diario ha crecido demasiado para actualización completa.
Flujo
-
Analiza el modelo
Usa developing-incremental-models en models/events.sql. Elige una estrategia (merge / insert_overwrite / delete+insert) y justifícala.✓ Copiado
→ Estrategia + unique_key + claves de partición / clúster recomendadas
-
Implementa y rellena el historial
Aplica la configuración incremental; describe un plan de relleno seguro.✓ Copiado
→ Modelo + pasos de relleno
Resultado: Ejecuciones diarias que terminan en minutos, no en horas.
Errores comunes
- unique_key obtiene duplicados en datos tardíos — Usa merge y pruébalo
Combinaciones
Combínalo con otros MCPs para multiplicar por 10
Aplica el mismo patrón optimize-by-id a consultas costosas de BigQuery
Adapta finding-expensive-queries para BigQuery INFORMATION_SCHEMA.JOBS y lista los 20 principales.✓ Copiado
data-engineering-skill +
github
Abre una PR por modelo migrado para que cada uno sea revisable
Para cada modelo migrado, abre una PR de GitHub con la salida de prueba dbt adjunta.✓ Copiado
Coste y límites
Lo que cuesta ejecutarlo
- Cuota de API
- Las consultas de Snowflake cuestan créditos como cualquier otra — las lecturas de ACCOUNT_USAGE son baratas
- Tokens por llamada
- 5–15k por invocación de Skill de dbt
- Monetario
- Skill gratuito
- Consejo
- Ejecuta finding-expensive-queries una vez a la semana, no en cada sesión
Seguridad
Permisos, secretos, alcance
Ámbitos mínimos: dbt: lectura + escritura en tu proyecto Snowflake: ACCOUNT_USAGE para Skills de costos
Almacenamiento de credenciales: dbt profiles.yml / par de claves de Snowflake en env; el Skill no almacena secretos
Salida de datos: Ninguno del Skill directamente
No conceder nunca: SYSADMIN a la sesión de Claude a menos que sea absolutamente necesario
Resolución de problemas
Errores comunes y soluciones
dbt compile tiene éxito, run falla con columna no encontrada
Linaje obsoleto — dbt deps + dbt clean + dbt build --select model+
finding-expensive-queries no devuelve nada
ACCOUNT_USAGE tiene ~45min de retraso; también confirma que el rol tiene SNOWFLAKE.ACCOUNT_USAGE
Verificar: SHOW GRANTS TO ROLE <role>
Alternativas
data-engineering-skills vs otros
| Alternativa | Cuándo usarla | Contrapartida |
| dbt Cloud IDE | Prefieres interfaz administrada sobre terminal | Sin Claude en el ciclo |
| SQL query optimizers (Select.dev, etc.) | Quieres planes de consulta visuales | Herramienta separada, contexto separado |