Agent skill

Scholar Hypothesis

by joshzyj in joshzyj/open-scholar-skill

Develop theoretically grounded hypotheses and draft publication-ready Theory sections.

Custom licenceAuto-check passedAI & LLM Engineering

Install Scholar Hypothesis

skills CLI
$ npx skills add joshzyj/open-scholar-skill --skill scholar-hypothesis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install joshzyj/open-scholar-skill scholar-hypothesis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/joshzyj/open-scholar-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/scholar-hypothesis .claude/skills/scholar-hypothesis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
scholar-hypothesis
GitHub stars
168
Token cost
~11k tokens
SKILL.md length
3,452 words
Files
2 (incl. references)
Skills in repo
30
Repo updated
First seen
Licence
Custom licence

At a glance

Develop theoretically grounded hypotheses and draft publication-ready Theory sections.

  • Works in 9 steps: Dispatch → Frame the Explanatory Puzzle → Select Theoretical Framework(s) → …
  • Tasks that involve Speech recognition and synthesis
  • SKILL.md covers Arguments, Step 0: Dispatch, Step 1: Frame the Explanatory… and Step 2: Select Theoretical…, plus 7 more sections
  • Calls bash

What it does

Scholar Hypothesis is an agent skill from joshzyj/open-scholar-skill. Develop theoretically grounded hypotheses and draft publication-ready Theory sections. Covers puzzle framing (5 types: anomaly, contradiction, extension, mechanism, scope), framework selection from 25+ sociological/linguistic theories (stratification, networks, culture, institutional, life course, analytical sociology via Coleman's boat + Hedström DBO, intersectionality, racial formation, social movements, status characteristics, signaling, non-Western: guanxi/Ubuntu/coloniality/world-systems), mechanism chain…

Its SKILL.md is about 11k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/theory-frameworks.md`).

It sits in AI & LLM Engineering, covering Speech recognition and synthesis and Dispute resolution. The repository describes itself as: Open scholar skill, a claude code plugin, for academic research.

When your agent uses it

  • Tasks that involve Speech recognition and synthesis
  • Tasks that involve Dispute resolution

Example prompts

  • “/scholar-hypothesis”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Dispatch
  2. Frame the Explanatory Puzzle
  3. Select Theoretical Framework(s)
  4. Specify the Mechanism Chain
  5. Derive and Formalize Hypotheses
  6. Map Competing Predictions
  7. Build the Text-Based DAG / Causal Graph
  8. Write the Theory Section
  9. Save Output

What it can do on your machine

Read from SKILL.md and the folder at commit 6e5ac8e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Scholar Hypothesis loads about 11k tokens when it runs, and up to ~23k if it reads all its reference files. Until then it costs about 260 tokens; SKILL.md has 3,452 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~260
When it runs · the whole SKILL.md, loaded when a task matches
~11k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~23k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 3,452 words (~11,041 tokens).

“You are an expert sociologist helping develop theoretically grounded, testable hypotheses and theory sections for publication-quality papers. Your output must meet the standards of ASR, AJS, Demography, Nature Human Behaviour, Science Advances, or Nature Computational Science.”

— opening of SKILL.md by joshzyj, Custom licence
name
scholar-hypothesis
tools
Write, Bash, WebSearch, Read
argument-hint
[phenomenon or RQ] — optionally: [design type: quant/qual/comp/computational] [journal: ASR/AJS/Demography/NHB/NCS/SciAdv] [theory hint]
user-invocable
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in .claude/skills/scholar-hypothesis of joshzyj/open-scholar-skill.

  • SKILL.md
  • references/theory-frameworks.md

Open the folder on GitHubat commit 6e5ac8e

Compare with similar skills

Scholar Hypothesis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Scholar Hypothesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scholar Hypothesis this skilljoshzyj/open-scholar-skill168—~11kAutomated safety check: PassCustom licence
Bio Causal Genomics Mediation AnalysisGPTomics/bioSkills1.2k2 repos~8.6kAutomated safety check: PassMIT
Bio Causal Genomics Mediation Analysisaipoch/medical-research-skills2k1 repos~2.6kAutomated safety check: PassMIT
Multi AI Researchmajiayu000/spellbook287—~2kAutomated safety check: PassMIT
Asr Literature Positioningfranklee16/academic-research-skills2231 repos~798Automated safety check: PassNone
Jcr Tables Figuresfranklee16/academic-research-skills2231 repos~1.1kAutomated safety check: PassNone

Similar skills

  • Decompose total effects into direct and indirect paths through mediators using mediation, CMAverse 4-way, HIMA/HIMA2 high-dimensional, BAMA, two-step / MVMR mediation, or double-ML medDML.

    1.2k GitHub starsUsed in 2 repos~8.6k tokens
    Research & ScienceAuto-check passed
  • Bio Causal Genomics Mediation Analysis

    aipoch/medical-research-skills

    Decompose genetic effects into direct and indirect paths through mediating variables using the mediation R package.

    2k GitHub starsUsed in 1 repo~2.6k tokens
    Research & ScienceAuto-check passed
  • Multi AI Research

    majiayu000/spellbook

    Parallel multi-AI cross-validation research workflow (大版本). An agent skill from majiayu000/spellbook.

    287 GitHub stars~2k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Asr Literature Positioning

    franklee16/academic-research-skills

    A skill your agent uses when positioning an American Sociological Review (ASR) manuscript against the literature so it reads as a broad sociological contribution rather than a subfield note.

    223 GitHub starsUsed in 1 repo~798 tokens
    AI & LLM EngineeringAuto-check passed
  • Jcr Tables Figures

    franklee16/academic-research-skills

    A skill your agent uses when building the exhibits for a Journal of Consumer Research (JCR) manuscript — study-summary tables, mediation/moderation results, interaction and spotlight plots…

    223 GitHub starsUsed in 1 repo~1.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Whisper Speech Recognition

    Orchestra-Research/AI-Research-SKILLs

    Transcribes audio with OpenAI's Whisper: 99 languages, translation to English, language detection, six model sizes and word-level timestamps, from Python or the CLI.

    13k GitHub starsUsed in 7 repos~1.9k tokens
    AI & LLM EngineeringAuto-check: notes

More from joshzyj/open-scholar-skill

All 30 skills in this repo
  • Scholar Annotate

    joshzyj/open-scholar-skill

    Turn unstructured text into validated, structured variables at corpus scale with LLMs: codebook design, dev/gold-set construction, DSPy prompt optimization, a hard reliability gate (Cohen κ ≥ 0.70)…

    168 GitHub stars~4.6k tokensUpdated 21 days ago
    Auto-check passed
  • Scholar Auto Research

    joshzyj/open-scholar-skill

    Stable, deterministic social-science research-paper pipeline from idea or data to verified manuscript, citations, replication package, and final md/docx/tex/pdf outputs.

    168 GitHub stars~21k tokensUpdated 21 days ago
    Auto-check passed
  • Scholar RAG

    joshzyj/open-scholar-skill

    Build and query a local vector database + GraphRAG over your entire reference library (Zotero or a PDF folder) for literature review.

    168 GitHub stars~7.4k tokensUpdated 21 days ago
    Auto-check: notes
  • Scholar Causal

    joshzyj/open-scholar-skill

    Comprehensive causal inference toolkit for social science research.

    168 GitHub stars~10k tokensUpdated 21 days ago
    Auto-check passed
  • Scholar Data

    joshzyj/open-scholar-skill

    Comprehensive open data directory (100+ datasets across 14 categories) with auto-fetch capability, plus data collection instrument design, variable dictionaries, data management, IRB materials, and…

    168 GitHub stars~23k tokensUpdated 21 days ago
    Auto-check: notes
  • Scholar Eda

    joshzyj/open-scholar-skill

    Conduct exploratory data analysis (EDA) before hypothesis testing.

    168 GitHub stars~12k tokensUpdated 21 days ago
    Auto-check passed

Questions about Scholar Hypothesis

What does Scholar Hypothesis do?

Develop theoretically grounded hypotheses and draft publication-ready Theory sections. Scholar Hypothesis is an agent skill from joshzyj/open-scholar-skill. Develop theoretically grounded hypotheses and draft publication-ready Theory sections.

When should I use Scholar Hypothesis?

Scholar Hypothesis fits situations like: tasks that involve Speech recognition and synthesis; tasks that involve Dispute resolution.

How do I install Scholar Hypothesis in Claude Code?

Run `npx skills add joshzyj/open-scholar-skill --skill scholar-hypothesis -a claude-code`. Or copy the skill folder (.claude/skills/scholar-hypothesis in joshzyj/open-scholar-skill) into .claude/skills/scholar-hypothesis in your project. Claude Code loads it when a task matches its description.

How do I install Scholar Hypothesis in Codex?

Run `npx skills add joshzyj/open-scholar-skill --skill scholar-hypothesis -a codex`. Or copy the skill folder (.claude/skills/scholar-hypothesis in joshzyj/open-scholar-skill) into .agents/skills/scholar-hypothesis in your project. Codex loads it when a task matches its description.

Can I use Scholar Hypothesis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add joshzyj/open-scholar-skill --skill scholar-hypothesis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scholar-hypothesis, .gemini/skills/scholar-hypothesis, .github/skills/scholar-hypothesis and .opencode/skills/scholar-hypothesis in your project.

What does Scholar Hypothesis need to run?

Going by SKILL.md and its folder, Scholar Hypothesis needs the command-line tools its instructions call (bash).

Does Scholar Hypothesis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Scholar Hypothesis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Scholar Hypothesis use?

Scholar Hypothesis has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Scholar Hypothesis use?

About 11k tokens (SKILL.md is roughly 44k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to Scholar Hypothesis?

Skills that share tags, products or a category with Scholar Hypothesis: Bio Causal Genomics Mediation Analysis (GPTomics/bioSkills, 1.2k stars), Bio Causal Genomics Mediation Analysis (aipoch/medical-research-skills, 2k stars), Multi AI Research (majiayu000/spellbook, 287 stars) and Asr Literature Positioning (franklee16/academic-research-skills, 223 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scholar Hypothesis?

joshzyj (a GitHub user) maintains it in joshzyj/open-scholar-skill, which has 168 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on September 18, 2026.

Source: joshzyj/open-scholar-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.