All skills
danjdewhurst avatar

/feedback-triage

@2d67b42

This skill should be used when the user asks to "process beta reader feedback", "alpha reader feedback", "feedback round", "synthesize reader feedback", "reader notes", "beta feedback", "reader readiness check", "review copy", "send the draft to readers", "share with readers who don't use GitHub", "triage the reader panel", or wants to collect, reconcile, and act on external reader feedback for a story project. NOT for rounds with a professional editor (use editorial-review), or for checking a manuscript is ready to query or publish (use submission or publishing).

Use this Skill: https://skilld.dev/gh/danjdewhurst/story-skills/feedback-triage

This session only. Nothing lands on disk.

referencessynthesis-template.md

≈1k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Synthesis Template

Write the round synthesis to feedback/round-{N}/synthesis.md only after every expected reader file for the round is collected. The synthesis is the decision record: which notes become revision work, which are adjudicated, and which are declined with a recorded reason. readiness is one of ready, needs-revision, or not-ready.

---
round: {N}
readers:
  - {reader-1-kebab}
  - {reader-2-kebab}
readiness: needs-revision
# source: simulated   # only when the round is a reader-panel round
---

# Synthesis — Round {N}

## Readiness Verdict

**{ready | needs-revision | not-ready}** — {one sentence: why}

- `ready`: no blocking or major convergent issues; proceed to the next
  stage (next round, or export).
- `needs-revision`: convergent or adjudicated issues require a revision
  pass before the next round. Lists the revision plan below.
- `not-ready`: structural problems (broken premise, failed arc, pervasive
  confusion) require developmental rework, not a polish pass.

## Convergent Findings (≥2 readers agree)

| Finding | Readers | Chapters | Canon check | Action |
|---------|---------|----------|-------------|--------|
| {One-line finding} | {a, b} | {Ch N} | {verified / setup-gap} | {Fix planned} |

Convergent findings are the strongest signal: two independent readers
tripping on the same spot means the manuscript, not the reader, is at fault.
These become revision items by default.

## Divergent Findings (readers disagree)

| Finding | For (readers) | Against (readers) | Adjudication | Action |
|---------|---------------|-------------------|--------------|--------|
| {One-line finding} | {a} | {b} | {Which side, and why — cite canon, craft, or intent} | {Fix / decline} |

Adjudication rules:

- Check both sides against the bible and the premise. Canon and theme
  outrank taste.
- A 2-vs-1 split is convergent (see above), not divergent.
- When genuinely 1-vs-1 with no canon tiebreak, prefer the reader whose
  overall verdict was more positive — they engaged more deeply — or ask the
  user. Record who decided.

## Single-Reader Findings

| Finding | Reader | Severity | Weight | Action |
|---------|--------|----------|--------|--------|
| {One-line finding} | {a} | {major/minor} | {accept / investigate / decline} | {...} |

Weigh single-reader findings by specificity: a specific, locatable note
("the alibi in Ch 9 contradicts the timeline") outranks a vague one ("the
middle dragged"). Specific + canon-verifiable = investigate or accept.
Vague + taste-based = usually decline.

## Declined with Reason

| Finding | Reader(s) | Reason for declining |
|---------|-----------|----------------------|
| {One-line finding} | {a} | {e.g. contradicts premise; outside genre contract; reader wanted a different book} |

Every declined finding needs a recorded reason. "The author disagrees" is
not a reason. Reasons reference canon, premise, genre contract, or craft
principle.

## Revision Plan

Numbered, actionable items for the revision pass, each with file targets:

1. {What changes} — targets: {chapter/scene/entity files}
2. ...

Hand this plan to the `revision-continuity` skill for execution.

Synthesis checklist

  • Every expected reader file for the round is collected (no synthesis on a partial set — see the discipline rule in SKILL.md)
  • Each finding appears in exactly one category
  • Every convergent finding has an action (fix or explicitly deferred)
  • Every divergent finding has a recorded adjudication with a reason
  • Every declined finding has a recorded reason (not just disagreement)
  • The readiness verdict matches the findings (blocking convergent issues cannot coexist with ready)
  • The revision plan lists concrete file targets for each item
  • A simulated round is labelled source: simulated, sorts its findings as single-reader, and does not treat ready as ready to submit or publish (see "Simulated rounds" in SKILL.md)

Source: SKILL.md on GitHub

1 warning2d3 checks · Risk SAFE
  • Gen Agent Trust Hub2d

    This skill facilitates a structured workflow for triaging story feedback from alpha/beta readers. It integrates with Git and GitHub, and utilizes a custom 'story' CLI tool for building and validating content. The security profile is generally low-risk, with the primary observation being the processing of untrusted external feedback data, which is a common vector for indirect prompt injection.

  • Socket2d

    No alerts

  • Snyk2d

    Risk: MEDIUM · 1 issue

Signed by skilld at 2d67b42. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 days ago

README badge

README badge for danjdewhurst/story-skills/feedback-triage