itda-rs/skills

Visualización de transacciones reales de Dubái (realty MCP)

realty MCP proporciona números, y esta habilidad define cómo dibujarlos. Los gráficos son solo una representación que no altera los valores.

Reglas absolutas

1. Usar únicamente los valores de la respuesta de la herramienta. No calcular nuevas medias, medianas, proporciones o sumas. Solo se permite redondeo para visualización.
   • Excepción: se pueden realizar cálculos de coordenadas para dibujar (como rangos de ejes, longitudes de barras). No escribir esos resultados como números.
2. Si un valor es null o low_sample=1/true, dibujar como "Muestra insuficiente": recuadro gris (#46534e), barra vacía, línea discontinua. No rellenar ni interpolar con valores de otros periodos o áreas. Mostrar n tal cual.
3. Todas las figuras deben incluir un pie de foto (escrito como HTML estático, no con JavaScript — la fuente debe permanecer aunque la figura falle): Fuente: DLD Transacciones Reales (data.dubai, <source.sales_dataset>) · Fecha de referencia <source.data_as_of> · n=<valor> · Periodo <filters.months> meses + "No es un servicio oficial del Gobierno de Dubái · No constituye consejo de inversión". En mapas, añadir attribution (Límites de DM Communities · © Colaboradores de OpenStreetMap).
4. Separar las propiedades en planificación (offplan) de las terminadas (ready) en los gráficos. Las herramientas de precios de mercado se invocan por separado con registration="offplan" y registration="ready". Si hay razón para mostrar la suma (registration=all), indicar en el título "Suma de planificación y terminado" y presentar una tabla con los valores de planificación y terminado del mismo lugar. Para tendencias mensuales (get_monthly_trend) que no se publican desglosadas, indicar "No se publica desglosado por planificación/terminado".
5. No mezclar en un mismo eje o columna: transacciones reales, alquileres, capas (gastos de comunidad, antigüedad, etc.) y precios de oferta. Si aparece una tasación, dibujarla por separado como "Tasación".
6. Las dimensiones que aparecen en unavailable_dimensions deben etiquetarse como "No publicado" y no ser reemplazadas por otros valores.
7. Prohibido expresar juicios de inversión: en lugar de "barato", "infravalorado", "recomendado", "cómalo", decir "La mediana por m² es baja", "Tasa de cambio +x%" como valor publicado. Si se muestran rankings, indicar que son según el criterio de ordenación definido por el usuario.
8. Después de dibujar, autoverificación: comparar uno por uno los números mostrados en el gráfico/tabla con la respuesta de la herramienta; si difieren, corregirlos. Al final de la respuesta, dejar una línea: "Números verificados: N coincidencias".

Qué herramienta → Qué gráfico

• compare_places / get_market para varios lugares → Gráfico de barras horizontal: barra = med_aed_sqm, línea fina = p25_aed_sqm~p75_aed_sqm, etiqueta al final de la barra n=…. Para planificación/terminado, usar dos barras adyacentes en lugar de colores diferentes.
• get_monthly_trend → Gráfico de líneas: los meses con available=false o null se muestran con línea discontinua y un punto gris + "Muestra insuficiente". El último mes con partial_days se muestra con línea punteada + "Mes parcial (día 1 - fecha de referencia)".
• screen_communities → Primero tabla, luego barras. Escribir el número de exclusiones (excluded_low_sample, excluded_no_value) debajo de la tabla.
• get_boundaries (+ valores del mismo lugar) → Mapa coroplético SVG. Seguir references/choropleth.md. No usar tiles, fuentes ni CDN externos.
• search_transactions → Tabla (ID de transacción, fecha, área, precio, precio por m²). Máximo 20 filas. No copiar los datos originales completos (prohibida su redistribución).
• Resumen de una página para inspección de campo → references/one-pager.md.

Colores (igual que en el mapa web realty.rs.itda.work)

• Secuencial (precio unitario, rentabilidad): #dcebd7 → #a6c9ad → #598f76 → #23594b (4 intervalos). Muestra insuficiente/sin valor: #46534e.
• Tasa de cambio (divergente): descenso #386fa4 · estable #edf0e9 · aumento #b64c39.
• Los límites de los intervalos se toman de los valores publicados en la respuesta (p25, mediana, p75, etc.). Si la respuesta no los incluye, no calcular cuartiles nuevos; indicar en el pie de foto: "Intervalos: rango de valores de esta figura dividido en 4 partes iguales (solo para dibujo)".

Formato

• claude.ai: HTML/SVG o artefacto React. Autocontenido, sin recursos externos.
• Claude Code / Codex: un único archivo HTML autocontenido (SVG en línea). Indicar la ruta de guardado.
• Entornos solo texto: tabla Markdown + nota al pie con la fuente.
• Unidades: AED/m² por defecto; si es necesario, añadir AED/pie² (med_aed_sqft) entre paréntesis. Usar "AED" en lugar del símbolo de moneda.
• No usar efectos de aparición de números (count-up), barras 3D ni ejes duales.

Al pasar a otra IA (infografía, etc.)

Incluir una tabla Markdown con los números exactos utilizados, añadiendo las columnas Fuente · Fecha de referencia · n, y al final escribir: "Basado en registros de transacciones reales · No son precios de oferta · No constituye consejo de inversión · Prohibido modificar los valores".