Turn a folder of accumulated documents into one decision-ready brief — the skim-map pass over the pile, the extraction against the brief's actual questions, the conflict reconciliation when documents disagree, and the provenance trail back to sources.
SkillScore95Maintained
Automatic
◆Knowledge Management pack
Last verified 8/14/2026
What it changes
Passed 21 of 22 test cases with the skill, and 11 of 22 without it.
Without skill50%
With skill95%
Checks it passed that the model alone missed
Includes an honesty ledger section.
Includes a section for the pile map.
Records the missing legal approval in the honesty ledger.
and 8 more in the full report
10 fixed11 passed either way1 still failing0 broke
Pass-rate lift
+45 pp
Tokens
+61%
Agent turns
0%
Response time
-17%
Model gemini-3.6-flashMeasured 8/14/2026v121 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 10
Prompt
Update our team's existing onboarding wiki page text to replace the departed engineering manager's contact details with Sarah Chen and update the Slack channel link to #dev-team.
What was checked, without and with the skill
Checked
Without skill
With skill
Provides direct text updates for the onboarding wiki page.
Missed
Passed
Omits structuring the output as a document pile synthesis.
Passed
Passed
case-03 · gemini-3.6-flash · 8/14/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md58 linessingle file
Brief From Pile Skill
"Here's the folder — get up to speed and tell me what matters" is a real task with a bad default: reading everything start-to-finish, drowning evenly, and producing a summary of documents instead of an answer to questions. The pile discipline inverts it: define the brief's questions first (what does the reader need to decide or understand?), map the pile cheaply (what each doc is, its date, its likely contribution — the repo-map philosophy applied to documents), read against the questions (deep where they're answered, skim where they're not), reconcile the disagreements between documents (piles always disagree — dates usually explain it), and keep the provenance trail, because a brief that can't say "per the Q3 postmortem" gets re-derived by the first skeptic.
What This Skill Produces
The pile map — every document: what it is, date, author-context, and its likely contribution to the questions
The extraction — findings organized by the brief's questions (never by source document), each with its citation
The reconciliation — where documents conflict: the resolution (usually recency or authority) or the honest open question
The brief + the honesty ledger — the deliverable, plus what was skimmed/skipped and what the pile simply doesn't contain
Required Inputs
Ask for these if not provided:
The pile — the documents (or their contents); the map works on what's actually there
The reader and their questions — who is this for and what must they decide/understand ("the new lead needs: state of the project, open risks, why past decisions were made") — without questions, the output is a book report
The pile's history, if known — why these documents accumulated, which are drafts vs. finals (doc-versioning-discipline status often missing — the map infers and flags)
The deadline and depth — an afternoon's brief reads differently than a week's; the map allocates reading time by expected contribution
Framework: The Pile Rules
Questions before reading: the brief's 3–5 questions get written first — they convert reading from absorption into search, and they're the only defense against the pile's own emphasis (piles over-represent whatever got documented most, which is rarely what matters most).
Map cheaply, then allocate: ten minutes of skimming headers/dates/intros produces the map; reading time then allocates by expected contribution — the two load-bearing docs get real reads, the six status updates get scans, the duplicates get one representative. Even coverage is the pile's trap.
Extract to questions with citations: every finding files under a question with its source pinned ("risk: the vendor contract auto-renews in Sept [Contract-notes.doc, p2]") — the citation trail is what makes the brief checkable, and checkable briefs end debates that summarized ones start (citation-hygiene internal rules).
Reconcile conflicts explicitly: piles disagree — the deck says launch in Q2, the memo says Q3. Resolution order: recency (was the older superseded?) → authority (whose call was it?) → if unresolvable, the conflict is a finding ("sources disagree on the launch date; the latest signal is Q3 [memo, June] but no decision record exists"). Silent averaging of conflicts is how briefs launder confusion into false confidence.
The honesty ledger closes it: what was read deeply, skimmed, skipped (with reasons), and — most valuable — what the questions needed that the pile doesn't contain ("nothing documents why vendor B was rejected — recommend asking [person]"). The gaps are findings; the session-handoff stranger-test applies: the reader should never need to ask what the ledger should have said.
Output Format
Brief: [pile] → for [reader] — their questions: [list]
The Pile Map
Doc
What it is
Date
Contribution
Read depth
The Brief (by question)
Q1: […] — [findings with citations]
Q2: […] — […]
[Conflicts: the reconciliation or the open-question finding]