From 86c8be57c87ad8b5c3362625ee507a4eb48468c6 Mon Sep 17 00:00:00 2001 From: Krishna Agarwal Date: Mon, 6 Apr 2026 01:06:58 +0800 Subject: [PATCH 1/8] Add tender-finder-skill to tinyfish-cookbook --- skills/tutor-finder/README.md | 49 ++++++ skills/tutor-finder/tutor-finder.skill | Bin 0 -> 3567 bytes skills/tutor-finder/tutor-finder/SKILL.md | 199 ++++++++++++++++++++++ 3 files changed, 248 insertions(+) create mode 100644 skills/tutor-finder/README.md create mode 100644 skills/tutor-finder/tutor-finder.skill create mode 100644 skills/tutor-finder/tutor-finder/SKILL.md diff --git a/skills/tutor-finder/README.md b/skills/tutor-finder/README.md new file mode 100644 index 000000000..df838038c --- /dev/null +++ b/skills/tutor-finder/README.md @@ -0,0 +1,49 @@ +# Tutor Finder — Claude Skill + +**Find and compare exam tutors from across the web in real time.** + +Ask Claude things like: +- *"Find me a GRE tutor in London"* +- *"Best online SAT tutors under $50/hr"* +- *"Compare GMAT tutors — I'm in Singapore"* +- *"Find JEE tutors in India"* +- *"Who are the top TOEFL tutors available online?"* + +Claude fires parallel TinyFish agents across 7-10 tutoring platforms simultaneously — Wyzant, Varsity Tutors, Preply, Kaplan, Princeton Review, and location-specific platforms — extracting live tutor profiles with pricing, qualifications, experience, and booking links. + +## Supported exams + +SAT · ACT · AP · GRE · GMAT · TOEFL/IELTS · JEE/NEET · Olympiads + +## What you get + +- Tutor name, qualifications, and experience +- Pricing per hour (where listed) +- Teaching mode (online / offline / hybrid) +- Past student results and score improvements +- Direct profile link or booking method +- Quick comparison table across all tutors +- A top recommendation based on your exam and location + +## Requirements + +- TinyFish CLI: `npm install -g tinyfish` +- Authenticated: `tinyfish auth login` + +## Install + +**Claude.ai:** Download `tutor-finder.skill` from Releases → upload to Settings → Skills + +**CLI:** +```bash +npx skills add KrishnaAgarwal7531/skills- --skill tutor-finder +``` + +## Based on + +The [Exam Tutor Finder web app](https://tinyfishtutorsfinder.lovable.app) — this skill brings the same functionality directly into Claude without needing the web app. + +## Built with + +- [TinyFish Web Agent](https://tinyfish.ai) +- Part of the [TinyFish Cookbook](https://github.com/tinyfish-io/tinyfish-cookbook) diff --git a/skills/tutor-finder/tutor-finder.skill b/skills/tutor-finder/tutor-finder.skill new file mode 100644 index 0000000000000000000000000000000000000000..2ab995c2f4800ab8a9854d218267a07020a4f124 GIT binary patch literal 3567 zcmZ{ncQ72>8i!X|Z4t?b6jpRXEMY^CM1<(QuNtfOZf&%LAbRxPcC}Tag$-5+!CKLY z9?>n)f~esp-*@NUnaq6W%=w-7oq6Y(_uofLm5iJQ@cWd%2s8b=_;1hwSOMNX-fo^k zwhpe=HlD)zdei_ij;LXWJHMWf9|%A~{(JQA(E5d8{MAtXjgflkyOBZ*09dmE08D>k zbXAqr)F3X_|HJ)8{(%dFO~c!c~08B&&GO zkN&XSEm%|mGhUa0T#0sqf^?}9f0J7iIZ$#0I-{1)EHg7Q++|XFAi@Fcc-q^Fc)?Pw*2!Ok;oc<`5`ajJYeZ zMO685d078`Jw(Y;_`HJAAfeZRHwx(^&ypewDIemnsk&Wn4eWP@G~H*dmm1Bq-&mXM z6q%urVq2Yr4je5{ON4zL2$u`O;ti8icSDLLA4p5GhCT6c1-GV&?cKgJ8COI<(DI^M z9%?pHFAxJ4lk`tsa(CCFwEYIQIHB}QftM*C46)_~B)J|e0jmH*5Cv7S z=E|>^scxjl@DRt}Xw@wK^%uQ}WFA)u-j4UhXTe40BU|`w;^1MC%BN2s;livX7Q#N3 z(6}|d`7Fs-XpAp``yI}2G9ywse;E*BmdjVYrpnrw`+=$o#pqN*xD`~cg2hLZ1e$-< zFQ#8DGr}w_Dqh-N3X|$_|UoL_FZf!1K?X3#6PKpN1HDJU1Bq{1F?9Upk?Oa zKKdk60b!3P;Ydw>DUVVZsOIk&3#fi~pws&xX$G{ZM?H);%?s1l`jS|hn6*t$0SGnT zYFf;x84MjpOf1jB;42`--N)UA+EBK5J^}>w)N0*VaC$6$V%R#zvuOE1dp|${w)GnA zN7YwMcEhe08c?#8-TuYHs8=)}8WCDC$CSI|l_Xm&u?24O-suaBY~rK-?%5E&V?%Ui z49rPOcEG=C8g;!CikWtS<#6@xO*Yr(@I z1NUxWfX()3WY5`APxZFGA{l$Kx@DS_0(=eA#;FcHE0Tb@|Jt~!r-XE1E$M&mFhgxKt>Eh$A_6u$1&skI&w4?ywmn0_+ugx7^zsJnQ zF}1>xrlW7_5J3iS5nh_Ia?l4F8R))Rg!3M88fpjFOf%LnuB8M@ZTR#3km#tQ*K}=C zmzDN$vYlWR_4pWS4CD*MA(q-aeuM>1R#)!->PJtC%-=CBI?AQx* zz+|pAnvJf2x_9FY%}h z(M}imu+OUjb0pASM%XjiaP!4Wj)-|qP&GE*=u(TE+%hNy5|w_Fny}3*M~a2$^V`y4cL;Zz&+>zU5HOb~LG4!J|6ah^fiw)=E`3Rn|n>U#0j z?g%uxE;`B0V=OBb=jcJyK?OZ+Q@>q#jV~@|gY78nwb1wcY94Bu403HMcb*DgI%~bS z=#TX^wu!IYU%;5TGDEL=k@Sq#XP}Qf-_T%^nA#-+Rp;--TQM8MY&%Wh5%*VX`%DA_ zZ|F^^K8>r$Z%Nb9ep2i(dN80-RG*O|at9%KJJ|6yq&0Ors7R|KK|ofE;=R^VU0K2l zf)hY6&x5_EN8(^=W-rS{@>rvr9x5Ebi9u+cJyJP}^o*ttEC7wt4bFB>Wlk7mJrRWj zC2AI|WOUCy%;~coE19e03(Gj^EYP9jSGc^^jm&6-_Zbr0TisJ0At>L5+f}xz_`PfP zOB1}LwXhoYnZ2(DVwxn64)F?ZYeG?$k7D=_pVRyhRwRaij!9@Es7N(Tpvo{G?ZTGk zL1xT{aJYxHj^Bx~K+RE08Pz=F1uI-2 zSWff_VAO%?SCQPuC`xR6=lPTsGCu##dJ_@yjl~pZy+64;NqjCo_x3Ey&3LU)d|K}t)T^?tFTG!b(|vqm z%_0*#6NJFJoZi^wnMR-rN4&l4#-k;w1hT*RZc0THb=RA{ClPgSPOIi@Y;-LV{&TSO zuWz;$A^SRHKs%C`nWLYthDJtJtpLA!(?A&-B2@;_m$RXzy?`{J>sD?Xku?}sw}Xf@ zI*RFiJXj_q5YTQuyi00&w!7H9|0QOpk#z$r?6|REh(_Q)CMY9?>U#q2H1$EnDKJ~^ zQqR?h8kv6f=y;SIl#Y>s4m zaD|N5Q3F%+7^5cMTW%F9cEgMP*|%Ni+z5J)L}|*r)$=XWr41!XL2y%mIJ_)-iASdL zUPPWrk8IXr9bW``)viQB+uzH0giB*bM1FqN$LnbBVo-NE*)H)F1zW~jEahCmT+s2n zCX}?v6YID<34RRt{3;SXl}2jx_1oLYPDtvUD+u{DO`V}7GU#-ON zt$Rche%=hQ#PgG4@jmdgYNznDE05NuRM_2fHOpUFAj3nC>Wo`+b_Z#)mIYvFE*{PO6$QicI%ncn>2M4gKK zII-4n=~i@_rU>qgj<+KX+!uVt7ejAP3d}s=*j))aB;og8G2+>9kO(okVf&twCMq|) z`#yj0+yHneXq4&hcQlXffPVSFEEk!5gn4bfMGblUAU^$iJRI9?T3#sM=)V8O&>5vP zOdnv_CGUMPMEUmR+$?>|M!mp5!=)t0eWj6~xSbe#6S2ptgI4RG>ezkgI7`m54f5|V zJzGMuAb2W3PV4dZaamRetq?cOY8tW%nl1e1(+LED)v(b0DGoyWV8K_~CP?_gCo$bb z;=HnMtd1~bT-a(-wcHaO*Be5XQ^_HVyoG@WmidK#lNfkk + Find and compare tutors for competitive exams from across the web in real time using + parallel TinyFish agents. Use this skill whenever a user wants to find a tutor for an + exam, asks "find me a tutor for SAT", "best GRE tutors in London", "compare tutors for + JEE", "how much do GMAT tutors cost", "find online tutors for AP exams", or any variation + of searching for exam preparation tutors. Supported exams: SAT, ACT, AP, GRE, GMAT, + TOEFL/IELTS, JEE/NEET, Olympiads. + Fires parallel TinyFish agents across 7-10 tutoring platforms simultaneously — Wyzant, + Varsity Tutors, Preply, Kaplan, Princeton Review and others — extracting live tutor + profiles with pricing, qualifications, experience, and contact details. +compatibility: + tools: [tinyfish] +metadata: + author: KrishnaAgarwal7531 + version: "1.0" + tags: tutors exam-prep SAT GRE GMAT education tutoring competitive-exams +--- + +# Exam Tutor Finder + +Given an exam type and location, find and compare real tutors from across the web using parallel TinyFish agents scraping live tutor platforms simultaneously. + +## Pre-flight check + +```bash +tinyfish --version +tinyfish auth status +``` + +If not installed: `npm install -g tinyfish` +If not authenticated: `tinyfish auth login` + +--- + +## Step 1 — Clarify inputs + +You need: +- **Exam type** — one of: SAT, ACT, AP, GRE, GMAT, TOEFL/IELTS, JEE/NEET, Olympiads +- **Location** — e.g. "London", "Singapore", "New York", "online", "India" + +If exam type is not specified, ask before proceeding. +If location is not specified, default to "online" and mention it. + +--- + +## Step 2 — Discover tutor platform URLs + +Use your knowledge to identify 7-10 tutoring platforms relevant to the exam and location. Pick from this list and supplement with location-specific platforms where relevant: + +**Global platforms (always include 3-4):** +- `https://www.wyzant.com/search/tutors` — large tutor marketplace +- `https://www.varsitytutors.com/tutors` — test prep specialists +- `https://preply.com/en/online/{EXAM}-tutors` — online tutors +- `https://www.tutor.com` — on-demand tutoring +- `https://www.chegg.com/tutors` — student-focused platform + +**Test prep specific (include if relevant to exam):** +- `https://www.kaptest.com/tutoring` — Kaplan, strong for SAT/GRE/GMAT +- `https://www.princetonreview.com/tutoring` — Princeton Review, SAT/ACT/AP +- `https://www.magoosh.com` — GRE/GMAT/TOEFL focus +- `https://www.manhattanprep.com/tutoring` — GMAT/GRE specialists + +**Location-specific additions:** +- For India/JEE/NEET: add `https://www.vedantu.com`, `https://www.unacademy.com` +- For Singapore: add `https://www.snapask.com`, `https://www.smiletutor.sg` +- For UK: add `https://www.tutorfair.com`, `https://www.mytutor.co.uk` + +Produce 7-10 URLs then proceed. + +--- + +## Step 3 — Parallel scraping + +Fire one TinyFish agent per platform, all simultaneously using `&` + `wait`. + +```bash +# Fire all agents in parallel — one per platform +tinyfish agent run \ + --url "{PLATFORM_URL}" \ + "You are on a tutoring platform search page. Extract {EXAM} tutors fast. + Read only what is visible on this page — do not navigate to other pages. + Find tutor listings or profiles related to {EXAM} preparation. + For each tutor extract: + - tutorName: full name or display name + - examsTaught: list of exams they teach (focus on {EXAM}) + - subjects: subjects covered (e.g. Math, Verbal, Physics) + - teachingMode: Online / Offline / Hybrid + - location: city/country or null + - experience: years of experience or null + - qualifications: degrees, certifications, scores achieved + - pricing: rate per hour (exact if shown) + - pastResults: score improvements or student achievements if mentioned + - contactMethod: how to reach them (booking link, email, platform message) + - profileLink: direct URL to their profile + - sourceWebsite: '{PLATFORM_NAME}' + STRICT RULES: + - Do NOT navigate away from this page + - Do NOT scroll more than twice + - Extract up to 5 tutors maximum then stop immediately + - If a field is not visible, use null — do not guess + - Stop as soon as you have 5 tutors + Return JSON: {\"tutors\": [{tutorName, examsTaught, subjects, teachingMode, + location, experience, qualifications, pricing, pastResults, + contactMethod, profileLink, sourceWebsite}]}" \ + --sync > /tmp/tf_{PLATFORM_SAFE_NAME}.json & +``` + +Repeat for each platform URL, all backgrounded with `&`. Then: + +```bash +wait + +# Collect all results +for f in /tmp/tf_*.json; do echo "=== $f ===" && cat "$f"; done +``` + +Replace: +- `{PLATFORM_URL}` — the actual platform URL +- `{EXAM}` — the exam type e.g. `GRE` +- `{PLATFORM_NAME}` — platform display name e.g. `Wyzant` +- `{PLATFORM_SAFE_NAME}` — short identifier e.g. `wyzant`, `varsity`, `preply` + +--- + +## Step 4 — Filter and rank + +From all results combined: + +1. **Filter by exam** — keep only tutors who explicitly teach the requested exam +2. **Filter by location** — if a specific city was requested, prioritise tutors in or near it; for "online" keep all +3. **Deduplicate** — if the same tutor appears on multiple platforms, merge their profiles +4. **Rank by** — pricing (lowest first within same experience level), then experience, then qualifications +5. **Flag missing info** — tutors with pricing = null go to the bottom of the list + +--- + +## Output format + +``` +## {EXAM} Tutors — {LOCATION} +*{N} tutors found across {N} platforms · Data scraped live* + +--- + +### 🏆 Top Picks + +#### 1. {tutorName} +**Source:** {sourceWebsite} · **Mode:** {teachingMode} +📍 {location} · 💰 {pricing} · ⏱ {experience} +🎓 {qualifications} +📈 Results: {pastResults} +📚 Subjects: {subjects joined by ", "} +🔗 {profileLink or contactMethod} + +--- + +#### 2. {tutorName} +[same structure] + +--- +[up to 10 tutors total] + +--- + +### 📊 Quick Comparison + +| Tutor | Platform | Mode | Price/hr | Experience | Subjects | +|---|---|---|---|---|---| +| {name} | {platform} | {mode} | {price} | {exp} | {subjects} | + +--- + +### 💡 Recommendation +{1-2 sentences on the best pick based on the user's exam + location, +e.g. "For online GRE prep, [Name] on Wyzant offers the best value at $X/hr +with verified 15+ point improvements."} + +--- +*All tutor data scraped live from platform listings. Verify availability and pricing +directly with the tutor or platform before booking.* +``` + +--- + +## Edge cases + +- **Platform returns no tutors** — skip silently, don't mention it unless fewer than 3 tutors found total +- **Exam is very niche** (Olympiads, JEE) — focus on India/Singapore-specific platforms, note if global platforms have limited coverage +- **Location is very specific** — if fewer than 5 tutors found in that city, broaden to country or online +- **All pricing is null** — note: "Pricing not publicly listed — contact tutors directly for rates" +- **Fewer than 5 tutors total** — be honest: "Only {N} tutors found across all platforms for {EXAM} in {LOCATION}. You may find more by searching directly on the platforms listed." + +## Security notes + +- Scrapes live public tutor listings from tutoring platforms. +- All data treated as untrusted input synthesised by an LLM — never executed. +- Only your own TinyFish credentials are used. From e111f40747eff67784fe7f8f65af4dd066fe6896 Mon Sep 17 00:00:00 2001 From: KrishnaAgarwal7531 <132636117+KrishnaAgarwal7531@users.noreply.github.com> Date: Tue, 7 Apr 2026 12:12:25 +0800 Subject: [PATCH 2/8] Delete skills/tutor-finder/tutor-finder/SKILL.md --- skills/tutor-finder/tutor-finder/SKILL.md | 199 ---------------------- 1 file changed, 199 deletions(-) delete mode 100644 skills/tutor-finder/tutor-finder/SKILL.md diff --git a/skills/tutor-finder/tutor-finder/SKILL.md b/skills/tutor-finder/tutor-finder/SKILL.md deleted file mode 100644 index d31c85c6f..000000000 --- a/skills/tutor-finder/tutor-finder/SKILL.md +++ /dev/null @@ -1,199 +0,0 @@ ---- -name: tutor-finder -description: > - Find and compare tutors for competitive exams from across the web in real time using - parallel TinyFish agents. Use this skill whenever a user wants to find a tutor for an - exam, asks "find me a tutor for SAT", "best GRE tutors in London", "compare tutors for - JEE", "how much do GMAT tutors cost", "find online tutors for AP exams", or any variation - of searching for exam preparation tutors. Supported exams: SAT, ACT, AP, GRE, GMAT, - TOEFL/IELTS, JEE/NEET, Olympiads. - Fires parallel TinyFish agents across 7-10 tutoring platforms simultaneously — Wyzant, - Varsity Tutors, Preply, Kaplan, Princeton Review and others — extracting live tutor - profiles with pricing, qualifications, experience, and contact details. -compatibility: - tools: [tinyfish] -metadata: - author: KrishnaAgarwal7531 - version: "1.0" - tags: tutors exam-prep SAT GRE GMAT education tutoring competitive-exams ---- - -# Exam Tutor Finder - -Given an exam type and location, find and compare real tutors from across the web using parallel TinyFish agents scraping live tutor platforms simultaneously. - -## Pre-flight check - -```bash -tinyfish --version -tinyfish auth status -``` - -If not installed: `npm install -g tinyfish` -If not authenticated: `tinyfish auth login` - ---- - -## Step 1 — Clarify inputs - -You need: -- **Exam type** — one of: SAT, ACT, AP, GRE, GMAT, TOEFL/IELTS, JEE/NEET, Olympiads -- **Location** — e.g. "London", "Singapore", "New York", "online", "India" - -If exam type is not specified, ask before proceeding. -If location is not specified, default to "online" and mention it. - ---- - -## Step 2 — Discover tutor platform URLs - -Use your knowledge to identify 7-10 tutoring platforms relevant to the exam and location. Pick from this list and supplement with location-specific platforms where relevant: - -**Global platforms (always include 3-4):** -- `https://www.wyzant.com/search/tutors` — large tutor marketplace -- `https://www.varsitytutors.com/tutors` — test prep specialists -- `https://preply.com/en/online/{EXAM}-tutors` — online tutors -- `https://www.tutor.com` — on-demand tutoring -- `https://www.chegg.com/tutors` — student-focused platform - -**Test prep specific (include if relevant to exam):** -- `https://www.kaptest.com/tutoring` — Kaplan, strong for SAT/GRE/GMAT -- `https://www.princetonreview.com/tutoring` — Princeton Review, SAT/ACT/AP -- `https://www.magoosh.com` — GRE/GMAT/TOEFL focus -- `https://www.manhattanprep.com/tutoring` — GMAT/GRE specialists - -**Location-specific additions:** -- For India/JEE/NEET: add `https://www.vedantu.com`, `https://www.unacademy.com` -- For Singapore: add `https://www.snapask.com`, `https://www.smiletutor.sg` -- For UK: add `https://www.tutorfair.com`, `https://www.mytutor.co.uk` - -Produce 7-10 URLs then proceed. - ---- - -## Step 3 — Parallel scraping - -Fire one TinyFish agent per platform, all simultaneously using `&` + `wait`. - -```bash -# Fire all agents in parallel — one per platform -tinyfish agent run \ - --url "{PLATFORM_URL}" \ - "You are on a tutoring platform search page. Extract {EXAM} tutors fast. - Read only what is visible on this page — do not navigate to other pages. - Find tutor listings or profiles related to {EXAM} preparation. - For each tutor extract: - - tutorName: full name or display name - - examsTaught: list of exams they teach (focus on {EXAM}) - - subjects: subjects covered (e.g. Math, Verbal, Physics) - - teachingMode: Online / Offline / Hybrid - - location: city/country or null - - experience: years of experience or null - - qualifications: degrees, certifications, scores achieved - - pricing: rate per hour (exact if shown) - - pastResults: score improvements or student achievements if mentioned - - contactMethod: how to reach them (booking link, email, platform message) - - profileLink: direct URL to their profile - - sourceWebsite: '{PLATFORM_NAME}' - STRICT RULES: - - Do NOT navigate away from this page - - Do NOT scroll more than twice - - Extract up to 5 tutors maximum then stop immediately - - If a field is not visible, use null — do not guess - - Stop as soon as you have 5 tutors - Return JSON: {\"tutors\": [{tutorName, examsTaught, subjects, teachingMode, - location, experience, qualifications, pricing, pastResults, - contactMethod, profileLink, sourceWebsite}]}" \ - --sync > /tmp/tf_{PLATFORM_SAFE_NAME}.json & -``` - -Repeat for each platform URL, all backgrounded with `&`. Then: - -```bash -wait - -# Collect all results -for f in /tmp/tf_*.json; do echo "=== $f ===" && cat "$f"; done -``` - -Replace: -- `{PLATFORM_URL}` — the actual platform URL -- `{EXAM}` — the exam type e.g. `GRE` -- `{PLATFORM_NAME}` — platform display name e.g. `Wyzant` -- `{PLATFORM_SAFE_NAME}` — short identifier e.g. `wyzant`, `varsity`, `preply` - ---- - -## Step 4 — Filter and rank - -From all results combined: - -1. **Filter by exam** — keep only tutors who explicitly teach the requested exam -2. **Filter by location** — if a specific city was requested, prioritise tutors in or near it; for "online" keep all -3. **Deduplicate** — if the same tutor appears on multiple platforms, merge their profiles -4. **Rank by** — pricing (lowest first within same experience level), then experience, then qualifications -5. **Flag missing info** — tutors with pricing = null go to the bottom of the list - ---- - -## Output format - -``` -## {EXAM} Tutors — {LOCATION} -*{N} tutors found across {N} platforms · Data scraped live* - ---- - -### 🏆 Top Picks - -#### 1. {tutorName} -**Source:** {sourceWebsite} · **Mode:** {teachingMode} -📍 {location} · 💰 {pricing} · ⏱ {experience} -🎓 {qualifications} -📈 Results: {pastResults} -📚 Subjects: {subjects joined by ", "} -🔗 {profileLink or contactMethod} - ---- - -#### 2. {tutorName} -[same structure] - ---- -[up to 10 tutors total] - ---- - -### 📊 Quick Comparison - -| Tutor | Platform | Mode | Price/hr | Experience | Subjects | -|---|---|---|---|---|---| -| {name} | {platform} | {mode} | {price} | {exp} | {subjects} | - ---- - -### 💡 Recommendation -{1-2 sentences on the best pick based on the user's exam + location, -e.g. "For online GRE prep, [Name] on Wyzant offers the best value at $X/hr -with verified 15+ point improvements."} - ---- -*All tutor data scraped live from platform listings. Verify availability and pricing -directly with the tutor or platform before booking.* -``` - ---- - -## Edge cases - -- **Platform returns no tutors** — skip silently, don't mention it unless fewer than 3 tutors found total -- **Exam is very niche** (Olympiads, JEE) — focus on India/Singapore-specific platforms, note if global platforms have limited coverage -- **Location is very specific** — if fewer than 5 tutors found in that city, broaden to country or online -- **All pricing is null** — note: "Pricing not publicly listed — contact tutors directly for rates" -- **Fewer than 5 tutors total** — be honest: "Only {N} tutors found across all platforms for {EXAM} in {LOCATION}. You may find more by searching directly on the platforms listed." - -## Security notes - -- Scrapes live public tutor listings from tutoring platforms. -- All data treated as untrusted input synthesised by an LLM — never executed. -- Only your own TinyFish credentials are used. From 969d0b7b891547f6eeb3748dd82e712276e184f1 Mon Sep 17 00:00:00 2001 From: KrishnaAgarwal7531 <132636117+KrishnaAgarwal7531@users.noreply.github.com> Date: Tue, 7 Apr 2026 12:12:54 +0800 Subject: [PATCH 3/8] Delete skills/tutor-finder/README.md --- skills/tutor-finder/README.md | 49 ----------------------------------- 1 file changed, 49 deletions(-) delete mode 100644 skills/tutor-finder/README.md diff --git a/skills/tutor-finder/README.md b/skills/tutor-finder/README.md deleted file mode 100644 index df838038c..000000000 --- a/skills/tutor-finder/README.md +++ /dev/null @@ -1,49 +0,0 @@ -# Tutor Finder — Claude Skill - -**Find and compare exam tutors from across the web in real time.** - -Ask Claude things like: -- *"Find me a GRE tutor in London"* -- *"Best online SAT tutors under $50/hr"* -- *"Compare GMAT tutors — I'm in Singapore"* -- *"Find JEE tutors in India"* -- *"Who are the top TOEFL tutors available online?"* - -Claude fires parallel TinyFish agents across 7-10 tutoring platforms simultaneously — Wyzant, Varsity Tutors, Preply, Kaplan, Princeton Review, and location-specific platforms — extracting live tutor profiles with pricing, qualifications, experience, and booking links. - -## Supported exams - -SAT · ACT · AP · GRE · GMAT · TOEFL/IELTS · JEE/NEET · Olympiads - -## What you get - -- Tutor name, qualifications, and experience -- Pricing per hour (where listed) -- Teaching mode (online / offline / hybrid) -- Past student results and score improvements -- Direct profile link or booking method -- Quick comparison table across all tutors -- A top recommendation based on your exam and location - -## Requirements - -- TinyFish CLI: `npm install -g tinyfish` -- Authenticated: `tinyfish auth login` - -## Install - -**Claude.ai:** Download `tutor-finder.skill` from Releases → upload to Settings → Skills - -**CLI:** -```bash -npx skills add KrishnaAgarwal7531/skills- --skill tutor-finder -``` - -## Based on - -The [Exam Tutor Finder web app](https://tinyfishtutorsfinder.lovable.app) — this skill brings the same functionality directly into Claude without needing the web app. - -## Built with - -- [TinyFish Web Agent](https://tinyfish.ai) -- Part of the [TinyFish Cookbook](https://github.com/tinyfish-io/tinyfish-cookbook) From 71091f5cbfe464a428c110427dad68ddfc794c04 Mon Sep 17 00:00:00 2001 From: KrishnaAgarwal7531 <132636117+KrishnaAgarwal7531@users.noreply.github.com> Date: Tue, 7 Apr 2026 12:13:14 +0800 Subject: [PATCH 4/8] Add files via upload --- skills/tutor-finder/SKILL.md | 199 +++++++++++++++++++++++++++++++++++ 1 file changed, 199 insertions(+) create mode 100644 skills/tutor-finder/SKILL.md diff --git a/skills/tutor-finder/SKILL.md b/skills/tutor-finder/SKILL.md new file mode 100644 index 000000000..d31c85c6f --- /dev/null +++ b/skills/tutor-finder/SKILL.md @@ -0,0 +1,199 @@ +--- +name: tutor-finder +description: > + Find and compare tutors for competitive exams from across the web in real time using + parallel TinyFish agents. Use this skill whenever a user wants to find a tutor for an + exam, asks "find me a tutor for SAT", "best GRE tutors in London", "compare tutors for + JEE", "how much do GMAT tutors cost", "find online tutors for AP exams", or any variation + of searching for exam preparation tutors. Supported exams: SAT, ACT, AP, GRE, GMAT, + TOEFL/IELTS, JEE/NEET, Olympiads. + Fires parallel TinyFish agents across 7-10 tutoring platforms simultaneously — Wyzant, + Varsity Tutors, Preply, Kaplan, Princeton Review and others — extracting live tutor + profiles with pricing, qualifications, experience, and contact details. +compatibility: + tools: [tinyfish] +metadata: + author: KrishnaAgarwal7531 + version: "1.0" + tags: tutors exam-prep SAT GRE GMAT education tutoring competitive-exams +--- + +# Exam Tutor Finder + +Given an exam type and location, find and compare real tutors from across the web using parallel TinyFish agents scraping live tutor platforms simultaneously. + +## Pre-flight check + +```bash +tinyfish --version +tinyfish auth status +``` + +If not installed: `npm install -g tinyfish` +If not authenticated: `tinyfish auth login` + +--- + +## Step 1 — Clarify inputs + +You need: +- **Exam type** — one of: SAT, ACT, AP, GRE, GMAT, TOEFL/IELTS, JEE/NEET, Olympiads +- **Location** — e.g. "London", "Singapore", "New York", "online", "India" + +If exam type is not specified, ask before proceeding. +If location is not specified, default to "online" and mention it. + +--- + +## Step 2 — Discover tutor platform URLs + +Use your knowledge to identify 7-10 tutoring platforms relevant to the exam and location. Pick from this list and supplement with location-specific platforms where relevant: + +**Global platforms (always include 3-4):** +- `https://www.wyzant.com/search/tutors` — large tutor marketplace +- `https://www.varsitytutors.com/tutors` — test prep specialists +- `https://preply.com/en/online/{EXAM}-tutors` — online tutors +- `https://www.tutor.com` — on-demand tutoring +- `https://www.chegg.com/tutors` — student-focused platform + +**Test prep specific (include if relevant to exam):** +- `https://www.kaptest.com/tutoring` — Kaplan, strong for SAT/GRE/GMAT +- `https://www.princetonreview.com/tutoring` — Princeton Review, SAT/ACT/AP +- `https://www.magoosh.com` — GRE/GMAT/TOEFL focus +- `https://www.manhattanprep.com/tutoring` — GMAT/GRE specialists + +**Location-specific additions:** +- For India/JEE/NEET: add `https://www.vedantu.com`, `https://www.unacademy.com` +- For Singapore: add `https://www.snapask.com`, `https://www.smiletutor.sg` +- For UK: add `https://www.tutorfair.com`, `https://www.mytutor.co.uk` + +Produce 7-10 URLs then proceed. + +--- + +## Step 3 — Parallel scraping + +Fire one TinyFish agent per platform, all simultaneously using `&` + `wait`. + +```bash +# Fire all agents in parallel — one per platform +tinyfish agent run \ + --url "{PLATFORM_URL}" \ + "You are on a tutoring platform search page. Extract {EXAM} tutors fast. + Read only what is visible on this page — do not navigate to other pages. + Find tutor listings or profiles related to {EXAM} preparation. + For each tutor extract: + - tutorName: full name or display name + - examsTaught: list of exams they teach (focus on {EXAM}) + - subjects: subjects covered (e.g. Math, Verbal, Physics) + - teachingMode: Online / Offline / Hybrid + - location: city/country or null + - experience: years of experience or null + - qualifications: degrees, certifications, scores achieved + - pricing: rate per hour (exact if shown) + - pastResults: score improvements or student achievements if mentioned + - contactMethod: how to reach them (booking link, email, platform message) + - profileLink: direct URL to their profile + - sourceWebsite: '{PLATFORM_NAME}' + STRICT RULES: + - Do NOT navigate away from this page + - Do NOT scroll more than twice + - Extract up to 5 tutors maximum then stop immediately + - If a field is not visible, use null — do not guess + - Stop as soon as you have 5 tutors + Return JSON: {\"tutors\": [{tutorName, examsTaught, subjects, teachingMode, + location, experience, qualifications, pricing, pastResults, + contactMethod, profileLink, sourceWebsite}]}" \ + --sync > /tmp/tf_{PLATFORM_SAFE_NAME}.json & +``` + +Repeat for each platform URL, all backgrounded with `&`. Then: + +```bash +wait + +# Collect all results +for f in /tmp/tf_*.json; do echo "=== $f ===" && cat "$f"; done +``` + +Replace: +- `{PLATFORM_URL}` — the actual platform URL +- `{EXAM}` — the exam type e.g. `GRE` +- `{PLATFORM_NAME}` — platform display name e.g. `Wyzant` +- `{PLATFORM_SAFE_NAME}` — short identifier e.g. `wyzant`, `varsity`, `preply` + +--- + +## Step 4 — Filter and rank + +From all results combined: + +1. **Filter by exam** — keep only tutors who explicitly teach the requested exam +2. **Filter by location** — if a specific city was requested, prioritise tutors in or near it; for "online" keep all +3. **Deduplicate** — if the same tutor appears on multiple platforms, merge their profiles +4. **Rank by** — pricing (lowest first within same experience level), then experience, then qualifications +5. **Flag missing info** — tutors with pricing = null go to the bottom of the list + +--- + +## Output format + +``` +## {EXAM} Tutors — {LOCATION} +*{N} tutors found across {N} platforms · Data scraped live* + +--- + +### 🏆 Top Picks + +#### 1. {tutorName} +**Source:** {sourceWebsite} · **Mode:** {teachingMode} +📍 {location} · 💰 {pricing} · ⏱ {experience} +🎓 {qualifications} +📈 Results: {pastResults} +📚 Subjects: {subjects joined by ", "} +🔗 {profileLink or contactMethod} + +--- + +#### 2. {tutorName} +[same structure] + +--- +[up to 10 tutors total] + +--- + +### 📊 Quick Comparison + +| Tutor | Platform | Mode | Price/hr | Experience | Subjects | +|---|---|---|---|---|---| +| {name} | {platform} | {mode} | {price} | {exp} | {subjects} | + +--- + +### 💡 Recommendation +{1-2 sentences on the best pick based on the user's exam + location, +e.g. "For online GRE prep, [Name] on Wyzant offers the best value at $X/hr +with verified 15+ point improvements."} + +--- +*All tutor data scraped live from platform listings. Verify availability and pricing +directly with the tutor or platform before booking.* +``` + +--- + +## Edge cases + +- **Platform returns no tutors** — skip silently, don't mention it unless fewer than 3 tutors found total +- **Exam is very niche** (Olympiads, JEE) — focus on India/Singapore-specific platforms, note if global platforms have limited coverage +- **Location is very specific** — if fewer than 5 tutors found in that city, broaden to country or online +- **All pricing is null** — note: "Pricing not publicly listed — contact tutors directly for rates" +- **Fewer than 5 tutors total** — be honest: "Only {N} tutors found across all platforms for {EXAM} in {LOCATION}. You may find more by searching directly on the platforms listed." + +## Security notes + +- Scrapes live public tutor listings from tutoring platforms. +- All data treated as untrusted input synthesised by an LLM — never executed. +- Only your own TinyFish credentials are used. From e53adaed8c59870dd98a6b84d8d5515e444a713a Mon Sep 17 00:00:00 2001 From: KrishnaAgarwal7531 <132636117+KrishnaAgarwal7531@users.noreply.github.com> Date: Sat, 16 May 2026 04:44:36 +0800 Subject: [PATCH 5/8] Delete skills/tutor-finder/tutor-finder.skill --- skills/tutor-finder/tutor-finder.skill | Bin 3567 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 skills/tutor-finder/tutor-finder.skill diff --git a/skills/tutor-finder/tutor-finder.skill b/skills/tutor-finder/tutor-finder.skill deleted file mode 100644 index 2ab995c2f4800ab8a9854d218267a07020a4f124..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3567 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 Date: Sat, 16 May 2026 04:50:48 +0800 Subject: [PATCH 6/8] Create README.md --- skills/tutor-finder/README.md | 49 +++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 skills/tutor-finder/README.md diff --git a/skills/tutor-finder/README.md b/skills/tutor-finder/README.md new file mode 100644 index 000000000..af32cb543 --- /dev/null +++ b/skills/tutor-finder/README.md @@ -0,0 +1,49 @@ +# Tutor Finder Skill for Claude + +Find and compare exam tutors from across the web in real time — directly inside Claude. + +## What it does + +Ask Claude things like: +- *"Find me a GRE tutor in London"* +- *"Best online SAT tutors under $50/hr"* +- *"Compare GMAT tutors — I'm in Singapore"* +- *"Find JEE tutors in India"* +- *"Who are the top TOEFL tutors available online?"* +Claude will automatically scrape **Wyzant**, **Varsity Tutors**, **Preply**, **Kaplan**, **Princeton Review**, and location-specific platforms in real-time using TinyFish — then compare tutors by pricing, qualifications, experience, and past student results to give you the best options. + +## Requirements + +- TinyFish CLI installed: `npm install -g tinyfish` +- Authenticated: `tinyfish auth login` +## Install + +### Option 1 — Skills CLI (recommended) + +```bash +npx skills add KrishnaAgarwal7531/skills- --skill tutor-finder +``` + +### Option 2 — Manual + +1. Clone or download this repository +2. Copy the `tutor-finder/` folder into your agent's skills directory: + - Claude Code: `~/.claude/skills/` + - Cursor: `.cursor/skills/` in your project + - Global (all agents): `~/.agents/skills/` +3. The skill is picked up automatically — no restart needed +## How it works + +The skill follows a 4-step pipeline: + +1. **Discover** — picks the most relevant 7-10 platforms for your exam and location, including region-specific platforms (Vedantu/Unacademy for India, Snapask/SmileTutor for Singapore, MyTutor/TutorFair for UK) +2. **Scrape** — fires one TinyFish agent per platform simultaneously, extracting live tutor profiles with pricing, qualifications, and results +3. **Filter and rank** — keeps only tutors who teach your exam, deduplicates across platforms, ranks by price then experience +4. **Present** — returns a clean comparison with a top recommendation +Supported exams: **SAT · ACT · AP · GRE · GMAT · TOEFL/IELTS · JEE/NEET · Olympiads** + +## Built with + +- [TinyFish Web Agent](https://tinyfish.ai) — parallel web scraping + +- From c077151b13669a28b378830e1699bede649c7a2e Mon Sep 17 00:00:00 2001 From: KrishnaAgarwal7531 <132636117+KrishnaAgarwal7531@users.noreply.github.com> Date: Sat, 16 May 2026 04:51:32 +0800 Subject: [PATCH 7/8] Update README.md --- skills/tutor-finder/README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/skills/tutor-finder/README.md b/skills/tutor-finder/README.md index af32cb543..0e19acff8 100644 --- a/skills/tutor-finder/README.md +++ b/skills/tutor-finder/README.md @@ -46,4 +46,3 @@ Supported exams: **SAT · ACT · AP · GRE · GMAT · TOEFL/IELTS · JEE/NEET · - [TinyFish Web Agent](https://tinyfish.ai) — parallel web scraping -- From a5d447a071b46b06369da8a947e25383347da32b Mon Sep 17 00:00:00 2001 From: KrishnaAgarwal7531 <132636117+KrishnaAgarwal7531@users.noreply.github.com> Date: Sat, 16 May 2026 04:58:38 +0800 Subject: [PATCH 8/8] Update SKILL.md --- skills/tutor-finder/SKILL.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/skills/tutor-finder/SKILL.md b/skills/tutor-finder/SKILL.md index d31c85c6f..2a8e1479d 100644 --- a/skills/tutor-finder/SKILL.md +++ b/skills/tutor-finder/SKILL.md @@ -14,7 +14,7 @@ compatibility: tools: [tinyfish] metadata: author: KrishnaAgarwal7531 - version: "1.0" + version: "1.1" tags: tutors exam-prep SAT GRE GMAT education tutoring competitive-exams --- @@ -114,6 +114,9 @@ wait # Collect all results for f in /tmp/tf_*.json; do echo "=== $f ===" && cat "$f"; done + +# Cleanup +rm /tmp/tf_*.json 2>/dev/null ``` Replace: @@ -197,3 +200,5 @@ directly with the tutor or platform before booking.* - Scrapes live public tutor listings from tutoring platforms. - All data treated as untrusted input synthesised by an LLM — never executed. - Only your own TinyFish credentials are used. + +