setup-surf
Skill0 starsChanged 4 months agoMITView on GitHub
Set up a private rider profile and activate or research a surf region. Use when the user is new, changes destination, or asks to configure surf-guide.
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- board-recommendSkill
- log-sessionSkill
- scanSkill
- surfSkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 5 are distinctive, and 7 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 21
Check whether data/profile.md and data/active-location.md already exist.
- Very specific: line 24
If the active-location status is none, preserve that state until the user provides a destination.
- Distinctive: line 29
Ask only for missing information, in no more than six numbered questions:
- Distinctive: line 48
When an existing public location pack covers the requested region, create or update only:
- Very specific: line 57
Use the templates exactly.
- Very specific: line 58
Never write private answers under locations/.
- Very specific: line 60
If no public pack exists, Step 4 may additionally create the private data/location-drafts/<country-slug>/<region-slug>/ tree.
- Distinctive: line 69
verify that its coverage matches the user's drive radius.
- Very specific: line 71
check for existing private overlays or expanded local drafts under data/.
- Distinctive: line 75
If it does not exist:
- Very specific: line 80
Create a local draft under data/location-drafts/<country-slug>/<region-slug>/ using locations/_template/.
- Distinctive: line 90
Do not add a new public location pack automatically.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Set up surf-guide
Configure this clone without publishing personal data.
1. Inspect before asking
Read:
AGENTS.mdtemplates/profile.mdtemplates/active-location.mdlocations/README.md- the user's current setup request
Check whether data/profile.md and data/active-location.md already exist.
Preserve existing answers unless the user asks to replace them.
If the active-location status is none, preserve that state until the user
provides a destination. Do not invent or reactivate an archived trip.
2. Ask one compact batch
Ask only for missing information, in no more than six numbered questions:
- Surf region and approximate base town or neighbourhood; never require an exact address.
- Maximum drive time and transport/access constraints.
- Ability, years/frequency, and comfortable versus absolute-maximum face height.
- Hard exclusions: bottom types, hazards, localism, isolation, access, or daylight/time constraints.
- Optional preferences: left/right, beach/point/reef, crowd tolerance, and current technique goal.
- Current board plus height, weight, and successful/unsuccessful past boards if board recommendations are wanted.
Explain that weight and board history are optional for forecasts but useful for board selection.
3. Write private configuration
When an existing public location pack covers the requested region, create or update only:
data/profile.mddata/active-location.mddata/sessions/<region-slug>.csvdata/sessions/<region-slug>.mddata/calibration/<region-slug>.md
Use the templates exactly. Store the base only at town/neighbourhood precision.
Never write private answers under locations/.
If no public pack exists, Step 4 may additionally create the private
data/location-drafts/<country-slug>/<region-slug>/ tree.
4. Resolve the public location pack
Look for locations/<country-slug>/<region-slug>/README.md.
If it exists:
- verify that its coverage matches the user's drive radius;
- reference it from
data/active-location.md; - check for existing private overlays or expanded local drafts under
data/; - reference relevant private overlays in
data/active-location.mdinstead of copying their personal annotations into the shared pack.
If it does not exist:
- Explain that a one-time location research pass is required.
- Research a bounded zone of roughly 5–12 established public breaks.
- Apply the two-source rule from
AGENTS.md. - Create a local draft under
data/location-drafts/<country-slug>/<region-slug>/usinglocations/_template/. - Include source URLs, confidence labels, approximate coordinates, timezone, orientation, swell/wind/tide guidance, hazards, access, sections, and exposure class.
- Label map/geometry deductions as inference. Do not invent empirical multipliers or calibration.
- Point
data/active-location.mdat the local draft.
Do not add a new public location pack automatically. At the end, offer to prepare the factual draft as a reviewable contribution after the user has checked it. Promotion requires explicit user approval and must exclude the profile, base, sessions, and private calibration.
5. Initialize session files
Copy the exact CSV header from templates/sessions.csv. In the Markdown log,
state that first-hand observations are personal ground truth and must not be
published automatically.
6. Finish
Report:
- active status;
- active region;
- shared pack or local draft path;
- number of included spots;
- any fields left unknown;
- that
data/is ignored by Git; - the next command:
/surf tomorrow.
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
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.

