Summarize
Produce a structured summary in decisions, operations, or stream-of-consciousness (SOC) mode. Use when the human asks for a structured summary, a decision or operations writeup, or SOC capture ("summarize this", "write up these decisions", "capture this as SOC", "log this operation"). SOC mode is the canonical voice→text capture for the fleet.From its SKILL.md
npx -y skills add vergil-project/vergil-claude-plugin --skill summarizeAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.8 KB, as published. Nobody here has run it
Summarize
Table of Contents
- Overview
- Mode selection
- Common rules
- Mode: decisions
- Mode: operations
- Mode: soc
- Output templates
- Resources
Overview
Produce a concise, structured summary using the canonical protocol for the selected mode. Preserve outcomes, reasoning, and evidence without adding external knowledge.
Mode selection
Select the mode in this order:
- If the user explicitly specifies a mode, follow it.
- If the user uses
Enter SOCorEnd SOC, use soc mode. - If the request centers on decisions, rationale, or alternatives, use decisions mode.
- If the request centers on actions taken, system changes, or outcomes, use operations mode.
- If multiple modes plausibly apply, ask the minimum clarification question: "Which mode: decisions, operations, or soc?"
Common rules
- Base the summary only on the provided input record.
- Do not add external facts, assumptions, or inferred details.
- Call out missing or ambiguous information explicitly.
- Preserve sequence when the order of events matters.
- Keep the output concise and non-narrative.
Mode: decisions
Follow the Summarize Decisions Protocol.
- Required section order: Results, Reasoning, Options Not Chosen.
- Label implicitly converged decisions as implicit.
- Include optional sections only when present in the input.
Mode: operations
Follow the Summarize Operations Protocol.
- Required section order: Actions Taken, Outcomes and Status, Problems Encountered and Solved, Problems Unresolved, Changes and Artifacts, Follow-up Work and New Issues.
- Capture evidence for command-driven actions (commands + minimal output).
- Include timestamps when available; state when none were provided.
- Redact secrets or sensitive data and note the redaction.
Mode: soc
Follow the Summarize Stream of Consciousness Protocol.
Enter SOCbegins capture mode; acknowledge capture activation.- During SOC capture, record input verbatim and do not summarize or interpret.
End SOCends capture mode and triggers the structured summary.- If SOC is not closed with
End SOC, do not produce a summary.
Canonical SOC capture for the fleet
This SOC mode is the canonical SOC capture mechanism for every
repo in the fleet that uses voice→text→article workflows
(notably the-infrastructure-mindset). Repo-local references
to soc-capture or summarize-soc as skill names are stale
pointers — the real skill is this one, in SOC mode. See
#58
for the rationale: capture and summary are intertwined here
(End SOC triggers the structured summary), so splitting SOC
into its own skill adds no semantic gain.
Output templates
Decisions:
Results
- ...
Reasoning
- ...
Options Not Chosen
- Option: ...
Reason: ...
Status: rejected | deferred
Revisit triggers: ...
Operations:
Actions Taken
- ...
Outcomes and Status
- ...
Problems Encountered and Solved
- ...
Problems Unresolved
- ...
Changes and Artifacts
- ...
Follow-up Work and New Issues
- ...
SOC:
Summary
- ...
Themes
- ...
Open Questions
- ...
Resources
docs/ai-agents/protocols/summarize-decisions-protocol.mddocs/ai-agents/protocols/summarize-operations-protocol.mddocs/ai-agents/protocols/summarize-stream-of-consciousness-protocol.md