Skills

aid-summarize

Frontmatter

name — aid-summarize
description — Generate kb.html, a single-file visual tour of the Knowledge Base. Use this skill when someone non-technical needs to read what the project knows about itself — a newcomer, a stakeholder, anyone who will not open .aid/knowledge/ directly. It builds one section per resolved document from that document’s own frontmatter, in a light/dark themed page with click-to-expand images and WCAG AA accessibility. Two grades gate approval: script- verifiable checks score the machine grade, and an interactive checklist scores the human grade, including a mandatory visual review. Idempotent — re-running on an unchanged Knowledge Base does nothing.
allowed-tools — Read, Glob, Grep, Bash, Write, Edit
argument-hint — [—grade X] override minimum [—theme default|brand-X] [—reset]

Definition: canonical/skills/aid-summarize/SKILL.md

Flow

flowchart TB
  classDef aidNode color:#fff
  classDef aidEntry fill:#166534,stroke:#14532d,color:#fff
  classDef aidExit fill:#991b1b,stroke:#7f1d1d,color:#fff
  classDef aidDecision fill:#92400e,stroke:#78350f,color:#fff
  classDef aidLoopBack fill:#1e3a8a,stroke:#1e3a8a,color:#fff
  classDef aidStep fill:#1a2035,stroke:#d4a853,color:#f1f5f9
  n1(["PREFLIGHT<br/>PREFLIGHT is the synchronous gate that verifies all…"])
  n2(["STALE-CHECK<br/>STALE-CHECK compares the KB review date against the last…"])
  n3["PROFILE<br/>PROFILE reads the doc-set and domain from feature-014…"]
  n4["GENERATE<br/>GENERATE builds kb.html from KB content using the resolved…"]
  n5{"VALIDATE"}
  n6{"MANUAL-CHECKLIST"}
  n7["FIX<br/>FIX handles objective machine-pool failures autonomously…"]
  n8(["APPROVAL<br/>APPROVAL presents the graded summary to the user for final…"])
  n9["WRITEBACK<br/>WRITEBACK atomically records the approved summarization…"]
  n10(["DONE<br/>DONE confirms the summarization is complete and the…"])
  n1 --> n2
  n2 --> n3
  n3 --> n4
  n4 --> n5
  n5 -->|"if Machine Grade &gt;= minimum"| n6
  n5 -->|"otherwise"| n7
  n6 -->|"otherwise"| n7
  n6 -->|"if Overall Grade ≥ minimum"| n8
  n7 --> n5
  n8 --> n7
  n8 -->|"If user approved"| n9
  n9 --> n10
  class n1 aidEntry
  class n2 aidExit
  class n3 aidStep
  class n4 aidStep
  class n5 aidDecision
  class n6 aidDecision
  class n7 aidStep
  class n8 aidExit
  class n9 aidStep
  class n10 aidExit
  class n1 aidNode
  class n2 aidNode
  class n3 aidNode
  class n4 aidNode
  class n5 aidNode
  class n6 aidNode
  class n7 aidNode
  class n8 aidNode
  class n9 aidNode
  class n10 aidNode

Source fragments

Every node in the chart above, in chart order, with the exact canonical/ text it was derived from.

1 · PREFLIGHT — PREFLIGHT is the synchronous gate that verifies all… · entry

| PREFLIGHT | `references/state-preflight.md` | inline | → STALE-CHECK |

Source: canonical/skills/aid-summarize/SKILL.md#L172 · full step: canonical/skills/aid-summarize/references/state-preflight.md#L1-L24

2 · STALE-CHECK — STALE-CHECK compares the KB review date against the last… · exit · HALT

| STALE-CHECK | `references/state-stale-check.md` | inline | → PROFILE |

Source: canonical/skills/aid-summarize/SKILL.md#L173 · full step: canonical/skills/aid-summarize/references/state-stale-check.md#L1-L33

3 · PROFILE — PROFILE reads the doc-set and domain from feature-014… · step

| PROFILE | `references/state-profile.md` | inline | → GENERATE |

Source: canonical/skills/aid-summarize/SKILL.md#L174 · full step: canonical/skills/aid-summarize/references/state-profile.md#L1-L163

4 · GENERATE — GENERATE builds kb.html from KB content using the resolved… · step

| GENERATE | `references/state-generate.md` | inline | → VALIDATE |

Source: canonical/skills/aid-summarize/SKILL.md#L175 · full step: canonical/skills/aid-summarize/references/state-generate.md#L1-L379

5 · VALIDATE — VALIDATE runs the machine-verifiable quality checks… · decision

| VALIDATE | `references/state-validate.md` | inline | → MANUAL-CHECKLIST (grade ≥ min) / → FIX (grade < min) |

Source: canonical/skills/aid-summarize/SKILL.md#L176 · full step: canonical/skills/aid-summarize/references/state-validate.md#L1-L63

6 · MANUAL-CHECKLIST — MANUAL-CHECKLIST elicits human-judgment answers for the… · decision

| MANUAL-CHECKLIST | `references/state-manual-checklist.md` | inline | → APPROVAL |

Source: canonical/skills/aid-summarize/SKILL.md#L177 · full step: canonical/skills/aid-summarize/references/state-manual-checklist.md#L1-L40

7 · FIX — FIX handles objective machine-pool failures autonomously… · step

| FIX | `references/state-fix.md` | inline | → VALIDATE |

Source: canonical/skills/aid-summarize/SKILL.md#L178 · full step: canonical/skills/aid-summarize/references/state-fix.md#L1-L39

8 · APPROVAL — APPROVAL presents the graded summary to the user for final… · exit · HALT

| APPROVAL | `references/state-approval.md` | inline | → WRITEBACK |

Source: canonical/skills/aid-summarize/SKILL.md#L179 · full step: canonical/skills/aid-summarize/references/state-approval.md#L1-L56

9 · WRITEBACK — WRITEBACK atomically records the approved summarization… · step

| WRITEBACK | `references/state-writeback.md` | inline | → DONE |

Source: canonical/skills/aid-summarize/SKILL.md#L180 · full step: canonical/skills/aid-summarize/references/state-writeback.md#L1-L33

10 · DONE — DONE confirms the summarization is complete and the… · exit · HALT

| DONE | `references/state-done.md` | inline | → halt |

Source: canonical/skills/aid-summarize/SKILL.md#L181 · full step: canonical/skills/aid-summarize/references/state-done.md#L1-L45

Report an issue with this page →