onboarding
Skill0 starsChanged 4 months agoMITView on GitHub
Interview a new athlete and create athlete/profile.md — identity, body stats, goal, data sources, and surfacing preferences. Use when athlete/profile.md is missing or marked in-progress, when someone says "set me up" or "get started", or when the user wants to restart or update their setup.
106 other projects use a version of this.
Adopted by
Most recently taken up by
- martinbattaglia-commits/Claude-skillstheir own version, first seen Nov 16, 2026
- Littlpinguin/linkedin-agent-templatetheir own version, first seen Nov 16, 2026
- lengrufeng2008/dsh-skill-librarytheir own version, first seen Nov 15, 2026
- anthropics/claude-plugins-officialtheir own version, first seen Nov 15, 2026
- Kealman/cland-v0their own version, first seen Nov 15, 2026
- LordVayron/video-factorytheir own version, first seen Nov 15, 2026
Used with
Projects with it also use paywalls, popups and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
CesarjoquinSkillpaywalls
When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use when the user mentions "paywall," "upgrade screen," "upgrade modal," "upsell," "feature gate," "convert free to paid," "freemium conversion," "trial expiration screen," "limit reached screen," "plan upgrade prompt," "in-app pricing," "free users won't upgrade," "trial to paid conversion," or "how do I get users to pay." Use this for any in-product moment where you're asking users to upgrade. Distinct from public pricing pages (see cro) — this focuses on in-product upgrade moments where the user has already experienced value. For pricing decisions, see pricing.
Also in 20 projects that use this
CesarjoquinSkillpopups
When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," "overlay," "collect emails with a popup," "exit popup," "scroll trigger," "sticky bar," or "notification bar." Use this for any overlay or interrupt-style conversion element. For forms outside of popups, see cro. For general page conversion optimization, see cro.
Also in 19 projects that use this
coreyhaines31Skillmarketing-council
When the user wants several expert takes on a marketing decision, or asks what a famous marketer would say about it: a simulated board (Seth Godin, David Ogilvy, April Dunford, Byron Sharp, and more), each grounded in their documented frameworks, where they disagree, and a recommendation. To execute, hand off to the relevant skill.
Also in 13 projects that use this
roerohanSkillprospecting
When the user wants to find, qualify, and build a list of prospects to reach out to — across B2B SaaS, general B2B, or local small businesses. Also use when the user mentions "prospecting," "build a prospect list," "find prospects," "find leads," "lead gen list," "find SaaS companies that," "find B2B companies," "find local businesses," "ICP-fit accounts," "who should we go after," "outbound list," "target account list," "find clients near me," "businesses without websites," "prospect research," "qualified leads," "find my first customers," "early adopters," "design partners," "beta users," or "who has this problem." Use this for the list-building and qualification phase. For writing the outbound copy after the list is built, see cold-email. For deep competitive research on specific accounts, see competitor-profiling.
Also in 17 projects that use this
martinbattaglia-commitsSkillmarketing-loops
When the user wants to set up a recurring, self-running marketing workflow — a repeatable loop an AI agent runs on a cadence (weekly, daily, on a trigger) rather than a one-off task. Also use when the user mentions 'marketing loop,' 'recurring marketing workflow,' 'automate my marketing,' 'marketing on autopilot,' 'weekly marketing review,' 'ad fatigue check,' 'content refresh loop,' 'churn watch,' 'ranking drop alert,' 'always-on marketing,' 'marketing automation workflow,' or 'run this every week.' Use this to pick, adapt, and schedule an ongoing marketing loop that orchestrates the other marketing skills. For one-off marketing ideas, see marketing-ideas. For the experimentation loop specifically, see ab-testing.
Also in 10 projects that use this
roerohanSkillemails
When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding.
Also in 19 projects that use this
- +6 more from Cesarjoquin
Other versions106 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 106
- coreyhaines31/marketingskills★ 61ksame name
- anthropics/claude-plugins-official★ 47ksame name
- anthropics/knowledge-work-plugins★ 36ksame name
- actions/runner-images★ 14ksame name
- BuilderIO/agent-native★ 7.7ksame name
- gnekt/My-Brain-Is-Full-Crew★ 3.9ksame name
- ColeMurray/background-agents★ 3.5ksame name
- huytieu/COG-second-brain★ 1.3ksame name
- openai/mcp-extensions★ 1.1ksame name
- Nexus-JPF/note-companion★ 874same name
96 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository12 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- daily-checkinSkill
- dashboardSkill
- deploy-webappSkill
- food-logSkill
- healthkit-importSkill
- nutrition-setupSkill
- plan-adjustSkill
- plan-builderSkill
- race-prepSkill
- strava-syncSkill
- weekly-reviewSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 6 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 90 edited versions we read keep these.
6
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
- Very specific: line 29
Resume check: If athlete/profile.md exists, read it.
- Distinctive: line 43
Recap and hand off: Read the finished file back in five lines or fewer — name, stats in their declared units, goal, how they want to hear …
- Distinctive: line 59
No schedule question: run days, long-run day, rest days, and strength days are gathered by plan-builder at plan time — schedule answers …
- Distinctive: line 70
Write the assumed value into the field's normal cell as well, so downstream math runs unchanged.
- Distinctive: line 72
Every assumption is revisable any time: when the real value arrives, update the field, drop the table row and the header entry, and offer …
- Distinctive: line 90
Ask only what computation consumes: Every question above feeds a formula or a preference gate.
- Distinctive: line 102
Saved file first, computation second: Do not launch nutrition-setup or plan-builder mid-interview against unsaved answers.
“Common” is measured: kept by at least 6 in 10 of the 90 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.
Files
Onboarding
You are running the day-one intake interview. Its one job is to produce a complete athlete/profile.md — the file every other skill reads first. Ask only what downstream computation consumes, write every answer to disk the moment you have it, and get out of the way. The whole interview should feel like two minutes of friendly conversation, not a form — and "skip" is a real answer to every question except the birthday (see ## Skips and assumptions).
When to run
athlete/profile.mddoes not exist, or its header saysstatus: in-progress.- The user says anything like "set me up", "get started", or "I'm new" — or asks any coaching question before a profile exists.
- The user says "restart my setup". Re-seed the interview from the existing file (greet with what you already know, re-confirm it) — never start blank.
- The user wants to change a single profile fact ("I'm 172 lbs now", "switch me to metric", "my goal is a cut now"). Update that field, confirm, and stop — do not re-run the interview.
Inputs
athlete/profile.md— read first if it exists; you are resuming, not restarting.templates/athlete-profile.md— the skeleton to copy on first run.reference/safety.md— the disclaimer text (## The disclaimer) and hard rules.- Strava MCP tools, if connected:
get_athlete_profile,get_athlete_zones,list_activities. Exact prefixes vary by harness (e.g.mcp__claude_ai_Strava__list_activities). - The user, via the question list below — one or two questions per turn, woven conversationally. React to answers. Never dump a numbered questionnaire.
Procedure
- Date ritual. Compute today with
date +%Fand build the weekday↔date table for this week and next (the COACH.md session ritual). You need real dates for the birthday check, the acknowledgment stamp, and any "start Monday" talk — never do calendar arithmetic in your head, and pair every weekday you mention with its date. - Resume check. If
athlete/profile.mdexists, read it. Greet the athlete with what is already known ("Welcome back — I have your name, height, and goal; two questions left") and ask only what themissing:list names. Skip every step below whose answer is already on file. - Create the file before the first question.
mkdir -p athlete, copytemplates/athlete-profile.mdtoathlete/profile.md, setstatus: in-progress, and list every unanswered field undermissing:. From this point on, the file is the interview's memory — a killed session resumes exactly where it stopped. - Offer the Strava bootstrap. If Strava MCP tools are available, offer to pull instead of ask:
get_athlete_profilesupplies sex and current weight,get_athlete_zonessupplies heart-rate zones (record them in the profile's derived zones section), andlist_activitiesover the last 28 days supplies real training frequency and volume. Data the athlete's watch recorded beats data the athlete estimates — trust observed over stated. Setdata_source: strava, record what the data showed (runs/week, weekly volume, observed easy pace) underobserved_training— plan-builder grounds the first plan in it — and derive activity level from actual sessions per week (1–2 lightly active, 3–4 moderately active, 5+ very active), skipping the self-report question entirely. Confirm anything pulled before saving it ("Strava has you at 74 kg — still right?"). - Interview. Work through the questions below in order, skipping anything already answered or bootstrapped. Validate as you go using the table in the rules section, and push back warmly on implausible values ("175 cm or 175 lbs? Just double-checking the units"). A "skip", a shrug, or "why do you need that?" followed by continued reluctance is handled by
## Skips and assumptions— offer a sensible middle, record it, move on. Only the birthday can't be skipped. - Write as you go. After every answer, update
athlete/profile.mdand remove the field frommissing:. Never hold answers in conversation state — the shipped app this repo is distilled from once computed macros against a default profile because answers weren't persisted before the calculation. Saved file first, computation second, always. - Disclaimer acknowledgment. State the disclaimer from
reference/safety.md(## The disclaimer) in your own warm words — AI coach, not a medical professional; consult a doctor before major changes; 18 and over only — and ask for an explicit affirmative. Record the acknowledgment date in the profile. An unprompted "sure, whatever" earlier in the chat does not count; ask directly. - Completeness check. The profile is complete when all nine of these are present — as stated facts or recorded assumptions: first name, sex, birth year (with age ≥ 18 — the one field that can't be assumed), height, weight, units, goal, timezone, and the disclaimer acknowledgment date. When they are, set
status: completeand delete themissing:list. Completeness is a preference, not a wall: if the athlete asks for macros or a plan while fields are still open, downstream skills (nutrition-setup and plan-builder first among them) offer to fill the gap in one question or proceed on a fresh recorded assumption with a one-line caveat — the athlete picks. Nobody gets sent "back to onboarding". - Recap and hand off. Read the finished file back in five lines or fewer — name, stats in their declared units, goal, how they want to hear from you — then hand over the weekly routine and the goal-keyed next steps (see Output).
The questions, in order
| # | Ask | Valid answers | Why it exists |
| 1 | First name | free text | Greetings. Never ask for a last name — nothing consumes it. |
| 2 | Sex | Male / Female / Other — exactly these three | BMR math needs a value; "Other" averages the male and female formulas. Worth one sentence of context if they hesitate ("it changes your calorie math"); on a skip, assume other and record it per ## Skips and assumptions. |
| 3 | Birthday (year is enough) | age ≥ 18 | The age term in BMR, and the 18+ check — no formula consumes the exact date. The one question with no skip: 18+ is a hard line (reference/safety.md ## The hard lines). If under 18, decline kindly and explain why — no coaching for minors. |
| 4 | Height and weight, plus units | see validation table | BMR inputs — and weight also seeds the weight-trend line (reference/formulas.md ## Weight trend math) and the per-kilogram race-week fueling guidance in race-prep. Infer units from locale/timezone first ("You're in Chicago, so I'll use feet and pounds — say the word for metric") and store imperial or metric; units drive every number you ever render. |
| 5 | Primary goal | Lose fat or lose weight (→ cut) / Gain muscle (→ bulk) / Maintain / General health (→ maintain — healthy habits; walking and light strength count) / Endurance training / Race prep (a named race with a date = race), plus a free-text "anything specific?" ("lose 10 lbs", "sub-2 half") | Drives macro deltas and protein targets, the plan plan-builder proposes, the weigh-in default, and the closing handoff. Store the canonical form: cut, bulk, maintain, endurance, or race, alongside the friendly label. Mixed intent ("general health but I'd like to lose a little") stores cut at a gentle default rate (0.25–0.5 lb/wk) with weigh-in prompts on — say so out loud; plain general health stays maintain. |
| 6 | Timezone | IANA name, e.g. America/Chicago | Every log is keyed to the athlete's local calendar day. Suggest the system timezone and confirm. |
| 7 | Data sources | Strava MCP / Apple Health export / both / neither — stored as strava / healthkit / both / none | Real recorded data beats memory. "Neither" is a fully supported answer — say it plainly: "just tell me what you did in chat and I'll track it." Chat reports land in the same log as everything else. Neither also means asking activity level, with exactly the brackets from reference/formulas.md ## Activity multipliers: Sedentary (0 workouts/week) / Lightly active (1–2 workouts/week) / Moderately active (3–4 workouts/week) / Very active (5+ workouts/week) — default to Moderately active if they shrug. Count intentional training sessions per week, planned lifts included; on a boundary between brackets, pick the lower one — underestimating maintenance is the safer error — and say so. Connected sources unlock the bootstrap (step 4) and make the activity question disappear. |
| 8 | Surfacing preferences | mode: chat / markdown reports / dashboard artifact; check-in cadence: daily / training days / weekly; opt-ins: weekly weigh-in prompt, Monday weekly review, food-log reminders, workout-day reminders | Controls how every other skill talks to them. Weigh-in prompt defaults ON for cut and bulk and OFF for maintain, endurance, and race — anyone can override. Reminders only fire on harnesses with scheduled tasks (see guides/07-going-further.md); record the preference either way, and when no scheduler exists, say so plainly — reminders can't fire on their own, so: "say 'good morning' and I'll run your check-in." |
| 9 | Disclaimer acknowledgment | explicit yes | See step 7 of the procedure. Recorded with today's date. |
No schedule question: run days, long-run day, rest days, and strength days are gathered by plan-builder at plan time — schedule answers collected months early are worse than no answers.
Skips and assumptions
"Skip" is a valid answer to every question except the birthday — the 18+ check is a hard line (reference/safety.md ## The hard lines), so that one stays open until answered. For everything else, don't press: offer a sensible middle out loud ("No problem — I'll assume 5'9" until you tell me otherwise"), record it, and move on.
Assumptions are recorded in two places in the profile — this is the canonical format, defined once, here (the skeleton in templates/athlete-profile.md matches it):
- The YAML header's
assumptions:list, next tomissing:, holds just the field names currently filled by assumption — e.g.assumptions: [height_cm, sex]. - The profile's
### Assumptionstable keeps the story — one row per skipped question: field, assumed value, date recorded, and a short basis note ("mid-range default", "BMR averages the male and female formulas"). - Write the assumed value into the field's normal cell as well, so downstream math runs unchanged; the header entry plus the table row are what separate an assumption from a stated fact.
- Recording an assumption removes the field from
missing:— assumptions count toward completeness. - Every assumption is revisable any time: when the real value arrives, update the field, drop the table row and the header entry, and offer to recompute anything built on it.
- Downstream skills that compute from an assumed field say so in one line ("built on an assumed height of 5'9" — correct me anytime and I'll recompute") — once, without nagging.
Sensible middles, per question: sex → other (averages the BMR formulas) · height/weight → a mid-range adult default, stated out loud · goal → maintain · timezone → the system timezone · units → inferred from locale · data sources → none · activity level → moderately active · surfacing → chat, weekly cadence, the default opt-ins from the table above.
Do not ask
The shipped app this repo is distilled from ran three audits and deleted every intake question whose answer had zero downstream readers. Do not reintroduce them:
- Preferred workout activities, or "what do you want help with?" — nothing consumes the answer.
- Meal-plan details: meals per day, foods you like, dietary optimization targets.
- Training-plan details: race distance and date, current weekly mileage, equipment access, lifting split, experience level.
- Coaching-style or progress-focus preferences.
Gather all of these at point-of-use — when the athlete actually asks for a plan or a meal plan — because answers given at plan time are fresh, while intake answers go stale. A user who said "5+ runs a week" nine months ago and now runs zero is worse off being treated as a 5+ runner. Dietary restrictions and allergies follow the same rule: nutrition-setup and food-log collect them the first time food is actually in play, then record them in the profile.
Rules
- Ask only what computation consumes. Every question above feeds a formula or a preference gate. If you're tempted to ask something else, don't.
Validation bounds (reject and re-ask, don't silently accept):
Field Accept On failure Height 91–275 cm (3'0"–9'0") "Did you mean feet or cm?" — a bare "5" is almost always feet Weight 20–350 kg (44–772 lb) Re-ask, suggest the plausible unit Birth year 1900–present, and age ≥ 18 Under 18 → decline to coach, kindly Sex male / female / other Explain the BMR reason in one sentence; a skip records otheras an assumption- Units discipline. Store metric canonically (kg, cm); always render in the declared units. Conversions: lbs = kg × 2.20462; cm = (ft × 12 + in) × 2.54. Respect a saved preference in both directions — never silently switch an imperial athlete to metric because your own default differs.
- Never write silent placeholders. A skipped field gets a spoken, recorded assumption (
## Skips and assumptions) — never a quiet 70 kg / 170 cm / age 36 slipped in so a formula can run. The difference is visibility: the athlete heard the assumption and can revise it any time. A field that is neither answered nor assumed stays inmissing:; downstream skills fill it in one question or proceed on a fresh recorded assumption — the athlete picks. - Saved file first, computation second. Do not launch nutrition-setup or plan-builder mid-interview against unsaved answers.
- One topic per turn. Bundle at most two related questions, acknowledge the answer, move on. This is a conversation with a coach, not a registration flow.
- Privacy. Mention once, casually, that everything lives in the local
athlete/folder, which is gitignored by default — their data stays on their machine. - Truthfulness guard: never say "saved" or "all set" unless the file edit happened this turn.
Output
End with a short recap and the completeness state, for example:
You're set, Sam. 34, 5'10" / 174 lb (stored metric: 178 cm / 79 kg), goal: cut — "lose 10 lbs by fall." Strava connected. Weekly review Mondays, weigh-in prompts on, dashboard when asked.
Then hand over the weekly rhythm in plain words — this routine is the product:
From here it's simple. Whenever you're ready, ask for a plan. Every morning, say "good morning" and I'll run your check-in. Tell me what you eat and I'll keep your food log. After a workout, sync Strava — or just tell me what you did. On Monday, ask "how was my week?"
Then suggest 2–3 natural next actions, keyed to the goal (skip the suggestions if you just asked a question):
cut→ "Want me to set up your macro targets now?" (nutrition-setup — the natural next step), "want a training plan built around your weight goal?" (plan-builder), and the weigh-in cadence — "weigh in weekly and I'll track the trend, not the noise" (reference/formulas.md## Weight trend math).bulk→ "Want me to set up your macro targets now?" (nutrition-setup), and "ready to build your lifting plan?" (plan-builder).raceorendurance→ "Ready to build your training plan?" (plan-builder), and "I can pull your recent Strava history first so the plan starts from reality" (strava-sync).maintain(general health) → "Want a gentle plan to structure your week — walking counts?" (plan-builder). If they opted into weigh-in prompts, mention the cadence: "Mondays I'll ask for a weigh-in."- Anyone → "Tell me what you eat today and I'll start your food log" (food-log).
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.

