itda-rs/skills

Visualização de Transações Imobiliárias de Dubai (realty MCP)

O realty MCP fornece números, e esta skill define como desenhá-los. O desenho é apenas uma representação que não altera os valores.

Regras Absolutas

1. Use apenas os valores da resposta da ferramenta. Não recalcule medianas, médias, proporções ou totais. Apenas arredondamentos para exibição são permitidos.
   • Exceção: cálculos de coordenadas para desenho, como limites de eixos ou comprimentos de barras, são permitidos. Não escreva esses resultados como números.
2. Se o valor for nulo ou low_sample=1/true, desenhe como "amostra insuficiente": quadrado cinza (#46534e), barra vazia, linha quebrada. Não preencha ou interpole com valores de outros períodos ou regiões. O n permanece visível.
3. Todas as imagens devem ter legenda (escrita como texto HTML estático. Não use JS para desenhar — a fonte deve permanecer mesmo se a imagem falhar): Fonte: DLD Transações Reais (data.dubai, <source.sales_dataset>) · Data de referência <source.data_as_of> · n=<valor> · Período <filters.months> meses + "Não é um serviço oficial do governo de Dubai · Não é recomendação de investimento". Para mapas, inclua também attribution (Limites DM Communities · © Contribuidores do OpenStreetMap).
4. Separe empreendimentos em construção (offplan) dos concluídos (ready) nos desenhos. As ferramentas de mercado devem ser chamadas separadamente com registration="offplan" e registration="ready". Se houver motivo para desenhar com soma (registration=all), escreva "Soma de offplan e ready" no título e apresente os valores de offplan e ready juntos em uma tabela. Para tendências mensais (get_monthly_trend), que não são publicadas separadamente, escreva "Não publicado com distinção entre offplan e ready".
5. Não misture transações reais, aluguéis, camadas (taxas de condomínio, idade do imóvel, etc.) ou preços pedidos pelo comprador no mesmo eixo ou coluna. Se houver valor avaliado, desenhe separadamente como "valor avaliado".
6. Dimensões presentes em unavailable_dimensions devem ser escritas como "não publicado" e não substituídas por outros valores.
7. Proibido fazer declarações de investimento: em vez de "barato", "subvalorizado", "recomendado" ou "compre", diga apenas o valor publicado, como "mediana por m² baixa" ou "taxa de variação +x%". Rankings devem indicar claramente que são baseados no critério de ordenação definido pelo usuário.
8. Após desenhar, faça auto-verificação: confira um a um os números no gráfico/tabela com a resposta da ferramenta. Se houver divergência, corrija. Ao final da resposta, deixe uma linha: "Verificação de números: N correspondências".

Qual Ferramenta → Qual Desenho

• compare_places / get_market para vários locais → Gráfico de barras horizontais: barra = med_aed_sqm, linha fina = p25_aed_sqm~p75_aed_sqm, rótulo no final da barra n=…. Offplan/ready: use duas barras lado a lado, não cores diferentes.
• get_monthly_trend → Gráfico de linhas: meses com available=false ou nulo: linha quebrada + ponto cinza + "amostra insuficiente". Último mês com partial_days: linha tracejada + "mês parcial (dia 1 até data de referência)".
• screen_communities → Tabela primeiro, depois gráfico de barras. Abaixo da tabela, escreva o número de exclusões (excluded_low_sample, excluded_no_value).
• get_boundaries (+ valores do mesmo local) → Mapa coroplético SVG. Siga references/choropleth.md. Não use tiles, fontes ou CDNs externos.
• search_transactions → Tabela (ID da transação, data, área, preço, preço por m²). Máximo de 20 linhas. Não transfira os dados brutos na íntegra (proibido redistribuir).
• Resumo de uma página de visita → references/one-pager.md.

Cores (mesmas do mapa web realty.rs.itda.work)

• Sequencial (preço por m², rentabilidade): #dcebd7 → #a6c9ad → #598f76 → #23594b (4 intervalos). Amostra insuficiente / sem valor: #46534e.
• Taxa de variação (divergente): queda #386fa4 · estável #edf0e9 · alta #b64c39.
• Use os limites dos intervalos dos valores publicados na resposta (p25, mediana, p75, etc.). Se a resposta não os contiver, não calcule novos quartis; indique na legenda: "Intervalos: divisão do intervalo de valores deste desenho em 4 partes iguais (apenas para desenho)".

Formato

• claude.ai: HTML/SVG ou artefato React. Autocontido, sem recursos externos.
• Claude Code / Codex: um único arquivo HTML autocontido (SVG inline). Informe o caminho de salvamento.
• Apenas texto: tabela Markdown + nota de rodapé da fonte.
• Unidades: AED/m² por padrão; se necessário, adicione AED/sqft (med_aed_sqft) entre parênteses. Use "AED" em vez do símbolo da moeda.
• Não use animações de contagem (count-up), barras 3D ou eixo duplo.

Ao Passar para Outra IA (infográfico, etc.)

Inclua uma tabela Markdown com os números usados exatamente como foram publicados, com colunas Fonte · Data de referência · n. No final, escreva: "Baseado em registros de transações reais · Não são preços pedidos · Não é recomendação de investimento · Proibido alterar valores".