teach-from-paper

teach-from-paper is a skill for Claude Code from pedrohcgs/claude-code-my-workflow. It costs 102 tokens per session (1,751 once invoked), scanned A, original, MIT.

A teaching-planning workflow that turns one research paper into a lecture outline, key results with explanations, a slide plan, discussion questions, and an exercise brief.

In plain words
What is it for?
Use it to prepare a lecture, reading group, job-market practice talk, or problem set based on a paper.
Why use it?
It helps instructors extract the material most worth teaching instead of treating the paper as a presentation script.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; positional $N argument.

Good fit Use it to prepare a lecture, reading group, job-market practice talk, or problem set based on a paper.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/pedrohcgs/claude-code-my-workflow/teach-from-paper
About the project

claude-code-my-workflow is a forkable setup for using Claude Code to produce and review academic papers, slides, data analyses, and replication packages. Researchers use its agents, skills, rules, hooks, and quality checks to coordinate these tasks and verify their results. The catalogue entries define the reusable workflow components for Claude Code.

pedrohcgs/claude-code-my-workflow · 1,569 stars · on GitHub · psantanna.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add pedrohcgs/claude-code-my-workflow --skill teach-from-paper
Clone the repo
git clone --depth 1 https://github.com/pedrohcgs/claude-code-my-workflow

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for teach-from-paper

README.md
[![agentmods](https://agentmods.dev/badge/skills/pedrohcgs/claude-code-my-workflow/teach-from-paper/github.svg)](https://agentmods.dev/skills/pedrohcgs/claude-code-my-workflow/teach-from-paper)
Your own site
<a href="https://agentmods.dev/skills/pedrohcgs/claude-code-my-workflow/teach-from-paper"><img src="https://agentmods.dev/badge/skills/pedrohcgs/claude-code-my-workflow/teach-from-paper/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for teach-from-paper

Your own site · 80×15
<a href="https://agentmods.dev/skills/pedrohcgs/claude-code-my-workflow/teach-from-paper"><img src="https://agentmods.dev/badge/skills/pedrohcgs/claude-code-my-workflow/teach-from-paper.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,751 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 3 findings, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Agent Snooping · line 106
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
  • medium Agent Snooping · line 107
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
  • medium Agent Snooping · line 108
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00102 $0.01751
Opus 5 $0.00051 $0.00875
Sonnet 5 $0.00020 $0.00350
Haiku 4.5 $0.00010 $0.00175

Measured 5d ago against content hash 484374933e8d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

teach-from-paper scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/teach-from-paper/SKILL.md · 117 lines

How it starts

The opening of the file, as written. The whole thing — 117 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Teach From Paper

Convert one research paper into a ready-to-build teaching package: a lecture outline, a shortlist of teachable results with the intuition spelled out, a slide skeleton, discussion questions, and an exercise brief. The deliverable is an outline and a brief — not a finished deck; the slide skeleton is shaped to hand straight to /create-lecture, and the exercise brief to /scaffold-exercises.

When to use

  • You have a paper (PDF, .tex, .md) and a slot to teach it — a lecture, a reading group, a job-market practice talk.
  • You want the teachable core extracted and pitched to a level, not a generic summary.
  • You're prepping the plan for a deck and want /create-lecture to do the drafting.

Not for: literature surveys across many papers (use /lit-review); refereeing the paper's correctness (use /review-paper); drafting the actual Beamer slides (use /create-lecture).

Inputs

  • $0 — path to the paper.
Format How to read it
.tex, .qmd, .md, .txt Read directly with the Read tool.
.pdf TMP=$(mktemp -t paper).txt && pdftotext "$0" "$TMP" (poppler-utils), then Read/Grep "$TMP".

If extraction fails or the tool is missing, ask the user for a plain-text version and stop. The full paper goes in the context window (1M) — read it end-to-end before extracting; do not skim the abstract and guess.

Phases

Phase 0: Read the Paper + Set Audience Level (Pre-Flight Report)

Read the paper start to finish. Then resolve the audience level and time budget — from --level / --minutes if given, otherwise ask once. Echo a Pre-Flight Report before extracting:

## Pre-Flight Report
**Paper:** [title, authors, year]
**One-line thesis:** [the paper's central claim in your words]
**Audience level:** undergrad | phd | seminar   (drives notation depth + which proofs survive)
**Time budget:** N minutes (~N/2 slides)
**Prerequisites assumed:** [concepts students must already have]
**Running example candidate:** [the paper's application that can thread the lecture]

Read the full file on GitHub · 117 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 117 lines · 102 tokens per session scan A 484374933e8d

Subscribe to this mod's changes

teach-from-paper is a skill published in the GitHub repository pedrohcgs/claude-code-my-workflow (1,569 stars, last pushed 15d ago), licensed MIT. It adds 102 tokens to every session and 1,751 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

paper-workflow

A staged workflow for producing an evidence-based economics or social-science research paper, from choosing a topic through submission. It coordinates existing tools and analysis options, including Python, Stata, and R.

brycewang-stanford/Paper-WorkFlow · 262 tokens

r-econometrics

Run IV, DiD, and RDD analyses in R with proper diagnostics.

brycewang-stanford/Auto-Empirical-Research-Skills · 20 tokens

econ-management-paper-polish

A writing and editing guide for papers in economics, management, finance, accounting, marketing, information systems, public administration, and related fields.

linkingoscar/econ-management-paper-polish · 83 tokens

econometrics-phd-level

A guide to econometrics, the use of statistics to study relationships in data, based on a 12-part Korean lecture series. It routes questions to explanations of topics such as regression, panel data, instrumental variables, and causal comparisons.

jayjeo/econometrics-phd-level-skill · 201 tokens

did-causal

Use this Skill when the user needs to estimate causal treatment effects using difference-in-differences (DID) designs: two-way fixed effects (TWFE) regression, parallel trends pre-testing, Callaway-Sant'Anna staggered adoption estimator, and Goodman-Bacon decomposition. Covers both Python (linearmodels) and R (did…

xjtulyc/awesome-rosetta-skills · 75 tokens

principal-agent

A Chinese-language guide based on the principal-agent idea: the person who owns a decision or its result may have different incentives from someone acting on another person's behalf. It applies this lens to jobs, companies, and partnerships.

kangarooking/cangjie-skill · 134 tokens