Skills on AI

Report Card Comments

Download raw SKILL.md

Use when writing individualized narrative comments that summarize a student's progress for a report card under tight per-student time and space limits, as distinct from [[parent-teacher-conference]], the live, two-way conversation this written summary is the counterpart to.

Report card comments are short, individualized narrative summaries of a student's progress, written under real constraints: dozens of students, a character or line limit per comment, and no chance for the parent to ask a follow-up question the way they could in a conversation. The comment has to stand on its own, say something specific to that student, and land in the time it takes to write one of many.

Key components

  • Specific evidence, not a template — a detail unique to the student (a skill they've grown in, a habit that's holding them back) rather than a generic sentence that could describe any student in the class.
  • Balance of strength and growth area — both what the student is doing well and what they need to work on, since a comment that's all praise or all concern gives the parent an incomplete and often misleading picture.
  • Actionable framing for the growth area — phrased as something the student or parent can actually do something about, not just a label ("needs to improve organization" versus "benefits from writing down homework before leaving class").
  • Tone appropriate for the audience — language a parent, not just another teacher, will understand and receive well, since jargon or a clinical tone can read as colder than intended.
  • Consistency with the grade — a comment that doesn't contradict the numeric or letter grade sitting next to it, since a mismatch (glowing comment, low grade) reads as confusing or careless.

Writing from evidence, at volume, without losing specificity

The real difficulty in report card comments isn't knowing what to say about any one student — it's saying something true and specific about each of thirty students in a row without the comments blurring into interchangeable boilerplate by the tenth one. The practical fix is keeping a running, dated log of specific observations through the term — a comment, a moment, a piece of work — rather than trying to reconstruct a term's worth of detail from memory the night before comments are due. A comment written from a specific logged observation takes barely longer to write than a generic one and reads completely differently to the parent receiving it.

Reusable language for the structural parts of a comment (the opening, the transition into the growth area, the closing) is fine and doesn't undermine specificity, as long as the actual content in the middle — the evidence and the framing of what's being said about it — is particular to that student. The pitfall isn't reusing sentence scaffolding; it's reusing whole comments with a name swapped in.

Common pitfalls

  • Generic enough to fit any student — a comment that could be copy-pasted onto a different student's report card without anyone noticing has failed the one job a comment has.
  • All strength or all concern — an unbalanced comment gives a parent either false reassurance or an unqualified negative impression, neither of which matches a real student's progress.
  • Vague growth area — "needs to try harder" gives a parent nothing to act on; a specific, concrete behavior does.
  • Written entirely from memory at the deadline — without a running log, late-term comments tend to reflect only the most recent impression of the student, not the whole term.
  • Contradicts the grade next to it — an enthusiastic comment paired with a low grade, or the reverse, undermines trust in both.

Learn more

  • Parent Teacher Conference for the live, two-way conversation this written comment is the asynchronous counterpart to.
  • Rubric Design for the criteria a comment's specific evidence often draws from.
  • Summative Assessment for the end-of-unit work the comment's progress claims should be consistent with.

View report-card-comments/SKILL.md on GitHub