Paper Reader Heilmeier logo

Paper Reader Heilmeier

Community
RealZYZhang
paper-reader-heilmeier

Read a research paper end to end and produce a single Heilmeier-style analysis that doubles as both summary and critique. Use this skill whenever the user shares a research paper (PDF upload, arXiv link, arXiv ID, DOI, or pasted paper text) and asks anything that resembles "read this", "summarize this paper", "what does this paper do", "analyze this paper", "give me a Heilmeier analysis", "review this paper", or simply drops a paper into the chat with little explanation. Trigger this skill even when the user does not explicitly say "Heilmeier" — any request to digest, summarize, review, or critically assess an academic paper should activate it. Do NOT use this skill for non-academic articles, blog posts, or news.

Overview

PublisherRealZYZhang
Repositorypaper-reader-heilmeier
Skill namepaper-reader-heilmeier
Stars
92
Forks
1
Bundled files
1
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 1 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by RealZYZhang on GitHub. Read the source before you install it.

Installation

Install the Paper Reader Heilmeier AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/RealZYZhang/paper-reader-heilmeier/tree/main
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/RealZYZhang/paper-reader-heilmeier.git \
  .claude/skills/paper-reader-heilmeier
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Paper Reader Heilmeier in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Paper Reader Heilmeier on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Paper Reader Heilmeier is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Paper Reader + Heilmeier's Catechism

This skill produces a single inline markdown response: a modified Heilmeier's Catechism analysis that absorbs the structured summary into the catechism itself. There is no separate summary section.

Step 1: Acquire the paper

Always read the paper fresh. Never rely on memory of the paper, even if the title looks familiar.

Input typeAction
PDF in /mnt/user-data/uploads/Read it via the appropriate tool (see the pdf-reading skill if available).
arXiv link, arXiv ID, or DOIUse web_fetch on the arXiv abstract page, then on the PDF/HTML version for full text.
Pasted text in the chatUse directly.
Just a title with no linkAsk the user for a link or upload before proceeding. Do not guess the paper.

If the paper is long, prioritize: abstract, introduction, method/theory, experiments, conclusion. Skim related work only if useful for question 2.

Step 2: Answer the modified Heilmeier questions

Answer each of the seven questions below as a labeled subsection, in order. For each question, the rules differ on (a) whether your own evaluation is allowed and (b) whether external citations are allowed. Read the rules carefully before writing each subsection.

Question 1. What are you trying to do?

Open with a one-sentence statement of the paper's contribution written for a smart non-specialist, with absolutely no jargon. Ban acronyms and any technical term a first-year undergrad would not know. If a term of art is unavoidable, define it parenthetically in plain words. Then add one or two sentences expanding the objective in slightly more technical language.

Opinions allowed: no. Stay faithful to the paper. External citations allowed: no.

Question 2. What is the problem, how is it done today, and what are the limits of current practice?

Describe the real-world or scientific problem the paper addresses, then give a brief overview of how the field handles it at the time of the paper, and what the limitations are. This is meant to be a self-contained landscape paragraph, not a literature review. Cover the main competing approaches in plain prose.

Opinions allowed: a small amount, only if it sharpens the framing of the limits. External citations allowed: no. Do not search for or cite outside sources here. Just give an overview from the paper and your general knowledge of the field.

Question 3. What is new in the approach, including core idea, math, and method, and why does the paper claim it will succeed?

This is the technical heart of the response and absorbs what would otherwise be a "method" summary. Cover, in this order:

  1. The central technical move that distinguishes the paper from prior work.
  2. The key mathematical objects and formulation. Include the main equation or two, define every symbol you introduce, use display math with \left and \right for brackets, keep inline math on one line, and prefer standard LaTeX notation.
  3. How the proposed method actually solves the problem mechanically.
  4. The paper's own claim about why the approach will succeed.

Opinions allowed: NO. This subsection is strictly about what the paper says and proposes. Save your evaluation for questions 4, 5, and 6. External citations allowed: no.

Question 4. Who cares? If successful, what difference does it make?

Discuss the impact: which communities benefit, what becomes possible, and whether this paper has actually shifted the field since publication.

Opinions allowed: yes. This is one of the questions where your judgment matters most. External citations allowed: yes, and encouraged when assessing post-publication impact (adoption by other groups, follow-up papers, deployment). Every external citation must come from a web_search or web_fetch you actually ran in this turn.

Question 5. What are the risks?

Cover both the risks the paper itself acknowledges and the ones you see independently. Be concrete: contamination, reward hacking, failure modes, narrow benchmarks, scaling, reproducibility.

Opinions allowed: yes. External citations allowed: yes, when an outside source materially supports a risk claim.

Question 6. How much will it cost?

Interpret as compute, data, engineering effort, or deployment cost, depending on the paper. State which interpretation you are using. Pull whatever numbers the paper provides (token counts, batch sizes, GPU hours, data volumes) and translate into a rough sense of "what would it take to reproduce this".

Opinions allowed: yes, especially for the "what would it take to reproduce" framing. External citations allowed: yes. Be careful not to conflate this paper's costs with related work by the same authors. If you cite a cost figure, state exactly which paper or model that figure refers to.

Question 7. What are the experiments and results?

Cover the experimental setup (benchmarks, datasets, baselines, metrics, ablations) and the headline results. This subsection answers "what are the criteria for success and did the paper meet them". Note any conspicuous gap between claims and evidence.

Opinions allowed: small amount, only for noting gaps between claims and evidence. External citations allowed: no.

Attribution rules (apply across all questions)

The user must always be able to tell paper content apart from your own analysis. In any subsection where opinions are allowed, prefix every personal judgment with one of: "In my opinion,", "My analysis is that,", "My read is," or an equivalent first-person marker. Never blur the line. In the subsections where opinions are not allowed (questions 1 and 3), do not use these markers at all.

Citation rules (apply across all questions)

Every external citation in your response must come from a web_search or web_fetch you actually ran in this turn. No citations from memory. There is exactly one carve-out: if the paper itself cites a prior work and you are exactly repeating what the paper says about that cited work, you may mention it without a web search. The moment you add anything beyond what the paper literally says, search and cite the search result.

When you do search, cite the source inline so the user can follow up.

Length and pacing

Keep the response tight. The user has explicitly asked for fast, non-redundant output. Do not repeat the same point under multiple questions. Aim for the shortest response that fully answers all seven questions; if a question genuinely has little to say for a particular paper, keep its subsection to two or three sentences.

Format and readability

Return everything as a single inline markdown response. Use one top-level header naming the paper, then a ## header per question.

Optimize for scannability, not prose density. The reader is a researcher skimming on a screen, not reading an essay. Apply these rules:

  1. Short paragraphs. 2 to 4 sentences per paragraph, almost never more. If a paragraph grows past 4 sentences, split it or convert part of it into a list.
  2. Use bullets and numbered lists wherever the content is naturally enumerable. Risks, ablations, benchmark results, baselines, contributions, follow-up works, design choices, costs, failure modes — all of these should be lists, not prose.
  3. Lead each question with a one-sentence answer in plain text, then expand. The reader should be able to skim only the lead sentences and still get the gist of the whole analysis.
  4. Bold the key terms, numbers, and named methods sparingly. Things like headline benchmark scores, named algorithms, dataset sizes, the central technical move. Do not bold whole sentences; bold the noun phrase that carries the meaning.
  5. Italics for paper-section markers (e.g., Method., Data pipeline., Ablations.) when grouping content inside a question.
  6. Math stays in display blocks with surrounding sentences, but symbol-heavy explanations should be broken into bullets too when there are more than 3 symbols to define.

Math formatting rules (still mandatory)

  • Use \left and \right for display brackets.
  • Keep inline math on one line.
  • Define every symbol you introduce.
  • Prefer standard LaTeX notation.
  • For curly-brace delimiters, use \lbrace and \rbrace, not \{ and \}. GitHub's markdown processor strips the backslash from \{ before the math is rendered, causing KaTeX errors. \lbrace and \rbrace are escape-free and render correctly everywhere.

No dashes

Do not use em-dashes or en-dashes anywhere. Use commas, semicolons, parentheses, or new sentences instead.

What not to do

  • Do not produce a separate "Summary" section before the catechism. The catechism is the summary.
  • Do not put personal evaluation in questions 1 or 3.
  • Do not invent numbers, baselines, or experimental results that are not in the paper.
  • Do not insert citations from memory.
  • Do not conflate this paper with related work by the same authors when stating costs or results.
  • Do not analyze a paper you have not actually read this turn.

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Paper Reader Heilmeier AI skill do?

Read a research paper end to end and produce a single Heilmeier-style analysis that doubles as both summary and critique. Use this skill whenever the user shares a research paper (PDF upload, arXiv link, arXiv ID, DOI, or pasted paper text) and asks anything that resembles "read this", "summarize this paper", "what does this paper do", "analyze this paper", "give me a Heilmeier analysis", "review this paper", or simply drops a paper into the chat with little explanation. Trigger this skill even when the user does not explicitly say "Heilmeier" — any request to digest, summarize, review, or...

Why use Paper Reader Heilmeier on TypingMind?

Because you install it once and use it with any model. Paper Reader Heilmeier is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Paper Reader Heilmeier in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/RealZYZhang/paper-reader-heilmeier/tree/main. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Paper Reader Heilmeier?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Paper Reader Heilmeier?

As many as you like. As long as a model supports skills, you can use Paper Reader Heilmeier with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Paper Reader Heilmeier AI skill free?

Yes. It is published on GitHub by RealZYZhang under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇