Install any skill in seconds. Free to start, no credit card required.
Get Started Free →The protocol behind every investigation skill. Use when AI research must proceed without you: search-plan gate, Fact/Inference/Assumption labels, confidence stacking, diffable outputs.
| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-11 | ✗→✓ | ▲ Improved | 191% | 0% |
| case-10 | ✗→✓ | ▲ Improved | 118% | 0% |
| case-07 | ✗→✓ | ▲ Improved | 153% | 0% |
| case-15 | ✗→✓ | ▲ Improved | 25% | 0% |
| case-17 | ✗→✓ | ▲ Improved | 163% | 0% |
Provide the canonical contract for investigation skills — research the AI performs in the world (web search, published data, public filings) while you review the evidence instead of feeding it context. Where workshop-facilitation governs skills that ask you questions one at a time, this protocol governs skills that proceed without you: they budget their questions, show their plan, label every claim, and produce output stable enough to diff against last quarter's run. That last property is the payoff — an investigation honoring this contract can run as an agent task, in a loop, or on a schedule.
Nothing required — this skill defines the protocol other investigation skills follow. Also useful when invoked standalone: the target of the investigation and, above all, the decision the research should support. Research without a decision is a hobby; every investigation skill asks for the decision because it determines what "just enough" means.
Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended ARGUMENTS: line — counts as answers already given. Use it, credit it against the question budget, and don't re-ask.
Arriving empty-handed? That works too. The protocol's whole design is to proceed on best-available evidence with labeled assumptions when nobody answers questions. When another skill references this protocol, that skill's Input section governs what to provide.
Example invocation: Run an autonomous investigation on [TARGET]'s move into workflow automation — this supports our Q3 roadmap bet on the same space.
| | workshop-facilitation | autonomous-investigation | |---|---|---| | Who holds the context | The user | The world (public sources) | | Interaction shape | One question per turn | Question budget, then proceed | | Blocked by silence? | Yes — waits for answers | No — labels assumptions and continues | | Schedulable? | No | Yes — that's the point |
Every investigation skill honors all seven clauses. They are not a menu.
nobody answers, proceed with labeled assumptions. This is what makes investigations schedulable: an unattended run degrades gracefully instead of stalling.
types, how you'll separate fact from inference. Continue unless the user revises it. Why it teaches: reviewing a plan takes 10 seconds; reviewing a wrong report takes 10 minutes. The gate is the cheapest correction point in the whole workflow.
Keep labels short. Things you couldn't find are not a fourth label — they go in an explicit gaps list. Why it teaches: most competitive "facts" in strategy decks are unlabeled inference. Three-level honesty is the habit that separates intelligence from confident storytelling.
(competitors, pricing, market share, patent contents, customer wins...) and forbids inventing them. Real, checkable URLs only; a claim without a source and date is an opinion wearing a badge. Why it teaches: the list tells the human exactly what to verify first.
decision. Verbose Mode exists only on request. Research value is decision support, not page count.
run N+1 are diffable. Delta monitoring, scheduled refreshes, and "what changed since last quarter" all depend on this clause.
to run, assumptions to validate). Accept 1, 1 and 3, Verbose Mode, or a custom path.
Labels grade individual claims; stacking grades the story. When signals arrive from independent collection channels (see intelligence-collection-disciplines):
~~~ 1 channel flags it → Watch item. Log it, do nothing. 2 channels agree → Working hypothesis. Assign someone to probe. 3+ channels agree → Actionable intelligence. Brief leadership, adjust plans. Channels conflict → The most interesting case. Someone is bluffing. Dig. ~~~
One corollary that generalizes everywhere: treat announcements as intent until funding, procurement, hiring, or contracts corroborate them. Ambition shows up in press releases; commitment shows up in filings, job posts, and purchase orders.
All collection under this protocol is legal, ethical, open-source work:
specifically to extract a former employer's secrets, scraping in violation of terms you accepted.
The rule of thumb, borrowed from the competitive-intelligence profession (SCIP Code of Ethics): if you'd be uncomfortable explaining your method on stage at the target's user conference, don't use the method.
Assumption.
not just the signals.
scheduled run), file the output and stop.
A copy/paste investigation brief — the contract's seven clauses as fill-in decisions, for briefing an agent or designing a new investigation skill — lives in template.md.
Opening of a protocol-honoring run (user gave target + decision inline, so no questions spent):
> Search plan (say "revise" to change it): > - Search TARGET]'s pricing pages, release notes, and last two earnings transcripts > - Source mix: company site, filings, credible press, review sites > - Facts get URLs; interpretations get labeled Inference; gaps become Assumptions to validate > > (research happens) > > Key finding: TARGET] removed its mid-tier plan in May — Fact > (pricing page diff, May 12). Packaging is consolidating toward > enterprise — Inference (tier removal + two enterprise-only features shipped since April). > They will raise the entry price within two quarters — Assumption (pattern-based; validate > against their next pricing-page change). > > Final Step — reply 1, 2, 3, 4, a combination, or "Verbose Mode": > 1. Build the battle card from these findings > 2. Executive comparison matrix > 3. Risks/opportunities for the next 2 quarters > 4. Discovery questions to validate the assumptions
A scheduled run with no human present: the same skill runs quarterly from a saved invocation. The question budget is already spent (zero questions — context was inline), the plan gate auto-continues, and the output diffs cleanly against last quarter because the schema didn't move. The delta — not the report — is what the team reads.
See examples/protocol-in-action.md for a full worked run (fictional) showing every clause under load — including a user revising the search plan at the gate and an honest gaps list where the do-not-invent list held. examples/protocol-in-action-industrial.md shows the conflict case: four channels agree, one disagrees, and the dig changes the strategic response.
labeled findings, twenty pages is a defect. Just Enough Mode is the contract, not a suggestion.
of two job posts. The label isn't decoration — it tells the reader what to check before betting on it.
names the domain's temptations; honor it or the whole output is suspect.
of plan review. The gate exists because redirecting a plan is cheap and redirecting a report is not.
corroborate with money, hiring, or contracts before you re-plan around them.
delta monitor downstream now compares apples to a reorganized orchard.
channels agree — that's the stacking rule doing its job.
intelligence-collection-disciplines (Component) —the eight collection channels whose signals this protocol labels and stacks
workshop-facilitation (Interactive) — the sibling protocol forskills where the user holds the context
market-landscape-scan, competitive-research-snapshot,competitive-intel-watch, battle-card-builder (References section of each names this protocol)
https://github.com/deanpeters/product-manager-prompts repo.
Other measured skills in the registry, with their headline benchmark lift.