Skill: ivangdavila/jee (version 1.0.0)

--- name: JEE slug: jee version: 1.0.0 description: Prepare for India's Joint Entrance Examination with progress tracking, weak area analysis, mock test strategy, and IIT/NIT targeting. --- ## When to Use User is preparing for JEE (Main or Advanced), India's engineering entrance exam. Agent becomes a comprehensive prep assistant handling scheduling, tracking, practice generation, and college planning. ## Quick Reference | Topic | File | |-------|------| | Exam structure and scoring | `exam-config.md` | | Progress tracking system | `tracking.md` | | Study methods and strategy | `study-methods.md` | | Stress management and wellbeing | `wellbeing.md` | | IIT/NIT targeting | `targets.md` | | User type adaptations | `user-types.md` | ## Data Storage User data lives in `~/jee/`: ``` ~/jee/ ├── profile.md # Goals, target rank, exam dates, category ├── subjects/ # Per-subject and chapter-wise progress ├── sessions/ # Study session logs ├── mocks/ # Mock test results and analysis ├── mistakes/ # Error log with patterns └── feedback.md # What works, what doesn't ``` ## Core Capabilities 1. **Daily scheduling** — Generate study plans based on exam countdown, weak areas, and user type (fresh/dropper/dual-prep) 2. **Progress tracking** — Monitor scores, time spent, mastery levels across Physics/Chemistry/Math 3. **Weak area identification** — Analyze mock tests to find high-ROI chapters and question types 4. **Mistake pattern detection** — Track recurring errors (conceptual vs silly vs time pressure) 5. **Mock test strategy** — Paper attempt order, time allocation, question selection 6. **IIT/NIT targeting** — Match expected rank to realistic college+branch options by category ## Decision Checklist Before study planning, gather: - [ ] Target exam (JEE Main only, or Main + Advanced) - [ ] Days remaining to each attempt (Main Jan/Apr, Advanced May) - [ ] Category (General, OBC-NCL, SC, ST, EWS) - [ ] Current mock test score range - [ ] User type (11th/12th student, dropper, boards+JEE dual prep) - [ ] Coaching status (Kota, local, online, self-study) ## Critical Rules - **ROI-first** — Prioritize chapters with highest marks-per-hour potential for this user's gaps - **Track everything** — Log sessions, scores, mistakes to `~/jee/` - **Adapt to user type** — Droppers need gap analysis; dual-prep needs board/JEE balance; parents need monitoring dashboards - **Mistake patterns over solutions** — Don't just correct; categorize WHY they're wrong - **Wellbeing matters** — Monitor for burnout, especially droppers; enforce rest when intensity is sustained - **Realistic expectations** — Use historical cutoff data; never overpromise ranks

path: exam-config.md
content: # JEE Exam Configuration

## JEE Main

- **Total Marks:** 300 (100 per subject)
- **Questions:** 90 (30 per subject: 20 MCQ + 10 Numerical)
- **Duration:** 3 hours
- **Attempts:** 2 per year (January + April)
- **Marking:** +4 correct, -1 wrong (MCQ), +4 correct, 0 wrong (Numerical)
- **Purpose:** NIT, IIIT, GFTI admission + JEE Advanced eligibility

## JEE Advanced

- **Total Marks:** 360 (180 per paper)
- **Papers:** 2 papers, 3 hours each
- **Questions:** Variable (MCQ, numerical, matching, paragraph-based)
- **Eligibility:** Top 2.5 lakh from JEE Main
- **Purpose:** IIT admission only

## Syllabus Distribution (Approximate Weightage)

### Physics (Main)
| Topic | Weightage |
|-------|-----------|
| Mechanics | 25% |
| Electrodynamics | 20% |
| Modern Physics | 15% |
| Optics & Waves | 15% |
| Thermodynamics | 10% |
| SHM & Waves | 10% |
| Properties of Matter | 5% |

### Chemistry (Main)
| Topic | Weightage |
|-------|-----------|
| Organic Chemistry | 35% |
| Inorganic Chemistry | 30% |
| Physical Chemistry | 35% |

### Mathematics (Main)
| Topic | Weightage |
|-------|-----------|
| Coordinate Geometry | 20% |
| Calculus | 25% |
| Algebra | 30% |
| Trigonometry | 10% |
| Vectors & 3D | 10% |
| Statistics & Probability | 5% |

## Key Dates (Typical)

- **JEE Main Session 1:** January
- **JEE Main Session 2:** April
- **JEE Advanced:** May (last Sunday)
- **Results:** 10-15 days after exam
- **JoSAA Counseling:** June-July

## Cutoff Trends (General Category, JEE Main)

| Year | Qualifying Percentile |
|------|-----------------------|
| 2023 | 90.7 |
| 2024 | 93.2 |

*Cutoffs vary by category. SC/ST/OBC-NCL have lower cutoffs.*


path: study-methods.md
content: # Study Methods and Strategy

## Spaced Repetition Schedule

| First Study | Review 1 | Review 2 | Review 3 | Review 4 |
|-------------|----------|----------|----------|----------|
| Day 0 | Day 1 | Day 3 | Day 7 | Day 21 |

Agent should track last-studied date per chapter and remind for review.

## Problem-Solving Hierarchy

1. **NCERT** — Foundation (especially Chemistry)
2. **HC Verma / Irodov** — Physics depth
3. **Coaching Material** — Structured practice
4. **Previous Year Questions (PYQ)** — Exam pattern familiarity
5. **Mock Tests** — Full simulation

## Time Allocation by Phase

### Early Prep (12+ months out)
- 60% new concepts
- 30% practice problems
- 10% revision

### Mid Prep (6-12 months)
- 30% new concepts
- 50% practice problems
- 20% revision

### Final Sprint (< 3 months)
- 10% new concepts (only gap-filling)
- 40% mock tests
- 50% revision + mistake review

## Daily Schedule Template

```
06:00 - 06:30  Morning routine
06:30 - 09:00  Subject 1 (strongest when fresh)
09:00 - 09:30  Break + breakfast
09:30 - 12:00  Subject 2
12:00 - 13:00  Lunch + rest
13:00 - 15:30  Subject 3
15:30 - 16:00  Break
16:00 - 18:00  Problem practice (mixed)
18:00 - 19:00  Dinner + break
19:00 - 21:00  Revision / Coaching homework
21:00 - 21:30  Day review + next day planning
```

## Mock Test Strategy

### Before Test
- Sleep 7+ hours
- Light revision only (no new concepts)
- Review personal mistake patterns

### During Test
- **First 10 minutes:** Scan all questions, mark easy ones
- **Attempt order:** Easy → Medium → Hard
- **Time checkpoints:** 60 min per subject (adjust if needed)
- **Last 15 minutes:** Revisit marked questions, transfer answers carefully

### After Test
- Same day: Review wrong answers, categorize mistakes
- Next day: Re-attempt wrong questions without looking at solutions
- Track patterns in `~/jee/mistakes/`

## Chapter Prioritization Matrix

| Weightage | Current Mastery | Priority |
|-----------|-----------------|----------|
| High | Low | 🔴 Urgent |
| High | Medium | 🟡 High |
| High | High | 🟢 Maintain |
| Low | Low | 🟡 Medium |
| Low | Medium/High | ⚪ Low |

Agent should calculate priority score: `Weightage × (100 - Mastery)`

## Dropper-Specific Strategy

1. **Gap Analysis First** — Don't restart from scratch; identify specific weak chapters
2. **New Resources** — Use different books/teachers to avoid "I already know this" trap
3. **Strict Accountability** — Daily targets with consequences
4. **Mental Health Monitoring** — Higher burnout risk; enforce breaks

## Board + JEE Dual Prep

### Overlap Optimization
- Physics: 80% overlap (JEE depth covers boards)
- Chemistry: 70% overlap (add NCERT exact text for boards)
- Mathematics: 75% overlap (boards need step-by-step solutions)

### Mode Switching
- 3 weeks before boards: Switch to board-style (theory, diagrams, derivations)
- After boards: Immediate JEE mode (problem-solving speed)

### Non-Negotiables for Boards
- NCERT line-by-line for Chemistry
- All diagrams from Physics chapters
- Sample papers with board marking scheme


path: targets.md
content: # IIT/NIT Targeting

## College Hierarchy (Engineering)

### Tier 1: IITs (via JEE Advanced)
- Old IITs: Bombay, Delhi, Madras, Kanpur, Kharagpur
- Newer flagships: Roorkee, Guwahati, Hyderabad
- New IITs: Growing in reputation (BHU, Ropar, Indore, etc.)

### Tier 2: NITs (via JEE Main)
- Top NITs: Trichy, Warangal, Surathkal
- Other NITs: 31 total across India

### Tier 3: IIITs, GFTIs (via JoSAA)
- Premier IIITs: Hyderabad, Bangalore, Delhi
- State-funded institutes

## Rank to College Mapping (General Category, Approx)

### JEE Advanced Ranks (2024 reference)
| Rank Range | College Possibilities |
|------------|----------------------|
| < 500 | IIT Bombay/Delhi CSE |
| 500-1000 | Top 5 IIT CSE/EE |
| 1000-2500 | Old IIT core branches |
| 2500-5000 | Old IIT + Top new IIT |
| 5000-10000 | New IITs most branches |
| 10000-15000 | New IIT + Top NIT (if Main rank good) |

### JEE Main Percentile (2024 reference)
| Percentile | NIT Possibilities |
|------------|-------------------|
| 99.5+ | NIT Trichy/Warangal CSE |
| 99.0-99.5 | Top NIT good branches |
| 98.0-99.0 | Mid-tier NIT top branches |
| 95.0-98.0 | NIT lower branches, good IIITs |
| 90.0-95.0 | Lower NITs, state colleges |

## Category-Wise Adjustment

Cutoffs are significantly different by category. Agent should:
1. Always ask for category
2. Use category-specific historical cutoffs
3. Adjust rank predictions accordingly

Approximate advantage (varies by institute):
- OBC-NCL: Cutoff rank 1.3-1.5x General
- SC: Cutoff rank 2-3x General
- ST: Cutoff rank 3-5x General
- EWS: Similar to General with small buffer

## Branch Value Assessment

### Placement-Oriented Ranking
1. Computer Science (CSE)
2. Electrical/Electronics (EE/ECE)
3. Mathematics & Computing
4. Data Science / AI-ML
5. Mechanical
6. Chemical
7. Civil
8. Others (varies by institute)

### Factors Beyond Placement
- Interest alignment
- Research opportunities
- Campus culture
- City/location
- Alumni network

## JoSAA Choice Filling Strategy

### Principles
1. **Dream choices first** — Even if unlikely, list them
2. **Safe choices must exist** — At least 5-10 choices you're guaranteed
3. **Branch vs College tradeoff** — Decide early: top branch at lower college OR lower branch at top college
4. **Reporting strategy** — Freeze if satisfied; Float for upgrades; Slide for branch upgrade in same institute

### Common Mistakes
- Not filling enough choices (fill 50+ if possible)
- Unrealistic expectations (only listing top IITs)
- Not understanding Freeze/Float/Slide
- Missing document deadlines

## Backup Planning

### If JEE doesn't go as planned:
- BITS Pilani (BITSAT) — Private but excellent
- VIT, SRM, Manipal — Good backup options
- State entrance exams (MHT-CET, KCET, etc.)
- Board percentage for state quota

### Timeline
- BITSAT: May-June
- VIT: April-May
- State exams: April-June
- Counseling: Parallel with JoSAA

## Financial Planning

| College Type | Approximate Total Cost (4 years) |
|--------------|----------------------------------|
| IIT | ₹8-10 lakh |
| NIT | ₹4-6 lakh |
| BITS | ₹20-25 lakh |
| VIT/SRM | ₹12-18 lakh |

Scholarships available at IITs/NITs based on family income.


path: tracking.md
content: # Progress Tracking System

## Profile Setup (`~/jee/profile.md`)

```markdown
## Basic Info
- Target: JEE Main + Advanced
- Category: General / OBC-NCL / SC / ST / EWS
- User Type: 12th Student / Dropper / 11th Start
- Coaching: Allen Kota / FIITJEE / Online / Self-study

## Target Scores
- JEE Main Target Percentile: 99+
- JEE Advanced Target Rank: AIR < 5000
- Board Percentage Target: 90%+ (if applicable)

## Exam Dates
- JEE Main Session 1: 2026-01-XX
- JEE Main Session 2: 2026-04-XX
- JEE Advanced: 2026-05-XX
- Board Exams: 2026-02-XX to 2026-03-XX
```

## Chapter-Wise Tracking (`~/jee/subjects/`)

Structure:
```
subjects/
├── physics/
│   ├── mechanics.md
│   ├── electrodynamics.md
│   └── ...
├── chemistry/
│   ├── organic/
│   ├── inorganic/
│   └── physical/
└── mathematics/
    ├── calculus.md
    ├── algebra.md
    └── ...
```

Each chapter file:
```markdown
## Rotational Mechanics
- Status: In Progress / Complete / Revision Needed
- Mastery: 65%
- Last Practiced: 2026-01-10
- Weak Areas: Moment of inertia problems, rolling motion

### Practice Log
| Date | Source | Problems | Correct | Time |
|------|--------|----------|---------|------|
| 01-10 | HC Verma | 25 | 18 | 90m |
| 01-08 | PYQ 2020-24 | 15 | 10 | 45m |
```

## Mock Test Logging (`~/jee/mocks/`)

```markdown
## Mock Test - 2026-01-15

### Scores
- Physics: 72/100
- Chemistry: 65/100
- Mathematics: 58/100
- Total: 195/300
- Percentile Estimate: 96.5

### Time Analysis
- Physics: 55 min (target: 60)
- Chemistry: 70 min (target: 60) ⚠️
- Mathematics: 55 min (target: 60)

### Error Analysis
| Subject | Conceptual | Silly | Time Pressure | Unattempted |
|---------|------------|-------|---------------|-------------|
| Physics | 3 | 2 | 1 | 2 |
| Chemistry | 5 | 1 | 3 | 0 |
| Math | 4 | 3 | 2 | 1 |
```

## Mistake Pattern Tracking (`~/jee/mistakes/`)

```markdown
## Recurring Mistakes

### Sign Errors (Physics)
- Count: 12 this month
- Contexts: Potential energy, work done, lens formula
- Action: Write sign convention on rough sheet before starting

### Unit Conversion (Chemistry)
- Count: 8 this month
- Contexts: molarity ↔ molality, kJ ↔ J
- Action: Circle units in question before calculating

### Formula Confusion (Math)
- Count: 6 this month
- Contexts: Integration by parts direction, determinant expansion
- Action: Create formula revision sheet for last 30 min before exam
```

## Weekly Review Template

```markdown
## Week of 2026-01-08

### Chapters Covered
- [ ] Rotational Mechanics (revision)
- [x] Electrochemistry (new)
- [ ] Probability (partial)

### Mock Performance
- Test 1: 185/300 → 195/300 improvement
- Weak: Organic mechanisms, Probability

### Next Week Focus
1. Complete Probability
2. Organic mechanisms drill (20 problems/day)
3. Full mock Saturday
```


path: user-types.md
content: # User Type Adaptations

## User Type Detection

Ask early:
1. Are you currently in 11th, 12th, or taking a drop year?
2. Are you also preparing for board exams?
3. Do you have coaching or self-studying?
4. (If parent) Are you the student or a parent/guardian?

## Fresh Student (11th/12th)

### Characteristics
- Learning concepts for first time
- Balancing school + coaching + self-study
- May underestimate JEE difficulty initially
- Time is the main advantage

### Agent Adaptations
- Full syllabus coverage plans
- School-coaching-self study balance
- Build strong fundamentals before shortcuts
- Monthly milestone targets
- Board integration if in 12th

### Key Metrics
- Chapter completion rate
- Concept clarity (not just problem solving)
- Consistency of study hours

## Dropper (Gap Year)

### Characteristics
- Already seen full syllabus once
- Previous attempt data available
- Higher psychological pressure
- Need surgical improvement, not restart

### Agent Adaptations
- Start with gap analysis of previous year
- Focus 70% time on weak areas
- Track mistake patterns from before
- Stricter daily accountability
- Mental health monitoring priority
- Different resources to avoid "I know this" trap

### Key Metrics
- Improvement over previous scores
- Weak area closure rate
- Consistency (dropout risk is high)

## Dual-Prep (Board + JEE)

### Characteristics
- Managing two different exam styles
- Time constraints especially Feb-April
- Need mode-switching between board and JEE prep
- Practicals/projects eat into time

### Agent Adaptations
- Overlap mapping: which topics serve both
- Phase-based time allocation (JEE-heavy → Board-heavy → JEE again)
- Board-specific quick revision (NCERT exact, diagrams, derivations)
- Practical/project time blocking
- Flexible schedules around board dates

### Key Metrics
- Both JEE mock scores AND board practice scores
- Time balance between preparations
- Overlap efficiency (dual-purpose study sessions)

## Parent/Guardian

### Characteristics
- Want visibility without micromanaging
- Often don't understand JEE specifics
- Worried about mental health + results
- Need actionable insights, not data dumps

### Agent Adaptations
- Weekly summary reports (not daily interrogation)
- Translate scores to rank/college possibilities
- "How to support" guidance
- Alert only when patterns are concerning
- College admission guidance for decision-making

### Key Outputs
- Progress trajectory graphs
- Comparison to historical benchmarks
- "Questions to avoid asking" list
- College prediction based on current trajectory

## Tutor/Coaching Teacher

### Characteristics
- Managing 50-200+ students
- Need batch-level analytics
- Identify at-risk students early
- Administrative burden (DPPs, tests, PTMs)

### Agent Adaptations
- Multi-student dashboard
- Batch-wise weakness identification
- Auto-generated PTM reports
- DPP completion tracking
- Early warning for struggling students
- Performance comparison across batches

### Key Outputs
- Batch average tracking
- Individual student progress cards
- At-risk student list
- PTM talking points per student

## Coaching Variations

### Kota-Style Residential
- Full-time focus, high intensity
- Social isolation risk
- Need external mental health support
- Daily 10+ hour schedules

### Local Coaching + School
- Time split challenge
- Evening/weekend coaching
- School commitments can't be ignored
- Need efficient time use

### Online Coaching
- Flexibility but distraction risk
- Self-discipline critical
- Need active engagement tracking
- Can work from anywhere

### Self-Study
- Maximum flexibility
- Highest discipline required
- Resource selection important
- Need external accountability
- Mock tests crucial for benchmarking


path: wellbeing.md
content: # Stress Management and Wellbeing

## Warning Signs to Monitor

### Academic Warning Signs
- Mock scores dropping 3+ tests in a row
- Skipping scheduled study sessions frequently
- Not submitting coaching DPPs
- Avoiding specific subjects entirely

### Mental Health Warning Signs
- Sleep changes (too much or too little)
- Social withdrawal
- Statements like "I'm wasting my life" or "What's the point"
- Comparing excessively with peers
- Physical symptoms: headaches, stomach issues, fatigue

## Agent Response Protocol

### Mild Stress
- Acknowledge the pressure
- Adjust schedule to reduce load
- Suggest short breaks
- Celebrate recent small wins

### Moderate Stress
- Reduce daily targets by 30%
- Enforce rest days
- Connect with peer support
- Review whether expectations are realistic

### Severe Stress
- Pause academic demands
- Encourage talking to parents/counselors
- Provide helpline information
- Do not push performance metrics

## Dropper-Specific Mental Health

### Unique Challenges
- Watching friends go to college
- Family expectations ("ek aur saal de diya")
- Isolation during prep
- Shame from previous "failure"

### Support Strategies
- Acknowledge the difficulty explicitly
- Frame the year as investment, not punishment
- Track progress to show growth (not just absolute scores)
- Connect with other droppers if possible
- Weekly parent updates to reduce interrogation

## Break Protocols

### Micro-breaks (every 90 min)
- 5-10 minutes
- Walk, stretch, water
- NO screens

### Daily breaks
- Minimum 2 hours non-study time
- Physical activity (even 20 min walk)
- One hobby/enjoyment activity

### Weekly rest
- One half-day completely off
- Social interaction
- Outdoor time if possible

### Burnout recovery
- 2-3 days reduced intensity
- Light revision only
- Sleep priority
- No guilt messaging

## Sleep Protocol

| Days to Exam | Minimum Sleep |
|--------------|---------------|
| 30+ days | 7 hours |
| 7-30 days | 7 hours (non-negotiable) |
| 1-7 days | 8 hours |
| Exam day | 7-8 hours, wake 3+ hours before exam |

## Parent Communication

### What Parents Need
- Weekly progress summaries
- Context for score fluctuations
- What NOT to say to the student
- When to be concerned

### Agent Can Generate
- Parent update reports
- Comparison with historical trajectories
- "Questions to avoid" list
- "How to support" suggestions

## Emergency Resources (India)

- **iCall:** 9152987821
- **Vandrevala Foundation:** 1860-2662-345 (24/7)
- **NIMHANS:** 080-46110007
- **Kota-specific support:** Local coaching helplines


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)