skills/by-role/researcher/hypothesis-framing/SKILL.md
Write or refine a research hypothesis. Use when the user says "write a hypothesis", "frame my hypothesis", "is my hypothesis testable", "null and alternative hypothesis", "research hypothesis", "refine my hypothesis", "hypothesis statement", "H0 and H1", "operationalize my hypothesis", "turn my research question into a hypothesis", or needs to convert a research question or intuition into a falsifiable, testable hypothesis with clear variables and predictions - even if they don't explicitly say "hypothesis".
npx skillsauth add qa-aman/claude-skills hypothesis-framingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Based on Research Design (Creswell & Creswell) and Research Methodology: A Step-by-Step Guide (Ranjit Kumar). A hypothesis is a falsifiable prediction about the relationship between variables. Kumar's rule: a hypothesis that cannot be proven wrong is not a hypothesis - it is a belief. Creswell's standard: every hypothesis must specify the population, the variables, and the predicted direction of the relationship.
The test: can a different researcher, given only the hypothesis, design a study to test it?
Start with the question before writing the hypothesis. The hypothesis is the answer you predict the study will find.
Research question: [what are you trying to find out?]
Domain: [field of study]
Context: [setting, population, conditions]
Prior evidence: [what makes this prediction plausible? what is it based on?]
A good research question has:
Variables must be measurable. For each variable, define how it is measured:
Independent variable (IV): [what you manipulate or group by]
Operationalization: [how exactly it is measured or defined]
Levels/values: [if categorical: list levels. if continuous: range and units]
Dependent variable (DV): [what you measure as an outcome]
Operationalization: [specific measure, scale, or instrument]
Units: [e.g. seconds, score 1-7 on Likert scale, binary yes/no]
Control variables: [variables held constant or statistically controlled]
[variable]: [how controlled]
Potential confounds: [variables that could explain results without being your IV]
[confound]: [how you plan to address it]
A well-formed hypothesis has three components:
Format: "In [population], [IV manipulation or condition] will result in [predicted change in DV direction] compared to [control or comparison condition]."
Examples:
H₀ (Null hypothesis): There is no significant difference/relationship between [IV] and [DV]
in [population].
H₁ (Alternative hypothesis - directional): [IV] is associated with [higher/lower/more/less]
[DV] in [population].
Or (non-directional):
H₁ (Alternative hypothesis): There is a significant difference in [DV] between [IV
conditions] in [population].
Use directional H₁ when: prior theory or evidence strongly predicts the direction
Use non-directional H₁ when: this is exploratory or direction is genuinely uncertain
Explain what mechanism you expect to be driving the predicted effect:
Theoretical basis: [What theory or prior finding predicts this result?]
Mechanism: [Why would X cause Y? What is the causal pathway?]
Prior evidence: [1-3 citations showing related findings that support this prediction]
Boundary conditions: [Under what conditions do you expect this to hold? Under what conditions might it not?]
Run through these questions before finalizing:
If any answer is "no" or "I'm not sure," revise before proceeding to study design.
1. Research question disguised as hypothesis Bad: "Does social media use affect mental health?" Good: "Adolescents aged 13-17 who use social media for more than 3 hours/day will report significantly higher levels of anxiety (GAD-7 scale) than those who use social media for less than 1 hour/day."
2. Unmeasurable variables Bad: "Students who feel more motivated will learn better." Good: "Students in the gamified learning condition (IV) will score higher on the Unit 4 end-of-module test (DV, 20 items, % correct) than students in the standard condition."
3. No stated direction Bad: "There will be a relationship between exercise and mood." Good: "Adults who engage in 30 minutes of aerobic exercise 5 days per week will report lower depressive symptoms (PHQ-9) than sedentary controls after 8 weeks."
4. Hypothesis without mechanism Bad: Hypothesis states a prediction with no theory behind it. Good: Include the theoretical mechanism (e.g., cognitive load theory predicts..., self-determination theory suggests...) so reviewers can evaluate the rationale.
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.