Agent skill

Scholar Polish

by joshzyj in joshzyj/open-scholar-skill

Personalize and refine academic manuscript writing style by injecting distinctive authorial micro-patterns (tiny topos).

Custom licenceAuto-check passedResearch & Science

Install Scholar Polish

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

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

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

At a glance

Personalize and refine academic manuscript writing style by injecting distinctive authorial micro-patterns (tiny topos).

  • Works in 9 steps: 1 — Read and Segment → 2 — Pattern Detection → 3 — Frequency Analysis → …
  • Tasks that involve Brand voice and tone
  • SKILL.md covers ABSOLUTE RULES, Arguments, Dispatch Table and Setup, plus 3 more sections
  • Calls bash and pandoc

What it does

Scholar Polish is an agent skill from joshzyj/open-scholar-skill. Personalize and refine academic manuscript writing style by injecting distinctive authorial micro-patterns (tiny topos). Detects and replaces generic hedging stacks, formulaic transitions, symmetrical parallelism, over-enumeration, and other flat prose patterns with natural, voice-rich academic writing. Three modes: SCAN (diagnose style patterns), REWRITE (apply fixes), FULL (scan + rewrite). Preserves argument structure, citations, and technical content while elevating prose to a distinctive, polished authorial…

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

It sits in Research & Science, covering Brand voice and tone, Citation management and Scientific writing. The repository describes itself as: Open scholar skill, a claude code plugin, for academic research.

When your agent uses it

  • Tasks that involve Brand voice and tone
  • Tasks that involve Citation management
  • Tasks that involve Scientific writing

Example prompts

  • “/scholar-polish”

Workflow steps

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

  1. 1 — Read and Segment
  2. 2 — Pattern Detection
  3. 3 — Frequency Analysis
  4. 4 — Produce Scan Report
  5. 1 — Set Intensity Threshold
  6. 2 — Apply Fixes by Tell Type
  7. 3 — Human Micro-Pattern Injection (Tiny Topos)
  8. 4 — Consistency Check
  9. 5 — Produce Diff Summary

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
    • pandoc

    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 Polish loads about 12k tokens when it runs. Until then it costs about 135 tokens; SKILL.md has 4,681 words of instructions outside code blocks.

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

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,681 words (~12,011 tokens).

“You are an expert academic prose editor who specializes in detecting generic, flat writing patterns and replacing them with a distinctive, natural authorial voice. You understand the difference between correct academic writing and natural academic writing — and your job…”

— opening of SKILL.md by joshzyj, Custom licence
name
scholar-polish
tools
Read, Bash, Write, Grep, Glob
argument-hint
[scan|rewrite|full] [file-path], e.g., 'full output/drafts/draft-intro-redlining-2026-03-20.md'
user-invocable
true

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit 6e5ac8e

Compare with similar skills

Scholar Polish 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 Polish compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scholar Polish this skilljoshzyj/open-scholar-skill168—~12kAutomated safety check: PassCustom licence
Research Paper Writerailabs-393/ai-labs-claude-skills4552 repos~2.4kAutomated safety check: PassMIT
Inno Paper WritingLigphiDonk/Oh-my--paper739—~2.9kAutomated safety check: PassMIT
Cg Paper Writingjaccen/Awesome-Gaussian-Skills161—~4.4kAutomated safety check: PassApache-2.0
Citation Verification GuideGalaxy-Dawn/claude-scholar5.7k2 repos~1.9kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence

Similar skills

  • Research Paper Writer

    ailabs-393/ai-labs-claude-skills

    Creates formal academic research papers following IEEE/ACM formatting standards with proper structure, citations, and scholarly writing style.

    455 GitHub starsUsed in 2 repos~2.4k tokens
    Research & ScienceAuto-check passed
  • Inno Paper Writing

    LigphiDonk/Oh-my--paper

    Creates formal academic research papers following IEEE/ACM formatting standards with proper structure, citations, and scholarly writing style.

    739 GitHub stars~2.9k tokensUpdated 5 mo ago
    Research & ScienceAuto-check passed
  • Cg Paper Writing

    jaccen/Awesome-Gaussian-Skills

    Academic paper writing for 3D vision, computer graphics, CAD, and 3D understanding.

    161 GitHub stars~4.4k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Citation Verification Guide

    Galaxy-Dawn/claude-scholar

    Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.

    5.7k GitHub starsUsed in 2 repos~1.9k tokens
    Research & ScienceAuto-check passed
  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated today
    Research & ScienceAuto-check passed
  • Academic Humanizer

    AIScientists-Dev/academic-humanizer

    Improve the clarity and voice of AI-assisted academic writing (papers, theses, rebuttals) and funding proposals (NSF Project Summary/Description, NIH Specific Aims): preserve scholarly conventions…

    1.9k GitHub starsUsed in 1 repo~4.2k 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 22 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 22 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 22 days ago
    Auto-check: notes
  • Scholar Causal

    joshzyj/open-scholar-skill

    Comprehensive causal inference toolkit for social science research.

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

    joshzyj/open-scholar-skill

    Conduct exploratory data analysis (EDA) before hypothesis testing.

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

Questions about Scholar Polish

What does Scholar Polish do?

Personalize and refine academic manuscript writing style by injecting distinctive authorial micro-patterns (tiny topos). Scholar Polish is an agent skill from joshzyj/open-scholar-skill. Personalize and refine academic manuscript writing style by injecting distinctive authorial micro-patterns (tiny topos).

When should I use Scholar Polish?

Scholar Polish fits situations like: tasks that involve Brand voice and tone; tasks that involve Citation management; tasks that involve Scientific writing.

How do I install Scholar Polish in Claude Code?

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

How do I install Scholar Polish in Codex?

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

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

What does Scholar Polish need to run?

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

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

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

About 12k tokens (SKILL.md is roughly 48k 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 Polish?

Skills that share tags, products or a category with Scholar Polish: Research Paper Writer (ailabs-393/ai-labs-claude-skills, 455 stars), Inno Paper Writing (LigphiDonk/Oh-my--paper, 739 stars), Cg Paper Writing (jaccen/Awesome-Gaussian-Skills, 161 stars) and Citation Verification Guide (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scholar Polish?

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.