briefing-diario_skill

Overview

This skill generates a concise visual daily briefing dashboard with local context: location, current weather and astronomy, precipitation chance, UV index and safety guidance, currency quotes, and holiday status. It runs on request using the trigger words "briefing diario" or "briefing" and returns a ready-to-display ASCII-aligned dashboard that fits into chat or terminal workflows. The briefing is designed to be localized (default: Belo Horizonte) and time-zone aware.

How this skill works

The skill determines the user's city (default coordinates provided) and queries free APIs for current weather/astronomy (Open-Meteo), currency rates (AwesomeAPI), and national holidays (Nager.Date). It maps Open-Meteo fields into human-friendly labels, translates WMO weather codes into Portuguese descriptions, calculates current rain probability and UV risk level, and formats the results into a fixed ASCII dashboard template. If an API fails, it inserts friendly fallback messages so the dashboard remains readable.

When to use it

• Start of day summary to plan commute, dressing, and sun protection.
• Before leaving home to check rain probability and wind.
• When you need a quick snapshot of currency rates and holiday status.
• Embedding into morning automation scripts or display panels.
• Trigger with voice or chat using "briefing diario" or "briefing".

Best practices

• Call the skill at the moment you need accurate current-hour precipitation probability.
• Keep a fallback location configured if geolocation permission is unavailable.
• Cache currency responses briefly (minutes) to reduce API calls while keeping rates fresh.
• Surface error-friendly placeholders when external APIs are unavailable to avoid breaking templates.
• Use the dashboard as a single-line ASCII block for consistent alignment in terminals and chat UIs.

Example use cases

• Morning automation that displays the dashboard on a home hub screen every day at wake-up.
• A chat command for mobile users to get weather, UV advice and currency info before travel.
• Integrating into a Slack channel to post daily local briefing for remote teams.
• Triggering from a voice assistant to read key items aloud from the briefing.
• Embedding into a personal dashboard that aggregates daily context for quick decisions.