Agent skill

Scholar Qual

by joshzyj in joshzyj/open-scholar-skill

Qualitative research methods toolkit for social sciences. An agent skill from joshzyj/open-scholar-skill.

Custom licenceAuto-check passed

Install Scholar Qual

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

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

GitHub CLI
$ gh skill install joshzyj/open-scholar-skill scholar-qual --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-qual .claude/skills/scholar-qual && 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-qual
GitHub stars
168
Token cost
~16k tokens
SKILL.md length
4,173 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
Custom licence

At a glance

Qualitative research methods toolkit for social sciences. An agent skill from joshzyj/open-scholar-skill.

  • SKILL.md covers Arguments, Setup, Dispatch Table and Step 0 — Scholar-init Sidecar…, plus 5 more sections
  • Calls python3, bash and jq; needs ANTHROPIC_API_KEY and OPENAI_API_KEY

What it does

Scholar Qual is an agent skill from joshzyj/open-scholar-skill. Qualitative research methods toolkit for social sciences. Covers codebook development, grounded theory coding (open, axial, selective), Braun & Clarke reflexive thematic analysis, systematic content analysis (Krippendorff), LLM-assisted qualitative coding with human validation (Lin & Zhang 2025 framework), mixed-methods integration, and inter-coder reliability assessment. Produces codebooks, coded datasets, code-to-quote mappings, thematic maps, reliability reports, and publication-ready qualitative write-ups…

Its SKILL.md is about 16k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Open scholar skill, a claude code plugin, for academic research.

Example prompts

  • “/scholar-qual”

Requirements

  • Python 3

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:

    • python3
    • bash
    • jq

    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 these keys or tokens, usually read from environment variables:

    • ANTHROPIC_API_KEY
    • OPENAI_API_KEY

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

Context cost

Scholar Qual loads about 16k tokens when it runs. Until then it costs about 146 tokens; SKILL.md has 4,173 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~146
When it runs · the whole SKILL.md, loaded when a task matches
~16k

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 4,173 words (~15,690 tokens).

“You are an expert qualitative methodologist trained in grounded theory (Glaser & Strauss; Strauss & Corbin; Charmaz), reflexive thematic analysis (Braun & Clarke), systematic content analysis (Krippendorff), and LLM-assisted coding (Lin & Zhang 2025). You help social science researchers design…”

— opening of SKILL.md by joshzyj, Custom licence
name
scholar-qual
tools
Read, WebSearch, Write, Bash
argument-hint
[workflow: codebook|open-coding|axial|selective|thematic|content|llm-coding|mixed|reliability] [data: transcript path or 'paste below'] [optional: approach…
user-invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/scholar-qual of joshzyj/open-scholar-skill.

Open the folder on GitHubat commit 6e5ac8e

Compare with similar skills

Scholar Qual 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 Qual compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scholar Qual this skilljoshzyj/open-scholar-skill168—~16kAutomated safety check: PassCustom licence
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Agent ReachPanniantong/Agent-Reach94k—~1.4kAutomated safety check: PassMIT

Similar skills

  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    94k GitHub stars~1.4k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Tavily Web Search

    allenpeng0705/EnvoyMesh

    Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content.

    3.1k GitHub starsUsed in 3 repos~2.5k tokens
    Productivity & AutomationAuto-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 Qual

What does Scholar Qual do?

Qualitative research methods toolkit for social sciences. An agent skill from joshzyj/open-scholar-skill. Scholar Qual is an agent skill from joshzyj/open-scholar-skill. Qualitative research methods toolkit for social sciences.

How do I install Scholar Qual in Claude Code?

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

How do I install Scholar Qual in Codex?

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

Can I use Scholar Qual 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-qual -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-qual, .gemini/skills/scholar-qual, .github/skills/scholar-qual and .opencode/skills/scholar-qual in your project.

What does Scholar Qual need to run?

Going by SKILL.md and its folder, Scholar Qual needs the command-line tools its instructions call (python3, bash and jq) and credentials named ANTHROPIC_API_KEY and OPENAI_API_KEY. Our summary lists: Python 3.

Does Scholar Qual 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 Qual 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 Qual use?

Scholar Qual 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 Qual use?

About 16k tokens (SKILL.md is roughly 63k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Scholar Qual?

Skills that share tags, products or a category with Scholar Qual: NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars), Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars) and Nature Paper Card (Yuan1z0825/nature-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scholar Qual?

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.