SkillPath: The Course Finder for Any Skill

AI Prompts to Build This

Copy these build prompts into Claude, Cursor, or your AI coding tool. Create a free account to unlock the full research behind them.

1. 1. Project Setup

   Build the weekend MVP of "SkillPath": pick a skill, a level and the hours you have each week, and get an ordered path of existing videos, courses and tutorials. It hosts nothing. Paths that people finish rise in the ranking. Start with one skill, Excel.
   
   Stack: Next.js (App Router), TypeScript, Tailwind, Supabase (Postgres, Row Level Security, Auth with email magic link). The placement is a rule and the ranking is arithmetic, with no model. Deploy on Vercel.
   
   Tables (Row Level Security on; skills, resources and paths are read-only to everyone, a learner reads only their own rows):
   - skills(id, slug, name)
   - resources(id, skill_id, title, url, platform, hours, level, completion_rate)  level is beginner, intermediate or advanced
   - paths(id, skill_id, level, title, resource_ids uuid[])
   - learner_profiles(user_id, hours_per_week)
   - enrollments(id, user_id, path_id, current_index)
   - events(id, user_id, resource_id, type, created_at)  type is started, completed or abandoned
   
   Screens: /quiz, /learn/[skill]/[level], /today, /admin/resources.
   Env vars (names only): NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY (server only).
   
   Do not build: billing, plans or a yearly option, affiliate links or redirects, a model for placement, an editorial CMS, funnels or analytics tools, video hosting.
   Done when: npm run dev starts, you can sign in, and the six tables exist with Row Level Security on.

2. 2. Core Feature

   Build the one feature that proves SkillPath: a path that fits the hours you have, and a ranking that learns from who finishes.
   1. Seed three Excel paths (beginner, intermediate, advanced) with real YouTube, course and documentation links. Open every URL yourself before you save it. Never let a model produce a URL.
   2. The quiz takes skill, level, hours per week (1, 3, 5 or 10) and an optional deadline. Placement picks the path whose level matches.
   3. Group the path into weeks so that no week is longer than 1.2 times the hours per week, keeping the order. Unit test the grouping for 1, 3, 5 and 10 hours.
   4. /today shows the current resource, its estimated minutes and three buttons: Started, Done and "This wasn't for me". Done moves to the next resource. "This wasn't for me" records an abandoned event and swaps in another resource of the same level with fewer hours if one exists. If none exists it says "We'll add one. Skip to the next."
   5. A Recompute button (also callable by a protected route) sets each resource's completion_rate to (completed plus 1) over (completed plus abandoned plus 2). When assembling a path for a new learner, sort the candidates of the right level by completion_rate, highest first, with a stable order.
   6. /admin/resources shows each resource's completion rate and event counts so a curator can remove the ones people abandon.
   Rules: no model touches a URL or a ranking. Show "2 of 3 people finish this" style counts rather than a bare percentage when there are under 10 events.
   Empty state: with no enrollment, show the quiz.
   Done when: the grouping tests pass, placement returns the right level, abandoning swaps in a shorter resource or shows the skip message, and Recompute changes the order for a new learner.

3. 3. Landing Page

   Build a one-page landing site for SkillPath, a learning path for any skill that fits the hours you have.
   Hero: "One skill, one level, one weekly time budget." Sub: "Not a catalog of ten thousand courses. A short ordered path of the best free and paid resources, matched to your level and your week." One button: Join the waitlist.
   Sections: a sample Excel path with its weekly breakdown, how it works in four steps (place yourself, get a path, track what you finish, swap what is not for you), and an FAQ on how resources are chosen (people finish them), which skills come next and whether anything is hosted here (no).
   Waitlist: store the email in a waitlist table in Supabase. No other service.
   Style: Geist, a warm off-white background, near-black type, one blue accent.
   Done when: the page renders on a phone and a submitted email appears in the waitlist table.

4. 4. Branding Package

   Use a design or image tool for this one. A coding agent cannot draw a logo.
   Brand for SkillPath: a wordmark and an icon that suggest a path of three stepping stones.
   Colors: warm off-white, near-black and one blue. Type: Geist, with tabular numbers for hours.
   Deliverables: wordmark, icon, three level chips (beginner, intermediate, advanced) that differ by shape and word as well as color, a resource card style, and one launch graphic.
   Done when: each deliverable is saved in one folder and the level chips are distinguishable without color.