Skip to content

Apollo887/student-ops

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Student-Ops

Colleges use AI to filter applicants. I just gave students AI to choose colleges. Open-source AI college & career planning pipeline.

CI License Claude Code Node.js Playwright


What is Student-Ops

Student-Ops turns any AI coding CLI into a full college & career planning command center. Instead of juggling spreadsheets, essay drafts, and deadline calendars, you get an AI-powered pipeline that:

  • Evaluates universities with structured 10-dimension scoring (academic fit, financial fit, admissions odds, career outcomes, culture, location, and more)
  • Calibrates reach/match/safety using real stats from Common Data Sets — not hype
  • Drafts essays in YOUR voice — Common App personal statement, supplementals, scholarship essays, activity descriptions
  • Analyzes financial aid packages — net price, debt projection, appeal potential
  • Hunts scholarships — effort-to-odds scoring, eligibility matching
  • Tracks everything — unified tracker for universities, scholarships, internships, and jobs
  • Manages deadlines — FAFSA, Common App, scholarship deadlines all in one dashboard
  • Researches career paths — "if I study X, what opens up?"
  • Evaluates internships — for undergrads optimizing summer plans

It's the sister project to career-ops — adapted from landing the right job to choosing the right path.

This is NOT an admissions consultant selling you on schools. Student-ops is a filter — it helps you find the few fits worth your time. The system discourages low-fit applications and flags financially untenable aid packages. Your time is valuable, and so is the admissions officer's.


Who it's for

  • High schoolers applying to college — score schools, draft essays, find scholarships, compare aid packages
  • Undergrads planning internships, transfers, or grad school
  • Recent grads navigating the first job hunt or grad school decision
  • Parents helping their student stay organized (though the student should drive)
  • Counselors overwhelmed by caseloads — student-ops can't replace you, but it can handle the grunt work

Quick Start

1. Install

git clone https://github.com/santifer/student-ops.git
cd student-ops
npm install

2. Open in Claude Code

claude .

3. Onboarding

On first run, Claude will walk you through:

  1. Stage — high school, undergrad, or recent grad?
  2. Academics — GPA, test scores, coursework
  3. Goals — target fields, dream schools, what excites you
  4. Constraints — financial budget, geography, deal-breakers

This populates config/profile.yml — your single source of truth.

4. Start evaluating

Paste a school URL or name:

"Evaluate MIT for me"

Or use slash commands:

  • /student-ops university — score a school
  • /student-ops essay — draft or refine essays
  • /student-ops scholarship — evaluate a scholarship
  • /student-ops financial — analyze an aid letter
  • /student-ops deadline — see what's due
  • /student-ops tracker — status of all applications
  • /student-ops compare — side-by-side comparison
  • /student-ops — menu

Core Modes

university — Full School Evaluation

10-block evaluation (A–J):

Block Dimension
A School profile summary
B Academic fit
C Admissions fit (reach/match/safety)
D Financial fit
E Career outcomes
F Campus culture
G Location
H Program depth (internships, research, study abroad)
I Growth opportunities
J Gut fit

Produces a weighted score, reach/match/safety classification, and a report in reports/.

essay — The Differentiator

Handles every kind of college essay:

  • Common App personal statement (brainstorm → outline → draft → voice pass → cut)
  • "Why [School]?" supplementals
  • "Why this major?"
  • Activity descriptions (150 chars)
  • Community / diversity essays
  • Scholarship essays

Rules:

  • Never fabricates claims
  • Preserves student voice (not Claude's)
  • Flags clichés ruthlessly
  • Multiple drafts — no one-shot finals

financial — Aid Package Analyzer

  • Parses aid letters (grants, loans, work-study, scholarships)
  • Calculates true net price and 4-year cost
  • Projects debt + monthly payments vs. realistic starting salary
  • Drafts appeal letters when there's leverage
  • Compares multiple packages side-by-side

scholarship — Effort-to-Odds Scoring

  • Eligibility match against profile
  • Fit score
  • Effort-to-odds ratio (so you don't waste hours on low-probability awards)
  • Priority recommendation (High / Medium / Low / Skip)

And more

internship · career-path · compare · deadline · tracker · apply · scan · batch · pipeline


Data Contract (Critical)

User Layer (NEVER auto-updated — your stuff):

  • config/profile.yml
  • modes/_profile.md
  • essays/, reports/, aid-letters/, data/, portals.yml

System Layer (auto-updatable — student-ops stuff):

  • CLAUDE.md, modes/_shared.md, other mode files
  • Scripts, templates

When you customize scoring weights, archetypes, narrative, or preferences, Claude writes to modes/_profile.md — so system updates never overwrite your work.


Ethics

This system is designed for self-discovery and fit. It will:

✅ Help you find schools that genuinely match your goals and budget ✅ Draft essays in your voice, from your real experiences ✅ Tell you when a school is financially untenable ✅ Calibrate admissions odds honestly (no "safety school" inflation) ✅ Discourage the shotgun approach (20+ reaches)

It will NOT:

❌ Submit applications for you (you review and submit) ❌ Fabricate achievements or experiences ❌ Pretend your 1200 SAT is competitive for a 5% admit rate school ❌ Encourage debt you can't service ❌ Write essays that misrepresent who you are


File Structure

student-ops/
├── CLAUDE.md                    # System brain
├── config/
│   ├── profile.example.yml
│   └── profile.yml              # Your data
├── modes/
│   ├── _shared.md               # Shared system context
│   ├── _profile.md              # Your customizations
│   ├── university.md            # Core eval mode
│   ├── essay.md                 # Essay assistant
│   ├── scholarship.md
│   ├── financial.md
│   ├── internship.md
│   ├── career-path.md
│   ├── compare.md
│   ├── deadline.md
│   ├── tracker.md
│   ├── apply.md
│   ├── scan.md
│   ├── pipeline.md
│   └── batch.md
├── templates/
│   ├── states.yml
│   └── portals.example.yml
├── data/
│   ├── applications.md          # Master tracker
│   ├── pipeline.md              # Inbox
│   └── scan-history.tsv
├── reports/                     # Evaluation reports
├── essays/                      # Essay drafts
├── aid-letters/                 # Financial aid docs
├── output/                      # Generated PDFs
├── scan.mjs                     # Portal scanner
├── merge-tracker.mjs            # Tracker merge
├── verify-pipeline.mjs          # Data integrity
└── update-system.mjs            # Version check

Requirements

  • Node.js 18+
  • Claude Code (or any compatible AI coding CLI)
  • Playwright (installed via npm install) — for verifying school pages
  • Optional: College Scorecard API key (free from data.gov) for university scanning

Contributing

PRs welcome! See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

Common contributions:

  • New mode templates (e.g., gap year evaluation, grad school mode)
  • Translations (modes/es/, modes/fr/, etc.)
  • Portal scanners for specific regions
  • Scoring calibration data

License

MIT. See LICENSE.


Credits

Built on the architectural patterns of career-ops by @santifer.

If student-ops helps you get into your dream school or land your first internship — tell us. Issues and stories welcome.

About

AI college & career planning pipeline for students — evaluate schools, draft essays, compare aid packages, hunt scholarships. Built on Claude Code.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

4 stars

Watchers

2 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors