Scan

Skill jmarek41/surf-guide/.agents/skills/scan

Scan configured short-trip destinations for exceptional reachable surf windows, then price flights only for confirmed candidates.From its SKILL.md

Install

npx -y skills add jmarek41/surf-guide --skill scan

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

16 days oldThe repository was created 16 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.3 KB, 504 tokens by cl100k_base, as published. Nobody here has run it

Short-trip surf scan

Answer: “Is any configured destination about to be worth a short surf trip?”

Follow:

method/scan-workflow.md
method/flight-sources.md
scan/destinations.md
method/forecasting-principles.md
method/forecast-sources.md

Private configuration

Read:

data/profile.md
data/scan/config.md
data/scan/catalog-overlay.md if it exists
data/scan/scan-log.md if it exists
data/scan/flight-price-log.csv if it exists

If data/profile.md is absent, stop the scan and offer /setup-surf; do not invent rider ability, surf thresholds, or hard exclusions.

If data/scan/config.md is absent, create it from templates/scan-config.md after asking one compact batch for:

origin airports and acceptable ground-transfer time;
included destinations or all;
target face-height band and minimum period;
cleanliness and crowd requirements;
maximum nights and travel/surf ratio;
board-rental requirement;
currency and any price preference.

Never store an exact home address. Airport codes and an approximate home city are sufficient.

Before the first run, create any missing log files from templates/scan-log.md and templates/flight-price-log.csv. Preserve an existing log exactly; never replace it with the template.

Run

Resolve and state the exact scan window. Default to the next 7–10 days.
Run the cheap, batched swell triage for configured catalog cells.
Deep-confirm only candidates, following the source and geometry gates.
Classify each result as GO, near-GO, watch, or no-go.
Price flights only for GO and near-GO candidates.
Rank by surf opportunity first. Price, crowd, and travel are clearly shown, not hidden.
Append the private scan and flight-price logs.

If SerpAPI is not configured, continue the surf scan and provide pre-filled Google Flights links. Never ask the user to paste a private key into chat.

Safety and authority

Forecasts and prices are volatile. State retrieval times and sources. Do not book travel, reserve equipment, contact an operator, or spend money without explicit user instruction.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.