agentleFS
aiagentwithdhruvaiagentwithdhruv/skills/generate-report/SKILL.md

generate-report

Skill16 starsChanged 9 months agoMITView on GitHub

Generate weekly weather reports for Canada using Open-Meteo API (free, no API key required) and PDF generation. Use when user asks to create a weather report, generate Canada weather summary, or build weekly weather PDF.

10 other projects use a version of this, 3 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    All scripts are in ./scripts/:

    line 24
  2. Distinctive:

    Missing data: Use "N/A" placeholders

    line 77

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Canada Weekly Weather Report Generator

Goal

Generate a professional PDF weather report for Canada using real-time data from Open-Meteo API (free, no API key required). The report uses the "Orange and Black Modern Annual Report" template style.

Inputs

  • Week Start Date (optional): Start date for the report period (defaults to current week)
  • Cities (optional): List of Canadian cities to include (defaults to major cities)

Default Canadian Cities

The report covers these major cities by default:

  • West Coast: Vancouver, Victoria
  • Prairies: Calgary, Edmonton, Winnipeg
  • Central: Toronto, Ottawa, Montreal
  • Atlantic: Halifax, St. John's
  • North: Whitehorse, Yellowknife

Scripts

All scripts are in ./scripts/:

  • fetch_weather.py - Fetches weather data from Open-Meteo API (no API key needed)
  • generate_report_pdf.py - Generates the styled PDF report

Process

1. Fetch Weather Data

python3 ./scripts/fetch_weather.py --output .tmp/canada_weather.json

Optional parameters:

  • --cities "Vancouver,Toronto,Montreal" - Custom city list
  • --days 7 - Number of forecast days (default: 7, max: 16)

2. Generate PDF Report

python3 ./scripts/generate_report_pdf.py \
  --input .tmp/canada_weather.json \
  --output .tmp/canada_weekly_weather_report.pdf \
  --template ".tmp/Orange and Black Modern Annual Report.pdf"

3. Review and Deliver

  • Open .tmp/canada_weekly_weather_report.pdf to verify
  • Upload to Google Drive or send via email if requested

Report Structure (Matching Template)

  1. Cover Page: "Canada Weekly Weather Report" with date range
  2. Table of Contents: Regional sections listed
  3. National Overview: Summary of weather patterns across Canada
  4. Regional Highlights: Key metrics (avg temp, precipitation, extremes)
  5. West Coast Weather: Vancouver, Victoria details
  6. Prairies Weather: Calgary, Edmonton, Winnipeg details
  7. Central Canada Weather: Toronto, Ottawa, Montreal details
  8. Atlantic Weather: Halifax, St. John's details
  9. Northern Territories: Whitehorse, Yellowknife details
  10. 7-Day Outlook: Forecast summary with trends
  11. Weather Alerts: Any active warnings/advisories
  12. Data Sources: Open-Meteo attribution

Output

Primary deliverable: PDF report at .tmp/canada_weekly_weather_report.pdf

The report includes:

  • Current conditions for each city
  • 7-day forecast with highs/lows
  • Precipitation amounts
  • Regional comparisons

Error Handling

  • City not found: Skip city, log warning, continue
  • Network error: Retry up to 3 times with backoff
  • Missing data: Use "N/A" placeholders

Environment

No API key required! Open-Meteo is free and open-source.

Data source: https://open-meteo.com/


Schema

Inputs

NameTypeRequiredDescription
week_start_datestringNoStart date for report period (defaults to current week)
citiesstringNoComma-separated list of Canadian cities

Outputs

NameTypeDescription
pdf_pathfile_pathPDF report at .tmp/canada_weekly_weather_report.pdf

Cost

Free (Open-Meteo API)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.