Agent skill

Scholar Init

by joshzyj in joshzyj/open-scholar-skill

Initialize a new research project directory for open-scholar-skill.

Custom licenceAuto-check passed

Install Scholar Init

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

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

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

At a glance

Initialize a new research project directory for open-scholar-skill.

  • Works in 12 steps: 1 — Parse the arguments → 1.5 — Scaffold-first path (slug only, no… → 2 — Invoke the init script → …
  • SKILL.md covers Arguments, Dispatch Table, MODE 1 — Initialize a new… and MODE 2 — Review NEEDS_REVIEW…, plus 7 more sections
  • Calls bash, jq and claude

What it does

Scholar Init is an agent skill from joshzyj/open-scholar-skill. Initialize a new research project directory for open-scholar-skill. Creates the standard layout (data/raw, data/interim, data/processed, materials, output, .claude, logs), copies or symlinks raw files and materials into place, runs a local safety scan on every ingested file, and writes .claude/safety-status.json so the PreToolUse guard knows which files Claude may Read. Four modes: (1) init — create a fresh project from a slug and file list; (2) review — walk through NEEDSREVIEW entries interactively and resolve…

Its SKILL.md is about 8.2k 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-init”

Workflow steps

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

  1. 1 — Parse the arguments
  2. 1.5 — Scaffold-first path (slug only, no files yet)
  3. 2 — Invoke the init script
  4. 2.5 — Write the auto-managed project memory file
  5. 3 — If NEEDS_REVIEW entries exist, go straight into review
  6. 4 — If no NEEDS_REVIEW entries, recommend the next skill
  7. 1 — Locate the sidecar
  8. 2 — Enumerate NEEDS_REVIEW entries
  9. 3 — Walk each entry
  10. 4 — Summary
  11. 1 — Verify we're in a project directory
  12. 2 — For each file, copy/link and scan

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
    • jq
    • claude
    • python3

    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 Init loads about 8.2k tokens when it runs. Until then it costs about 210 tokens; SKILL.md has 2,952 words of instructions outside code blocks.

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

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 2,952 words (~8,158 tokens).

“You are the project onboarding assistant for open-scholar-skill. Your job is to take a researcher from "I have some files on my disk" to "I have a standardized project directory where every file has been scanned and triaged, and Claude…”

— opening of SKILL.md by joshzyj, Custom licence
name
scholar-init
tools
Read, Bash, Write, Edit, Glob
argument-hint
[init <slug> <file1> <file2> ...] | [review] | [add <file1> ...] | [status] — defaults to init if a slug-looking argument is provided, review otherwise
user-invocable
true

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit 6e5ac8e

Compare with similar skills

Scholar Init 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 Init compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scholar Init this skilljoshzyj/open-scholar-skill168—~8.2kAutomated safety check: PassCustom licence
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Hypothesis Generationspacering-net/codeg3.8k15 repos~3.6kAutomated safety check: NotesMIT
Agent ReachPanniantong/Agent-Reach93k1 repos~1.4kAutomated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow83k5 repos~1.3kAutomated safety check: PassMIT
Tavily Web Searchallenpeng0705/EnvoyMesh3.1k4 repos~2.5kAutomated safety check: NotesNone

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.8k GitHub starsUsed in 15 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • 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.

    93k GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed
  • 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.

    83k GitHub starsUsed in 5 repos~1.3k tokens
    Research & ScienceAuto-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 4 repos~2.5k tokens
    Productivity & AutomationAuto-check: notes
  • 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.

    46k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed

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 20 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 20 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 20 days ago
    Auto-check: notes
  • Scholar Causal

    joshzyj/open-scholar-skill

    Comprehensive causal inference toolkit for social science research.

    168 GitHub stars~10k tokensUpdated 20 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 20 days ago
    Auto-check: notes
  • Scholar Eda

    joshzyj/open-scholar-skill

    Conduct exploratory data analysis (EDA) before hypothesis testing.

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

Questions about Scholar Init

What does Scholar Init do?

Initialize a new research project directory for open-scholar-skill. Scholar Init is an agent skill from joshzyj/open-scholar-skill. Initialize a new research project directory for open-scholar-skill.

How do I install Scholar Init in Claude Code?

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

How do I install Scholar Init in Codex?

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

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

What does Scholar Init need to run?

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

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

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

About 8.2k tokens (SKILL.md is roughly 33k 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 Init?

Skills that share tags, products or a category with Scholar Init: NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars), Hypothesis Generation (spacering-net/codeg, 3.8k stars), Agent Reach (Panniantong/Agent-Reach, 93k stars) and GitHub Deep Research (bytedance/deer-flow, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scholar Init?

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.