ava-serious-research

Guides machine learning research through question formulation, experiment design, measurement, and verification.

1|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill ava-serious-research-zhiyuan-zhang0206
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ava-serious-research
Source: https://github.com/zhiyuan-zhang0206/Ava/tree/main/ava_builtins/skills/ava-serious-research
Command: npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill ava-serious-research-zhiyuan-zhang0206

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Most ML research fails from broken discipline rather than lack of cleverness: unfalsifiable questions, data leakage, polluted test sets, cherry-picked results, and claims that outrun their evidence. This Skill provides a structured methodology covering the full research lifecycle so that findings survive scrutiny and remain verifiable by a human collaborator. ## Core Features & Use Cases - Full research lifecycle coverage: Question, literature, design, measure, reproduce, present, and verify practices organized into stable principles, evolving practices, and fast-moving AI-era observations. - Leakage and evaluation audits: An 8-category data leakage taxonomy, protocol selection by dataset size (holdout, k-fold, nested CV, bootstrap), and correct statistical tests (McNemar, 5x2cv F-test) for model and algorithm comparison. - Epistemological grounding: Falsifiability, hard-to-vary explanations, anomaly tracking, and honesty principles drawn from Popper, Kuhn, Deutsch, and Feynman. - Use Case: When an experiment shows suspiciously high accuracy, run the leakage audit checklist to verify the split happened before preprocessing, the test set was touched exactly once, and group or temporal structure was respected before believing the number. ## Quick Start Ask the assistant to help design a falsifiable ML experiment with a sealed test set, pre-registered metrics, and a leakage audit before any results are trusted.

Frequently Asked Questions about ava-serious-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a rigorous ML experiment?

Split train, validation, and test sets before any preprocessing and seal the test set. Declare the conclusion type (performance estimation, model selection, or algorithm comparison), pick baselines that isolate one axis at a time, and pre-register the hypothesis, metric, and procedure.

How do I detect data leakage in machine learning experiments?

Run the 8-category leakage audit: check for missing independent test sets, preprocessing before splitting, feature or target leakage, tuning on the test set, group overlap, augmentation before splitting, cross-validation contamination, and implementation leakage like shared global state.

Which statistical test should I use to compare two ML models?

Use McNemar's test (or exact binomial when discordant pairs are under 50) to compare two fixed model instances on one test set. For algorithm-level claims across data splits, use the combined 5x2cv F-test; never use the resampled paired t-test.

What makes a research question worth pursuing?

Write it in three-part form (studying X to find out Y so the audience understands Z) and pass the So-what test. Derive falsifiable hypotheses with a minimal decisive experiment and identify the live tension in the literature the answer would resolve.

When should I use nested cross-validation instead of regular k-fold?

Use nested CV on small or medium datasets whenever hyperparameter tuning occurs, so the inner loop tunes and the outer loop estimates generalization. Reporting the best single-level validation score as generalization performance introduces optimistic bias.

Does this Skill help write and publish research papers?

No. It explicitly excludes paper writing and publication, which are treated as a separate craft. It focuses on doing the research well and making the process legible and verifiable for a human collaborator.