agentleFS
ntaffziintaffzii/Skill-Agents/skills/research/research-methodology/SKILL.md

research-methodology

Skill4 starsChanged 2 months agoMITView on GitHub

Use this skill as a pre-search discipline before running daily-news-report, github-skill-research, project-discovery, or any research task with multiple sources — frame the question, decide source-quality tiers, track what was checked vs. skipped, and separate "one source claims this" from "multiple independent sources agree." Trigger on "research this properly", "systematic search", "อยากได้ข้อมูลที่ครบจริง", "don't just take the first result", or automatically whenever a research skill is about to start searching. Pairs with claim-citation-check as the finalization-side check; this is the search-side discipline.

16 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use literature-review, context-engineering and 2 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • JDerekLomasSkill

    literature-review

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.). This skill should be used when conducting systematic literature reviews, meta-analyses, research synthesis, or comprehensive literature searches across biomedical, scientific, and technical domains. Creates professionally formatted markdown documents and PDFs with verified citations in multiple citation styles (APA, Nature, Vancouver, etc.).

    Also in 3 projects that use this

  • mrgoonieSkill

    context-engineering

    Master context engineering for AI agent systems. Use when designing agent architectures, debugging context failures, optimizing token usage, implementing memory systems, building multi-agent coordination, evaluating agent performance, or developing LLM-powered pipelines. Covers context fundamentals, degradation patterns, optimization techniques (compaction, masking, caching), compression strategies, memory architectures, multi-agent patterns, LLM-as-Judge evaluation, tool design, and project development.

    Also in 3 projects that use this

  • CloudflareSkill

    security-audit

    Security guidance and vulnerability review for codebases, APIs, services, CLI tools, libraries, and daemons. Use for security questions, focused reviews, vulnerability research, security audits, or pen tests. Run the complete workflow only for explicit codebase audit or pen-test requests, full/comprehensive/end-to-end reviews, or requested report artifacts.

    Also in 3 projects that use this

  • BlockSkill

    frontend-design

    Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 14 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Before daily-news-report, github-skill-research, or project-discovery starts synthesizing — run this first, not as an afterthought

    line 16
  2. Distinctive:

    Not recording which parts of a broad question were actually researched vs.

    line 47

“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Research Methodology

Overview

Ad hoc research — search, read the first few plausible results, summarize — is fast but has a specific, recurring failure mode: it stops as soon as something sounds right, not when the question is actually answered, and it can't tell "three sources agree" from "three sources repeating the same original claim" (an echo chamber, not corroboration). This skill is the discipline layer that runs before searching — claim-citation-check is the equivalent check that runs after, on the draft. Together they bracket a research task; this skill alone does not verify anything, it structures how the searching happens.

When to use

  • ก่อนเริ่มค้นข้อมูลสำหรับ research report, news brief, หรือ skill/project comparison
  • The question has room for real disagreement between sources, or the topic is unfamiliar enough that "what counts as a good source" isn't obvious
  • Before daily-news-report, github-skill-research, or project-discovery starts synthesizing — run this first, not as an afterthought

When NOT to use

  • A quick factual lookup with one obvious, uncontested source (a library's version number, a function's signature) — the overhead isn't worth it
  • The task is synthesis/writing from sources already gathered — that's markdown-report's job; this skill is specifically about the searching phase

Core knowledge

1. Frame the question before searching. A vague question ("tell me about X") produces a vague, first-plausible-result search. Narrow it to something a search can actually resolve ("what does X's official docs say the default timeout is, as of the current major version") before running the first query.

2. Decide source-quality tiers up front, not after finding something.

TierExamplesWeight
Primary / officialVendor docs, source code, the standard's own spec, a repo's own READMEHighest — treat as ground truth unless contradicted by newer official source
Maintained secondaryActively-updated community docs, a maintainer's own blog post, a well-cited technical writeupMedium — good corroboration, not a substitute for checking primary when it matters
Unverified / aggregatorRandom blog posts, forum answers, SEO content, an AI-generated summary of the topicLowest — fine for orientation, never the sole basis for a specific factual claim

Decide the tier before reading, so a low-tier source that happens to say something convenient doesn't get treated as more authoritative than it is.

3. Track what was checked and what was skipped — explicitly, not just in your head. If a search returns 10 results and only the first 3 got read, say so ("checked the top 3 official-docs hits; did not check community forum threads") rather than presenting the summary as if the full result set was considered. This is the single most commonly skipped step in ad hoc research, because it feels like unnecessary overhead — it isn't; it's what lets someone else (or you, later) know where the coverage gap is.

4. Distinguish corroboration from repetition. Before counting "multiple sources say X" as a stronger signal, check whether those sources are actually independent or whether they're all citing (or silently copying) the same original claim. A claim traced back to one primary source repeated by five blogs is one data point, not five.

5. State confidence explicitly in the synthesis, not just the claim itself: "confirmed against official docs" reads very differently from "widely repeated across blogs, original source not found" — both are worth reporting, but not with the same weight.

Common mistakes

  1. Stopping the search the moment something plausible turns up, instead of checking whether it's actually the best available source.
  2. Treating "I found several sources agreeing" as strong corroboration without checking whether they're independent or all downstream of the same original claim.
  3. Not recording which parts of a broad question were actually researched vs. skipped for time — leaves a false impression of completeness.
  4. Skipping primary sources entirely in favor of secondary summaries because they're faster to read, even when the specific fact matters enough to check the original.
  5. Applying this much rigor to a trivial lookup — over-applying process is its own failure mode; match the discipline to the stakes of the question.

Known limitations

  • This is a process discipline, not a fact-checker — following it well over bad sources still produces a wrong conclusion. Pair with claim-citation-check on the finished draft for the verification half.
  • Source-quality tiers above are a general starting heuristic; some domains have their own established hierarchy (e.g. peer-reviewed journals vs. preprints in academic contexts) that should override the generic table when it applies.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.