# AI Feedback Design Principles

Audit and redesign AI-generated feedback for pedagogical quality, timing, and learning...

- Repository: https://github.com/GarethManning/education-agent-skills (939 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-22
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add GarethManning/education-agent-skills --skill ai-feedback-design-principles -g -a claude-code -y`
Codex: `npx skills add GarethManning/education-agent-skills --skill ai-feedback-design-principles -g -a codex -y`
Cursor: `npx skills add GarethManning/education-agent-skills --skill ai-feedback-design-principles -g -a cursor -y`
Gemini CLI: `npx skills add GarethManning/education-agent-skills --skill ai-feedback-design-principles -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add GarethManning/education-agent-skills`

## Description

Audit and redesign AI-generated feedback for pedagogical quality, timing, and learning impact. Use when building or reviewing automated feedback in digital learning tools.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AI Feedback Design Principles

## What This Skill Does

Evaluates a proposed AI feedback design against research criteria for effective automated feedback and suggests specific improvements. This skill takes a feedback scenario (what the student did) and the current or proposed AI response (what the system says), then analyses the feedback against principles from Shute (2008), Narciss (2008), Hattie & Timperley (2007), and emerging LLM feedback research (Dai et al., 2023). The output includes a diagnosis of what's working and what isn't, a redesigned version of the feedback, and practical implementation guidance. The core challenge is that most AI feedback falls into one of two failure modes: it's either too vague to be actionable ("Good effort! Try to improve your argument.") or too specific and does the thinking for the student ("Your thesis should be: Climate change is the defining challenge of our generation because…"). Effective feedback lives in the narrow space between these extremes, specific enough that the student knows what to do, but not so specific that it bypasses the cognitive work that produces learning. AI is specifically valuable here because it can generate feedback at scale, but this makes the design principles even more critical: bad feedback at scale is worse than no feedback at all.

## Evidence Foundation

The rest: https://github.com/GarethManning/education-agent-skills/blob/HEAD/skills/ai-learning-science/ai-feedback-design-principles/SKILL.md