Agent skill

Pedagogy Review

by pedrohcgs in pedrohcgs/claude-code-my-workflow

Holistic pedagogical review of a lecture deck (.qmd or .tex).

MITAuto-check passedDocuments & Office

Install Pedagogy Review

skills CLI
$ npx skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-review -a claude-code

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

GitHub CLI
$ gh skill install pedrohcgs/claude-code-my-workflow pedagogy-review --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/pedrohcgs/claude-code-my-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/pedagogy-review .claude/skills/pedagogy-review && 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
pedagogy-review
GitHub stars
1.7k
Token cost
~397 tokens
SKILL.md length
128 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Holistic pedagogical review of a lecture deck (.qmd or .tex).

  • Works in 4 steps: Identify the file specified in $ARGUMENTS → Launch the pedagogy-reviewer agent with… → The agent returns its report (the agent… → …
  • User says pedagogy review
  • SKILL.md covers Steps and Important Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pedagogy Review is an agent skill from pedrohcgs/claude-code-my-workflow. Holistic pedagogical review of a lecture deck (.qmd or .tex). Checks narrative arc, prerequisite assumptions, worked examples, notation clarity, and deck-level pacing. Use when user says "pedagogy review", "does this teach well?", "is the flow right?", "will students follow?", "review the narrative", or before teaching a deck for the first time. Read-only; produces a report.

Its SKILL.md is about 400 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 Documents & Office, covering LaTeX. The repository describes itself as: A ready-to-fork Claude Code template for academics using LaTeX/Beamer + R. Multi-agent review, quality gates, adversarial QA, and replication protocols. The licence is MIT.

When your agent uses it

  • User says pedagogy review
  • Does this teach well?
  • Is the flow right?
  • Will students follow?

Example prompts

  • “pedagogy review”
  • “does this teach well?”
  • “is the flow right?”
  • “/pedagogy-review”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Write, Agent, Task

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Identify the file specified in $ARGUMENTS
  2. Launch the pedagogy-reviewer agent with the full file path
  3. The agent returns its report (the agent is read-only); this skill saves it to
  4. Present summary to user

What it can do on your machine

Read from SKILL.md and the folder at commit ae72617. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Write
    • Agent
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Pedagogy Review loads about 397 tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 128 words of instructions outside code blocks.

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

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

The full file from pedrohcgs/claude-code-my-workflow at commit ae72617, republished under its MIT licence (© pedrohcgs). 128 words, ~397 tokens.

Download SKILL.mdSave it as .claude/skills/pedagogy-review/SKILL.md (or your agent's skills folder).
name
pedagogy-review
description
Holistic pedagogical review of a lecture deck (`.qmd` or `.tex`). Checks narrative arc, prerequisite assumptions, worked examples, notation clarity, and deck-level pacing. Use when user says "pedagogy review", "does this teach well?", "is the flow right?", "will students follow?", "review the narrative", or before teaching a deck for the first time. Read-only; produces a report.
allowed-tools
Read, Grep, Glob, Write, Agent, Task
argument-hint
[QMD or TEX filename]
disallowed-tools
Edit, MultiEdit

Pedagogical Review of Lecture Slides

Perform a comprehensive pedagogical review.

Steps

  1. Identify the file specified in $ARGUMENTS

    • If no argument, ask user which lecture to review
    • If just a name, look in Quarto/ or Slides/
  2. Launch the pedagogy-reviewer agent with the full file path

    • The agent checks 13 pedagogical patterns
    • Performs deck-level analysis (narrative arc, pacing, visual rhythm, notation)
    • Considers student perspective (prerequisites, objections)
  3. The agent returns its report (the agent is read-only); this skill saves it to: quality_reports/[FILENAME_WITHOUT_EXT]_pedagogy_report.md

  4. Present summary to user:

    • Patterns followed vs violated (out of 13)
    • Deck-level assessments
    • Critical recommendations (top 3-5)

Important Notes

  • This is a read-only review — no files are edited
  • Focuses on pedagogy not visual layout (use /visual-audit for that)
  • For a combined review, use /slide-excellence instead

© pedrohcgs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/pedagogy-review of pedrohcgs/claude-code-my-workflow.

Open the folder on GitHubat commit ae72617

Compare with similar skills

Pedagogy Review 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.

Pedagogy Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pedagogy Review this skillpedrohcgs/claude-code-my-workflow1.7k—~397Automated safety check: PassMIT
Fill In NotesPolaris-Aeterna/loom-notes167—~975Automated safety check: PassCustom licence
Thesis Figure Skill0xE1337/thesis-figure-skill144—~9.1kAutomated safety check: PassMIT
Latex OutputNorman-bury/research-writing-skill3.4k—~977Automated safety check: PassMIT
Repo Maintenancewengan-li/ncku-thesis-template-latex151—~4.3kAutomated safety check: PassCustom licence
Sci PptShZhao27208/Aut_Sci_Write209—~757Automated safety check: PassMIT

Similar skills

  • Fill In Notes

    Polaris-Aeterna/loom-notes

    Turn a textbook chapter, lecture, or paper into beautiful "fill-in" study notes — written to be READ (clean statements, intuition) yet engineered to be FILLED (blanks, proof skeletons, "your turn"…

    167 GitHub stars~975 tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Thesis Figure Skill

    0xE1337/thesis-figure-skill

    生成学术论文配图:LaTeX/TikZ 代码(结构化图表,直接嵌入论文)或 draw.io XML (技术路线图、汇报配图)。自动按论文领域风格设计,编译验证后交付。

    144 GitHub stars~9.1k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Latex Output

    Norman-bury/research-writing-skill

    A skill your agent uses when user requests LaTeX format output or has provided school/journal LaTeX templates

    3.4k GitHub stars~977 tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • Repo Maintenance

    wengan-li/ncku-thesis-template-latex

    A skill your agent uses for maintaining and releasing this repository.

    151 GitHub stars~4.3k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed
  • Sci Ppt

    ShZhao27208/Aut_Sci_Write

    Generate professional academic PowerPoint (PPTX) presentations from paper PDFs, structured outlines, or plain text.

    209 GitHub stars~757 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Latex Thesis Zh

    brycewang-stanford/Auto-Empirical-Research-Skills

    Chinese LaTeX thesis assistant for existing .tex degree thesis projects (XeLaTeX/LuaLaTeX/latexmk).

    4.6k GitHub stars~1.5k tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed

More from pedrohcgs/claude-code-my-workflow

All 59 skills in this repo
  • Devils Advocate

    pedrohcgs/claude-code-my-workflow

    Adversarial 5-7 question challenge to a deck's pedagogical choices — ordering, prerequisites, cognitive load, motivation.

    1.7k GitHub starsUsed in 2 repos~641 tokens
    Auto-check passed
  • Vaccinate

    pedrohcgs/claude-code-my-workflow

    Qualify a check before it is allowed to clear anything — prove it can detect the failure it is meant to catch.

    1.7k GitHub stars~2.1k tokensUpdated 13 days ago
    Auto-check: notes
  • Compile Latex

    pedrohcgs/claude-code-my-workflow

    Compile a Beamer LaTeX slide deck with XeLaTeX (3 passes + bibtex).

    1.7k GitHub starsUsed in 1 repo~492 tokens
    Auto-check: notes
  • Context Status

    pedrohcgs/claude-code-my-workflow

    Show current context status and session health. An agent skill from pedrohcgs/claude-code-my-workflow.

    1.7k GitHub starsUsed in 1 repo~613 tokens
    Auto-check: notes
  • Capture Environment

    pedrohcgs/claude-code-my-workflow

    Snapshot the computational environment for a replication package — detects the analysis stack (R / Stata / Python) and emits the right lockfiles (renv.lock + sessionInfo.txt, requirements.txt /…

    1.7k GitHub stars~2.8k tokensUpdated 13 days ago
    Auto-check: notes
  • Checkpoint

    pedrohcgs/claude-code-my-workflow

    Save a structured state snapshot before stopping or handing off.

    1.7k GitHub stars~2.8k tokensUpdated 13 days ago
    Auto-check: notes

Questions about Pedagogy Review

What does Pedagogy Review do?

Holistic pedagogical review of a lecture deck (.qmd or .tex). Pedagogy Review is an agent skill from pedrohcgs/claude-code-my-workflow.tex).

When should I use Pedagogy Review?

Pedagogy Review fits situations like: user says pedagogy review; does this teach well?; is the flow right?; will students follow?.

How do I install Pedagogy Review in Claude Code?

Run `npx skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-review -a claude-code`. Or copy the skill folder (.claude/skills/pedagogy-review in pedrohcgs/claude-code-my-workflow) into .claude/skills/pedagogy-review in your project. Claude Code loads it when a task matches its description.

How do I install Pedagogy Review in Codex?

Run `npx skills add pedrohcgs/claude-code-my-workflow --skill pedagogy-review -a codex`. Or copy the skill folder (.claude/skills/pedagogy-review in pedrohcgs/claude-code-my-workflow) into .agents/skills/pedagogy-review in your project. Codex loads it when a task matches its description.

Can I use Pedagogy Review 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 pedrohcgs/claude-code-my-workflow --skill pedagogy-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pedagogy-review, .gemini/skills/pedagogy-review, .github/skills/pedagogy-review and .opencode/skills/pedagogy-review in your project.

What does Pedagogy Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Pedagogy Review is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, Write, Agent, Task.

Does Pedagogy Review 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 Pedagogy Review 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 Pedagogy Review use?

Pedagogy Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pedagogy Review use?

About 397 tokens (SKILL.md is roughly 1.6k 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 Pedagogy Review?

Skills that share tags, products or a category with Pedagogy Review: Fill In Notes (Polaris-Aeterna/loom-notes, 167 stars), Thesis Figure Skill (0xE1337/thesis-figure-skill, 144 stars), Latex Output (Norman-bury/research-writing-skill, 3.4k stars) and Repo Maintenance (wengan-li/ncku-thesis-template-latex, 151 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pedagogy Review?

pedrohcgs (a GitHub user) maintains it in pedrohcgs/claude-code-my-workflow, which has 1,655 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on September 27, 2026.

Source: pedrohcgs/claude-code-my-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.