Research discipline
Use whenever an answer depends on facts outside the codebase or training data — "research X", "what's the latest", "compare A vs B", version/pricing/market/news questions, "is it true that", fact-check requests — or when the user asks for sourced, verifiable output. Enforces evidence discipline on any research-shaped answer, short or long: live sources over memory, per-claim citations, independent-source triangulation, date-stamps, explicit unverified flags, adversarial self-review. Do not trigger for pure coding tasks, creative writing, or questions of opinion/taste.From its SKILL.md
npx -y skills add Skillproofdev/research-disciplineAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 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
6.5 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it
Research Discipline
An answer that sounds right and an answer you can check are different products. These rules force the second one — on every research-shaped answer, including a three-paragraph one. This is a discipline layer, not a report factory: it changes how you support claims, not how long the output is.
Rule 1 — Evidence is live; memory is a hypothesis
For anything volatile — versions, prices, dates, names in office, benchmarks, market facts, "current" anything — training-data recall is not evidence, it's a lead to verify.
- Retrieve today's date first; state the research date in the answer (
As of 2026-07-10). - Search/fetch before asserting. If tooling for live lookup is unavailable, say so and label
every volatile claim
[unverified — from model memory, may be stale]. - Stable facts (math, established history, how TCP works) don't need a fetch. When in doubt, it's volatile.
Rule 2 — Every claim carries its source
- Each factual claim gets an inline marker
[1],[2]… resolving to a source list at the end: URL, publisher, publication date (or "undated"), access date. - No orphan claims: if you can't point at where a fact came from, either find a source or flag it (Rule 5). Never invent URLs, DOIs, titles, or authors — an unverifiable citation is worse than a flagged gap.
- Quote first, conclude second: ground key claims in the source's actual words before paraphrasing. If you can't find a supporting quote in the source, the claim doesn't get that citation.
Rule 3 — Load-bearing facts need two INDEPENDENT sources
A load-bearing fact is one the conclusion would change without: the headline number, the decisive comparison, the "X announced Y".
- Two sources are independent only if neither derives from the other and they don't share a single upstream origin (same press release, same wire story, same original study, same vendor's marketing page syndicated twice). Check what each source cites.
- Independent confirmation found → cite both. Not found → keep the claim but mark it
[single-source]. Contradicting sources → present both with dates and let the newer or more primary one lead; never silently pick one.
Rule 4 — Numbers are quoted, not manufactured
- Reproduce figures verbatim from the source: value, unit, and the date it refers to. "$20/month (as of 2026-07)", not "about $20".
- Never average, recompute, convert, or merge numbers from different sources into one figure without showing the arithmetic and both origins.
- Sources disagree on a number → report the range with both citations, not a compromise value.
Rule 5 — Unverified means SAYING unverified
- A gap you couldn't verify is a finding, not a failure: write
[unverified]with one clause on what's missing ("vendor page doesn't state this; no secondary source found"). - "I couldn't confirm this" is a legitimate research result. A plausible guess formatted as a fact is the one output this skill exists to prevent.
- Confidence gradations, when useful:
confirmed(2+ independent) /single-source/unverified. Don't decorate every sentence — flag where it matters.
Rule 6 — Prefer the source closest to the fact
Tier sources and say what you used when it matters:
- Primary/official — the vendor's own docs/changelog/pricing page, the standard, the original paper, the court filing, the company's filing.
- Reputable secondary — established press, peer-reviewed reviews, well-known technical blogs with named authors.
- Community — forums, Reddit, HN threads: fine for leads and sentiment, cite as such, never as sole support for a load-bearing fact. Reject content-farm/SEO-spam/anonymous-AI pages entirely — being top of search results is not a credential. A secondary source that cites a primary → follow the link and cite the primary.
Rule 7 — Attack your own conclusions before delivering
After drafting, run one adversarial pass:
- Search once for the opposite of your main conclusion ("X is NOT faster than Y", "criticism of…"). If counter-evidence exists, integrate it — don't append it as a fig leaf.
- Find at least 2 weaknesses in your own draft (stale source? both sources share an origin? cherry-picked range? number without unit or date?). Found none → you're not looking; re-examine the two most load-bearing claims.
- Fix what you found, then deliver.
Rule 8 — Discipline scales down, effort scales with the question
- A quick question gets a quick disciplined answer: 2–4 sources, inline markers, one-line adversarial check — not an 8-phase pipeline. Don't balloon a 200-word answer into a report; rigor is not length.
- A big research task gets structure: fan the searches out, keep a claim ledger as you go (claim → source URL → pub date → status), and let the ledger become the source list.
- Reuse the session's earlier verified findings instead of re-fetching them.
Output format
- The answer, with inline
[n]markers on factual claims. **Sources**list:[n] Title — publisher, pub date. URL (accessed YYYY-MM-DD)+ tier when it matters.**Unverified / caveats**block when anything is flagged — never bury flags mid-text only.- Research date stated once (
As of …).
Do not
- Refuse to answer because evidence is thin — answer with flags. The user needs your best supported picture, not a shrug.
- Apply this to code-only tasks, opinion questions, or creative work; there the skill stays out of the way.
- Fabricate any part of a citation, ever. If the skill's rules and the user's request conflict (e.g., "just give me a number, no sources"), give the answer AND keep the one-line flag — honesty survives formatting preferences.
- Present the adversarial pass as theater: if step 7 found nothing twice in a row across a session, you're rubber-stamping — slow down on the next one.
What ships with it: 5 files
354.4 KB alongside SKILL.md
assets/
- benchmark.png117.3 KB
- how-it-works.png163.7 KB
- LICENSE687 B
- README.md5.8 KB
- social-card.png66.9 KB
Gives 0 of the 12 instructions most research analysis skills give in ~1.4k tokens
Counted across 1,063 of the 1,754 authors here whose files we hold, read 2026-08-07
- Generate a markdown reportin 32 of 1063, across 23 files
- Cite each claim's sourcein 30 of 1063, across 15 files
- Define the ideal customer profilein 20 of 1063, across 2 files
- Search for companies matching the criteriain 20 of 1063, across 2 files
- Assign a fit score from one to tenin 20 of 1063, across 2 files
- Analyze the codebase to understand the productin 19 of 1063, across 1 file
- Ask clarifying questions about the value propositionin 19 of 1063, across 1 file
- Look for signals of immediate needin 19 of 1063, across 1 file
- Identify the target decision maker rolein 19 of 1063, across 1 file
- Suggest a personalized contact strategyin 19 of 1063, across 1 file
- Provide conversation starters for outreachin 19 of 1063, across 1 file
- Format results in a scannable markdown templatein 19 of 1063, across 1 file
Said here and by no other author read
- retrieve today's date and state it
- search live sources before asserting volatile facts
- quote figures verbatim with units and dates
- search for evidence against your conclusion
- find and fix two weaknesses in the draft
- scale effort to the question size
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.