Review an essay against a rubric, one criterion at a time

---
name: essay-rubric-review
description: Reviews an essay against a rubric, one criterion at a time, checks every score against quotes from the essay, then writes the feedback.
spec: skill-graph/1
topology:
  nodes:
    - id: essay
      type: input
      label: ESSAY AND RUBRIC
    - id: rubric
      type: orchestrator
      label: READ THE RUBRIC
      model: sonnet
      tools: [WebFetch]
      output_format: json
    - id: score_criterion
      type: worker
      label: SCORE EACH CRITERION
      model: sonnet
      tools: [WebFetch]
      foreach: rubric.criteria
      max_items: 12
    - id: line_edits
      type: worker
      label: LINE EDITS
      model: sonnet
      tools: [WebFetch]
    - id: score_check
      type: verifier
      label: CHECK THE SCORES
      isolated_context: true
      model: opus
      tools: [WebFetch]
      gate: Every score quotes the essay, stays within its criterion's points, and no two scores contradict each other.
      on_fail: retry
      max_retries: 1
    - id: feedback
      type: synthesizer
      label: FEEDBACK
      model: sonnet
      tools: [WebFetch]
  edges:
    - from: essay
      to: [rubric, score_criterion, line_edits, score_check]
    - from: rubric
      to: score_criterion
      contract: criteria_list
    - from: score_criterion
      to: score_check
      contract: criterion_scores
    - from: line_edits
      to: score_check
      contract: edits
    - from: score_check
      to: feedback
      contract: checked_review
contracts:
  criteria_list:
    format: json
    description: "{ criteria: one entry per rubric criterion, each with name, what good looks like and the points it is worth }"
    required: [criteria]
  criterion_scores:
    format: json
    description: One entry per criterion, in rubric order; each has the score, the quotes behind it and one fix.
  edits:
    format: markdown
    description: A numbered list of line edits, each quoting the sentence and giving the better version.
  checked_review:
    format: markdown
    description: The checked scores with their quotes and fixes, the line edits worth keeping, and what was corrected.
---

# Node Prompts & Edge Contracts

## @node: rubric
Read the essay and rubric below. If no rubric is given, use a standard one for this kind of essay: thesis, structure, evidence, style and mechanics.

{{essay}}

Return JSON: {"criteria": [{"name": "...", "good": "what full marks look like", "points": 10}]}, one entry per criterion, in the rubric's order.

## @node: score_criterion
Score the essay on this one criterion only:

{{item}}

The essay (with its rubric):
{{essay}}

Return a JSON object: {"criterion": the name, "score": a number within its points, "quotes": two or three short quotes from the essay that justify the score, "fix": the one change that would raise the score most}.

## @node: line_edits
Read this essay and pick the ten sentences that would gain most from an edit: unclear, wordy, or wrong.

{{essay}}

Return a numbered list. For each one quote the sentence, give a better version, and say why in a few words.

## @node: score_check
You are a second marker. You did not write these scores; check them as if a stranger did.

The essay and rubric:
{{essay}}

The scores, one per criterion:
{{score_criterion}}

The line edits:
{{line_edits}}

Check that every quote is really in the essay, that each score fits its quotes and its criterion, and that the line edits do not change the meaning. Correct what is wrong.

Return the checked scores with their quotes and fixes, the line edits worth keeping, and a short list of what you corrected.

## @node: feedback
Write the feedback for the essay's author from this checked review:

{{score_check}}

Return Markdown: the total score and a one-line verdict, a table of criteria with score and the fix for each, the three changes that matter most, then the line edits.