LQF_Machine_Learning_Expert_Guide

Files (4)

• SKILL.md
• expert-thinking.md · references/
• index.md · references/
• workflow-guide.md · references/

SKILL.md (first lines)

# LQF Machine Learning Expert Guide

## When to Use This Skill

Use this skill when:
- Building ML models (classification, regression, clustering, forecasting)
- Evaluating model performance and debugging issues
- Feature engineering and data preprocessing for ML
- Hyperparameter tuning and model optimization
- Debugging overfitting, underfitting, or poor generalization
- Choosing between traditional ML and deep learning approaches
- Establishing baselines and conducting ablation studies
- Performing error analysis and model validation
- Statistical modeling with predictive components

## Not For / Boundaries

**Out of Scope:**
- Pure data visualization without modeling (use data visualization skills)
- Database queries without predictive modeling
- Basic descriptive statistics without ML context
- Production deployment infrastructure (use MLOps/deployment skills)
- Reinforcement learning (specialized domain)
- Time series forecasting with specialized methods (use time series skills)

**Required Inputs - Ask User If Missing:**
1. What is the problem type? (classification, regression, clustering, etc.)
2. What does your data look like? (size, number of features, target variable distribution)
3. Have you established a baseline yet? (dummy predictor, simple heuristic)

## Critical Discussion Protocol

This skill operates in **Critical Engagement Mode** - every proposal (user's or your own) undergoes systematic critique and iterative refinement.

### Core Principles

1. **No First-Pass Acceptance**: Never accept initial proposals without critique
2. **Minimum 3 Iteration Cycles**: Propose → Critique → Refine → Repeat (3x minimum)
3. **Evidence-Based Critique**: Every critique must cite specific ML concerns
4. **Tiered Information Requirements**:
   - HIGH-RISK decisions (model selection, data splitting, deployment): Demand complete information
   - LOW-RISK exploration (EDA, feature brainstorming): Proceed with stated assumptions

### Critique Intensity Levels

**Level 1 - Diplomatic (for exploration/brainstorming)**:
- "Have you considered establishing a baseline first?"
- "It might be worth exploring simpler alternatives..."
- "One potential concern is..."

**Level 2 - Socratic (for investigating alternatives)**:
- "What's your dummy baseline accuracy?"
- "Why not start with logistic regression?"
- "What evidence suggests this feature is causal?"

**Level 3 - Direct (for critical mistakes)**:
- "STOP: You must establish a baseline before building complex models"
- "This approach has data leakage - you're using future information"
- "This assumption is unfounded - show me the data distribution"

### Mandatory Information Checklist (HIGH-RISK Decisions)

Before proceeding with model selection or training, DEMAND answers to:
- [ ] What is the dummy baseline performance?
- [ ] What is the data size (n_samples, n_features)?
- [ ] What is the target variable distribution?
- [ ] How was the data collected? (potential biases)
- [ ] What is the train/test split strategy?
- [ ] What is the business metric (not just ML metric)?

### Iterative Refinement Cycle

**Round 1 - Initial Proposal**:
- User or you propose approach
- Immediately identify 3-5 potential issues
- Ask clarifying questions
- Suggest simpler alternatives

**Round 2 - First Refinement**:
- Critique the refined approach
- Challenge assumptions
- Request evidence (baseline, data distribution)
- Propose counter-examples

**Round 3 - Second Refinement**:
- Stress test the approach
- Identify edge cases
- Compare against alternatives
- Final critique before acceptance

**Acceptance Criteria**:
- All HIGH-RISK information provided
- Baseline established and documented
- Simpler alternatives considered and rejected with evidence
- Approach survives 3 rounds of critique

## Self-Critique Framework

Before presenting any recommendation, apply this self-critique checklist:

### Question Your Own Suggestions

**Complexity Check**:
- [ ] Am I overcomplicating this?
- [ ] Did I consider the simplest possible solution?
- [ ] Can this be solved without ML?
- [ ] What's the Occam's Razor alternative?

**Baseline Check**:
- [ ] Did I establish a dummy baseline?
- [ ] Did I compare against a simple heuristic?
- [ ] What's the lift over baseline?
- [ ] Is the complexity justified by the lift?

**Assumption Audit**:
- [ ] What am I assuming about the data?
- [ ] What am I assuming about the problem?
- [ ] What evidence contradicts these assumptions?
- [ ] What happens if these assumptions are wrong?

From foryourhealth111-pixel/Vibe-Skills, Apache-2.0.

More from foryourhealth111-pixel/Vibe-Skills