weather-api_skill

Overview

This skill fetches weather data tailored for construction scheduling, combining forecasts, historical archives, and activity-specific risk assessments. It helps determine workable hours, identify affected activities, and produce recommendations to adjust schedules and safety plans. The implementation focuses on practical thresholds for common construction tasks and outputs CSV/DF-friendly results.

How this skill works

The skill queries Open-Meteo endpoints for hourly forecasts and historical archives, parses responses into time-stamped WeatherCondition records, and converts them to pandas DataFrames. A ConstructionWeatherRisk assessor evaluates each condition against activity-specific thresholds (temperature, wind, precipitation) and returns WorkabilityAssessment objects. Daily or weekly summaries are generated by selecting representative hours and aggregating risk metrics.

When to use it

• Plan concrete pours, crane lifts, roofing, painting, or earthwork windows
• Prepare weekly site schedules with weather-informed workable hours
• Analyze historical weather impacts on productivity and delays
• Trigger alerts for high-risk days or safety stand-downs
• Feed to project management or resourcing tools for dynamic scheduling

Best practices

• Validate latitude/longitude and timezone context before requesting data to avoid misaligned hours
• Use representative midday hours for daily planning and inspect full hourly data for critical tasks
• Customize thresholds per project, material, or regional practice rather than relying only on defaults
• Combine forecast and recent historical trends to detect abrupt changes or rain persistence
• Convert outputs to DataFrames and store daily snapshots for audit and retrospective analysis

Example use cases

• Identify low-risk 4–8 hour windows for concrete pours within a 7–14 day forecast
• Produce a weekly risk summary dataframe showing workable_hours and affected activity counts for planners
• Count historical rainy days to quantify schedule delay risk for quarterly retrospectives
• Run automated daily checks to mark Critical/HIGH days and notify site managers
• Integrate with resource allocation to shift labor or equipment on low-risk days