skills.rest
TDAA-Go
TDAA-GoOFFICIAL
Explore all skills by this author →
GitHub

homework-report

Generate a teacher-facing Typst PDF report from grading data.

7|3|Updated May 8, 2026
Search Tags:#pdf#feedback#report#grading#teacher#typst#submissions
One-click install
npx skills add https://github.com/TDAA-Go/TDAA-Go --skill homework-report
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: homework-report
Source: https://github.com/TDAA-Go/TDAA-Go/tree/main/.claude/skills/homework-report
Command: npx skills add https://github.com/TDAA-Go/TDAA-Go --skill homework-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Use after grade-homework to produce a teacher-facing Typst PDF report that shows each student's submission images side-by-side with their per-question marks, feedback, and flags. Triggers on phrases like "generate the grading report", "build a report from the marks", "make a PDF with the marked homework".

Core Features & Use Cases

  • After grade-homework has written grades.csv and grades/feedback/*.md, generate a single shareable PDF report for review, return to students, or archive.
  • Outputs: report/images/<student>-N.jpg, report/grading_report.typ, report/grading_report.pdf. Prerequisites: typst and pdftoppm.

Quick Start

Run the builder to generate the report from the graded submissions.

Frequently Asked Questions about homework-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a PDF grading report from student submissions and feedback?▼

This Skill builds a Typst PDF grading report by compiling per-student submission images, scores, and markdown feedback into a single document for review, archiving, or returning to students.

What file formats and data do I need to create a teacher-facing PDF report from grades?▼

Creating a teacher-facing PDF report requires grades/grades.csv for scores and flags, plus grades/feedback/*.md files, to compile the Typst document.

Does generating a Typst PDF report require installing any specific tools?▼

Generating a Typst PDF report requires the typst compiler and pdftoppm tool installed to process submission images and render the final document.

Can I include submission images side-by-side with marks and feedback in a PDF?▼

The Typst PDF report displays each student's submission images side-by-side with their per-question marks, feedback, and flags for comprehensive teacher-facing review.

What is the best way to archive graded homework submissions into a shareable document?▼

Archiving graded homework into a shareable document is best done by generating a Typst PDF report that embeds submission images, scores, and feedback markdown into a single portable file.

Why do I need to run grade-homework before building a PDF report?▼

You must run grade-homework first because it produces the required grades.csv and feedback markdown files that the report builder reads to compile per-student marks and submission images into the Typst PDF.

Related Skills

Explore More Education & Research Skills→
TDAA-GoTDAA-Go
7

grade-homework

Grade student submissions in PDF, JPG, and DOCX against a solutions document.

Official
Advanced
benbrastmckiebenbrastmckie
3

skill-typst-implementation

Delegate plan-driven Typst document generation and compilation to a subagent.

Community
Advanced
bahayonghangbahayonghang
16

docx

Create, edit, and analyze .docx files using the docx library and LibreOffice.

Community
Advanced
AlpacaLabsLLCAlpacaLabsLLC
304

epd-compare

Compare environmental impacts across products and generate markdown reports.

Official
Advanced