mcpField
P
problem-solver

problem-solver

github.com/szeyuOther3070 installsUpdated 2d ago
Repository

About problem-solver

A structured problem-solving skill for people who need clear steps and explanations across math, physics, and other problem types. It moves from understanding and planning through execution and verification, with hint, Socratic, and full-solution modes.

Key features

  1. 01Structure understanding, planning, solving, and checking
  2. 02Identify givens, goals, and constraints
  3. 03Offer strategies for common problem types
  4. 04Provide progressive hints and Socratic questions
  5. 05Explain answers with a full worked solution

Use cases

  1. 01Work through algebra or physics problems step by step
  2. 02Translate a word problem into variables and equations
  3. 03Check results by substitution or unit analysis
  4. 04Guide a learner with progressive hints

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/szeyu/vibe-study-skills --skill problem-solver

After installing, type/problem-solverin Claude Code to confirm it loaded.

Details

From the project README

Problem Solver

Structured problem-solving with step-by-step explanations.

Problem-Solving Framework

flowchart LR
    A[Understand] --> B[Plan]
    B --> C[Execute]
    C --> D[Verify]
    D -->|Error| B
    D -->|Correct| E[Explain]

Step 1: Understand (Identify)

Questions to Ask
  1. What is given? List all known information
  2. What is asked? Clearly state what to find
  3. What type of problem? Categorize (algebra, kinematics, etc.)
  4. What are the constraints? Any restrictions or conditions
Template
**Given:**
- [List all known values with units]

**Find:**
- [What we need to calculate]

**Type:**
- [Problem category]

Step 2: Plan (Strategy)

Choose Approach
Problem TypeCommon Strategies
Equation solvingIsolation, substitution, factoring
Word problemsDefine variables, write equations
PhysicsDraw diagram, identify forces/energies
ProofsDirect, contradiction, induction
OptimizationTake derivative, find critical points
Write Steps (Before Executing)
  1. First, I will...
  2. Then, I will...
  3. Finally, I will...

Step 3: Execute (Solve)

Show All Work
**Step 1:** [Action]
[Mathematical work]
= [Result]

**Step 2:** [Action]
[Mathematical work]
= [Result]

**Step 3:** [Final calculation]
[Work]
= [Final answer with units]
Best Practices
  • One step at a time
  • Include units throughout
  • Box or highlight final answer
  • Keep work organized vertically

Step 4: Verify (Check)

Verification Methods
MethodHow to Apply
Plug back inSubstitute answer into original equation
Units analysisCheck dimensions match expected result
EstimateIs the magnitude reasonable?
Alternate methodSolve differently, compare results
Edge casesDoes answer work at extremes?
Template
**Check:**
- Substituting x = [answer] into original equation:
  [show substitution] = [expected value] ✓
- Units: [unit analysis]
- Reasonableness: [is the answer logical?]

Teaching Modes

Hint Mode

Give progressive hints, not full solutions:

Hint 1: "What type of problem is this?" (Identification) Hint 2: "What formula relates these quantities?" (Direction) Hint 3: "Try isolating variable X first." (Specific guidance)

Socratic Mode

Guide through questions:

  • "What do you notice about the given information?"
  • "What principle applies here?"
  • "What would happen if you tried...?"
Full Solution Mode

Complete step-by-step solution with explanations.


Common Problem Patterns

Pattern 1: Solve for X
  1. Simplify both sides
  2. Collect X terms on one side
  3. Isolate X
Pattern 2: Word Problem
  1. Define variables
  2. Translate words to equations
  3. Solve system of equations
  4. Answer in context
Pattern 3: Rate Problem
  1. Identify rate (units per time)
  2. Use: Amount = Rate × Time
  3. Set up equation and solve
Pattern 4: Optimization
  1. Write objective function
  2. Take derivative
  3. Set equal to zero
  4. Solve for critical points
  5. Test for max/min

Answer Template

## Problem
[State the problem]

## Solution

### Understanding
- **Given:** [knowns]
- **Find:** [unknown]

### Approach
[Brief strategy explanation]

### Work
**Step 1:** [action]
[calculation]

**Step 2:** [action]
[calculation]

### Answer
**[Final answer with units]**

### Verification
[Check work]

Comments

Markdown supported