How do I install the Waze skill?

Run npx skillmds@latest add dvcrn/waze in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Waze?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Waze by dvcrn — Agent Skill

Name: Waze
Rating: 4.2 (5 reviews)
Author: dvcrn

Waze

Gera links de navegação do Waze para qualquer destino: endereços, nomes de estabelecimentos, locais de compromissos na agenda. Use sempre que o usuário mencionar um destino, pedir rota, querer saber como chegar a algum lugar, ou quando um evento da agenda tiver um local definido — nesse caso inclua o link automaticamente no briefing, sem precisar ser solicitado. Quando o destino for vago (nome de empresa, tipo de estabelecimento, "posto mais próximo"), busca o local mais próximo da cidade do usuário antes de gerar o link — nunca use um endereço de outra cidade.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Waze Navigation Skill

O que faz

Gera links de navegação do Waze que, ao serem tocados no celular, abrem o app diretamente com a rota pronta. Funciona via deep links públicos do Waze — sem necessidade de API key.

Formato do link

https://waze.com/ul?q=ENDEREÇO_CODIFICADO&navigate=yes

O endereço deve estar URL-encoded. Use Python quando disponível:

from urllib.parse import quote
address = "Av. Jerônimo Monteiro, 1000, Vitória, ES, Brasil"
link = f"https://waze.com/ul?q={quote(address)}&navigate=yes"
print(link)

Fluxo de uso

Passo 1 — Descobrir a localização do usuário

Antes de qualquer coisa, descubra em qual cidade o usuário está. Procure em:

USER.md no workspace ativo
SOUL.md ou qualquer arquivo de perfil do workspace

Se não encontrar, pergunte. A cidade é essencial para buscar estabelecimentos próximos — nunca assuma uma localização genérica ou use a primeira cidade que aparecer num resultado de busca.

Passo 2 — Classificar o destino

Destino específico (endereço completo, CEP, coordenadas): → Pule direto para o Passo 4.

Destino vago (nome de empresa, categoria, "o mais próximo"): → Siga para o Passo 3 primeiro.

Passo 3 — Buscar o local mais próximo (destinos vagos)

Use Tavily para buscar: "NOME DO LOCAL" + CIDADE + ESTADO

Extraia o endereço completo do resultado (rua, número, bairro, cidade, estado). Se houver mais de uma opção, escolha a geograficamente mais próxima do usuário, ou apresente as opções para ele escolher.

Exemplo: usuário em Vitória/ES pede "Leroy Merlin" → busca "Leroy Merlin" Vitória ES → endereço encontrado: "Av. Fernando Ferrari, 2600, Goiabeiras, Vitória, ES" → segue para o Passo 4.

Passo 4 — Gerar o link

URL-encode o endereço e monte o link. Sempre inclua o estado e país no endereço para evitar ambiguidade (cidades com nomes comuns podem existir em outros países).

Passo 5 — Apresentar o link

Sempre use o formato markdown [texto](url) para o link — nunca exponha a URL crua. Isso faz o link aparecer como texto clicável no Telegram, muito mais limpo para o usuário.

Em conversa normal:

📍 Leroy Merlin — Av. Fernando Ferrari, 2600, Goiabeiras, Vitória, ES
🗺️ [Abrir no Waze](https://waze.com/ul?q=Av.+Fernando+Ferrari%2C+2600%2C+Vit%C3%B3ria%2C+ES%2C+Brasil&navigate=yes)

No briefing matinal (quando o evento tem um local):

📅 *AGENDA DE HOJE*
09:00 — Reunião com Fornecedor
📍 Leroy Merlin — Av. Fernando Ferrari, 2600, Vitória, ES
🗺️ [Abrir no Waze](https://waze.com/ul?q=Av.+Fernando+Ferrari%2C+2600%2C+Vit%C3%B3ria%2C+ES%2C+Brasil&navigate=yes)

O resultado no Telegram é um link azul clicável com o texto "Abrir no Waze" — sem URL visível.

Integração com Briefing Matinal

Quando estiver gerando um briefing e um evento da agenda tiver um campo de localização preenchido, inclua o link do Waze automaticamente logo abaixo do evento — sem precisar ser solicitado pelo usuário. Isso é especialmente útil para quem consulta o briefing no celular antes de sair de casa.

Se o local do evento for o nome de um estabelecimento (não um endereço completo), aplique o Passo 3 para descobrir o endereço real antes de gerar o link.

Observações

O link funciona em qualquer dispositivo com Waze instalado. Sem o app, abre o Waze no navegador.
Sempre inclua estado e país no endereço para evitar ambiguidade.
Vitória, ES, Brasil ≠ Victoria, Austrália ≠ Victoria, Canadá — seja específico.
Se o usuário pedir "posto mais próximo" ou similar sem fornecer contexto de rota, use a cidade base do perfil dele como ponto de partida da busca.

---name: wazedescription: Gera links de navegação do Waze para qualquer destino: endereços, nomes de estabelecimentos, locais de compromissos na agenda. Use sempre que o usuário mencionar um destino, pedir rota, querer saber como chegar a algum lugar, ou quando um evento da agenda tiver um local definido — nesse caso inclua o link automaticamente no briefing, sem precisar ser solicitado. Quando o destino for vago (nome de empresa, tipo de estabelecimento, "posto mais próximo"), busca o local mais próximo da cidade do usuário antes de gerar o link — nunca use um endereço de outra cidade.---# Waze Navigation Skill## O que fazGera links de navegação do Waze que, ao serem tocados no celular, abrem o appdiretamente com a rota pronta. Funciona via deep links públicos do Waze — semnecessidade de API key.## Formato do link```https://waze.com/ul?q=ENDEREÇO_CODIFICADO&navigate=yes```O endereço deve estar URL-encoded. Use Python quando disponível:```pythonfrom urllib.parse import quoteaddress = "Av. Jerônimo Monteiro, 1000, Vitória, ES, Brasil"link = f"https://waze.com/ul?q={quote(address)}&navigate=yes"print(link)```---## Fluxo de uso### Passo 1 — Descobrir a localização do usuárioAntes de qualquer coisa, descubra em qual cidade o usuário está. Procure em:- `USER.md` no workspace ativo- `SOUL.md` ou qualquer arquivo de perfil do workspaceSe não encontrar, pergunte. A cidade é essencial para buscar estabelecimentospróximos — nunca assuma uma localização genérica ou use a primeira cidade queaparecer num resultado de busca.### Passo 2 — Classificar o destino**Destino específico** (endereço completo, CEP, coordenadas):→ Pule direto para o Passo 4.**Destino vago** (nome de empresa, categoria, "o mais próximo"):→ Siga para o Passo 3 primeiro.### Passo 3 — Buscar o local mais próximo (destinos vagos)Use Tavily para buscar: `"NOME DO LOCAL" + CIDADE + ESTADO`Extraia o **endereço completo** do resultado (rua, número, bairro, cidade, estado).Se houver mais de uma opção, escolha a geograficamente mais próxima do usuário,ou apresente as opções para ele escolher.> Exemplo: usuário em Vitória/ES pede "Leroy Merlin" →> busca `"Leroy Merlin" Vitória ES` →> endereço encontrado: "Av. Fernando Ferrari, 2600, Goiabeiras, Vitória, ES" →> segue para o Passo 4.### Passo 4 — Gerar o linkURL-encode o endereço e monte o link. Sempre inclua o estado e país no endereçopara evitar ambiguidade (cidades com nomes comuns podem existir em outros países).### Passo 5 — Apresentar o linkSempre use o formato markdown `[texto](url)` para o link — nunca exponha a URL crua.Isso faz o link aparecer como texto clicável no Telegram, muito mais limpo para o usuário.**Em conversa normal:**```📍 Leroy Merlin — Av. Fernando Ferrari, 2600, Goiabeiras, Vitória, ES🗺️ [Abrir no Waze](https://waze.com/ul?q=Av.+Fernando+Ferrari%2C+2600%2C+Vit%C3%B3ria%2C+ES%2C+Brasil&navigate=yes)```**No briefing matinal** (quando o evento tem um local):```📅 *AGENDA DE HOJE*09:00 — Reunião com Fornecedor📍 Leroy Merlin — Av. Fernando Ferrari, 2600, Vitória, ES🗺️ [Abrir no Waze](https://waze.com/ul?q=Av.+Fernando+Ferrari%2C+2600%2C+Vit%C3%B3ria%2C+ES%2C+Brasil&navigate=yes)```O resultado no Telegram é um link azul clicável com o texto "Abrir no Waze" — sem URL visível.---## Integração com Briefing MatinalQuando estiver gerando um briefing e um evento da agenda tiver um campo delocalização preenchido, inclua o link do Waze automaticamente logo abaixo doevento — sem precisar ser solicitado pelo usuário. Isso é especialmente útilpara quem consulta o briefing no celular antes de sair de casa.Se o local do evento for o nome de um estabelecimento (não um endereço completo),aplique o Passo 3 para descobrir o endereço real antes de gerar o link.---## Observações- O link funciona em qualquer dispositivo com Waze instalado. Sem o app, abre o Waze no navegador.- Sempre inclua estado e país no endereço para evitar ambiguidade.- Vitória, ES, Brasil ≠ Victoria, Austrália ≠ Victoria, Canadá — seja específico.- Se o usuário pedir "posto mais próximo" ou similar sem fornecer contexto de rota, use a cidade base do perfil dele como ponto de partida da busca.

Frequently asked questions