research-craft
Systematic research methodology for formulating problems, building evidence-based arguments, and communicating findings in academic contexts. For scholarly writing, thesis development, and knowledge contribution. NOT for creative writing, journalistic reporting, or business analytics.
Best use case
research-craft is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Systematic research methodology for formulating problems, building evidence-based arguments, and communicating findings in academic contexts. For scholarly writing, thesis development, and knowledge contribution. NOT for creative writing, journalistic reporting, or business analytics.
Teams using research-craft should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/research-craft/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How research-craft Compares
| Feature / Agent | research-craft | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Systematic research methodology for formulating problems, building evidence-based arguments, and communicating findings in academic contexts. For scholarly writing, thesis development, and knowledge contribution. NOT for creative writing, journalistic reporting, or business analytics.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Research Craft
Master the systematic process of formulating meaningful research problems, constructing evidence-based arguments, and communicating findings that contribute to scholarly conversations.
## When to Use
✅ Use for: Academic research papers, thesis/dissertation work, scholarly article writing, literature reviews, evidence-based argumentation, knowledge synthesis, participating in disciplinary conversations
❌ NOT for: Creative writing, journalistic reporting, business case studies, technical documentation, marketing content, personal essays, opinion pieces
## Core Process
### Problem Formulation Decision Tree
```
START: Do you have a clear research problem?
├─ NO: Do you have a specific topic (not just broad subject)?
│ ├─ NO → Find specific topic within general interest area
│ └─ YES → Question topic systematically
│ └─ Ask "So what?" to test consequences
│ ├─ Readers won't care → Reframe problem from reader perspective
│ └─ Readers will care → Verify problem structure:
│ ├─ Condition (knowledge gap) stated?
│ ├─ Cost/consequence stated?
│ └─ Evidence type available?
│ ├─ ALL YES → PROCEED to argument building
│ └─ ANY NO → Revise problem formulation
└─ YES → Is problem practical or conceptual?
├─ PRACTICAL (tangible costs requiring action)
│ └─ Solution must be actionable
└─ CONCEPTUAL (understanding gap)
├─ Pure research → Solution improves understanding
└─ Applied research → Solution has practical consequences
```
### Argument Construction Decision Tree
```
START: Building argument for research claim
├─ State CLAIM (answers research question)
├─ Develop REASONS (assertions from thinking)
│ └─ For each reason, do you have EVIDENCE (data from world)?
│ ├─ NO → Insufficient support; gather evidence or drop reason
│ └─ YES → Is evidence representative, accurate, sufficient?
│ ├─ NO → Cherry-picking risk; expand sample or qualify claim
│ └─ YES → Continue
├─ Anticipate reader objections
│ ├─ Plausible objections exist?
│ │ ├─ YES → ACKNOWLEDGE and RESPOND with subordinate argument
│ │ │ ├─ Can you refute? → Provide counter-evidence
│ │ │ ├─ Must concede? → Acknowledge limitation candidly
│ │ │ └─ Alternative view? → Show why yours is stronger
│ │ └─ NO → Proceed to warrants
│ └─ Will readers question reason-claim connection?
│ ├─ YES → STATE WARRANT (general principle)
│ └─ NO (expert audience) → Omit warrant
└─ Test complete argument
└─ Evidence comprises ~1/3 of section?
├─ NO: Too little → Data dump; too much → Add interpretation
└─ YES → ARGUMENT COMPLETE
```
### Source Evaluation Decision Tree
```
START: Evaluating potential source
├─ Assess RELIABILITY
│ ├─ Peer-reviewed? → +reliability
│ ├─ Frequently cited? → +reliability
│ ├─ Reputable publisher? → +reliability
│ ├─ Author credentialed in domain? → +reliability
│ └─ Current for field? → Check temporal standards
├─ Classify SOURCE TYPE (relative to YOUR project)
│ ├─ Provides raw data on subject? → PRIMARY
│ ├─ Analyzes primary sources? → SECONDARY
│ └─ Synthesizes secondary sources? → TERTIARY
│ └─ Can you access more primary sources?
│ ├─ YES → Get closer to primary; chain is too long
│ └─ NO → Acknowledge limitation
├─ Evaluate EVIDENCE quality
│ ├─ Accurate? → Verify important claims
│ ├─ Precise? → Sufficient detail for replication?
│ ├─ Sufficient? → Sample size adequate?
│ ├─ Representative? → Generalizable?
│ └─ Authoritative? → Within author's expertise?
└─ USAGE decision
├─ Quote? → Exact words matter for analysis
├─ Paraphrase? → Specific ideas in your words
└─ Summarize? → General overview sufficient
```
### Revision Decision Tree
```
START: Draft complete, begin revision (TOP-DOWN only)
├─ LEVEL 1: FRAME (Introduction/Conclusion)
│ ├─ Introduction has Context→Problem→Response?
│ │ ├─ NO → Restructure using three-step pattern
│ │ └─ YES → Problem framed from reader perspective?
│ │ ├─ NO → Rewrite emphasizing costs to readers
│ │ └─ YES → Continue
│ └─ Conclusion has Main Point→New Significance→Future Research?
│ ├─ NO → Add missing elements
│ └─ YES → Proceed to Level 2
├─ LEVEL 2: ARGUMENT STRUCTURE
│ ├─ 4-5 key concepts run throughout paper?
│ │ ├─ NO → Identify concepts; track through all sections
│ │ └─ YES → Continue
│ └─ Main claim clearly supported by reasons?
│ ├─ NO → Revise logical architecture
│ └─ YES → Proceed to Level 3
├─ LEVEL 3: SECTION ORGANIZATION
│ ├─ Each section has point sentence (beginning or end)?
│ │ ├─ NO → Add or clarify point sentences
│ │ └─ YES → Continue
│ ├─ Evidence comprises ~1/3 of each section?
│ │ ├─ NO → Adjust evidence/interpretation ratio
│ │ └─ YES → Continue
│ └─ Ordering principle clear (simple→complex, familiar→unfamiliar)?
│ ├─ NO → Reorganize sections logically
│ └─ YES → Proceed to Level 4
├─ LEVEL 4: PARAGRAPH STRUCTURE
│ ├─ Each paragraph advances single point?
│ │ ├─ NO → Split or merge paragraphs
│ │ └─ YES → Continue
│ └─ Transitions guide readers between paragraphs?
│ ├─ NO → Add connective tissue
│ └─ YES → Proceed to Level 5
└─ LEVEL 5: SENTENCE CLARITY
├─ Subjects = main characters?
├─ Verbs = crucial actions (not nominalizations)?
└─ Hedges appropriately qualify certainty?
├─ ALL YES → REVISION COMPLETE
└─ ANY NO → Fix sentence-level issues
```
## Anti-Patterns
### Data Dump
**Novice approach:** Accumulates information without guiding question, creating pastiche of vaguely related facts. Presents evidence excessively without interpretation.
**Expert approach:** Formulates clear research question before gathering evidence. Balances evidence (~1/3 of section) with reasons and interpretation showing how evidence supports claims.
**Timeline to mastery:** Internalized after 2-3 major research projects where early aimless collection causes crisis, forcing recognition that questions must precede answers.
---
### Warrant-Based Factual Claims
**Novice approach:** Supports factual claims with elaborate reasoning and logical principles alone, without presenting hard evidence from the world.
**Expert approach:** Distinguishes sharply between reasons (assertions from thinking) and evidence (data from world). Bases reasons on evidence, never evidence on reasons. Reserves warrant-heavy arguments for conceptual claims only.
**Timeline to mastery:** Requires shift from high school essay mode (where reasoning suffices) to research mode (where data is king). Typically 1-2 semesters of feedback cycles.
---
### Arrogant Certainty
**Novice approach:** States claims with absolute confidence using "all," "never," "always," "proves." Hides weaknesses hoping readers won't notice. Thinks forceful = credible.
**Expert approach:** Paradoxically strengthens arguments by modestly acknowledging limitations. Uses hedges appropriately. States claims precisely matching what evidence supports. Recognizes that candid acknowledgment builds ethos.
**Timeline to mastery:** Counter-intuitive reversal that clicks when first experiencing how acknowledged limitations increase rather than decrease reader trust. Often requires seeing own overreaching claims rejected.
---
### Patch Writing
**Novice approach:** Stitches together source passages with minimal connecting sentences. Organizes paper following major source's structure. Demonstrates knowledge acquisition without original synthesis.
**Expert approach:** Uses sources to engage ongoing conversations through agreement, disagreement, or extension. Develops independent organizational structure. Shows what you can DO with information, not just that you found it.
**Timeline to mastery:** Requires role reversal from student-as-examiner to researcher-as-expert. Typically emerges when first making genuine discovery that contradicts or extends existing literature.
---
### Cherry-Picking Evidence
**Novice approach:** Uses one or two convenient examples appearing representative but actually anecdotal. Presents only supporting evidence, ignoring contradictory data. Hopes unrepresentativeness goes unnoticed.
**Expert approach:** Demonstrates representativeness through adequate samples. Acknowledges contradictory evidence and explains why interpretation remains valid, or candidly admits limitations. Recognizes arguments are only as strong as weakest evidence.
**Timeline to mastery:** Internalized after first experience having reviewer demolish argument by citing contradictory evidence you knew existed but ignored. Painful but permanent lesson.
---
### Student-Teacher Dynamic
**Novice approach:** Writes to demonstrate knowledge to teacher-as-examiner. Explains what assignment asked for. Uses phrases like "In this paper I will show..." Treats research as proving you did the work.
**Expert approach:** Positions self as expert sharing findings with interested peers. Reverses roles so researcher is authority with something new. Readers are colleagues who care about discoveries, not examiners grading performance.
**Timeline to mastery:** Critical threshold crossed when making first genuine contribution—discovering something even instructor doesn't know. Often coincides with first conference presentation or publication.
## Mental Models & Shibboleths
### "Research is conversation spanning millennia"
True researchers recognize they're joining ongoing dialogue, not discovering from scratch. They trace bibliographic trails backward (what sources cite) and forward (what cites sources), understanding each contribution responds to previous voices while anticipating future responses.
**Shibboleth usage:** "I'm following the bibliographic trail from Smith's primary sources" (expert) vs. "I found five sources on my topic" (novice).
---
### "Evidence is bedrock; reasons are built structures"
Evidence must be found in the world and made visible to readers—it stands alone. Reasons are assertions thought up by minds that require their own foundation. We base reasons on evidence, never evidence on reasons.
**Shibboleth usage:** "My reason needs stronger evidence" (expert) vs. "My evidence shows that..." when citing an assertion (novice confusing terms).
---
### "Thickening arguments through acknowledgment"
Strong arguments aren't thin straight lines from claim to evidence—they're thickened by acknowledging objections, alternative views, and limitations. Paradoxically, acknowledging what you don't know makes claims about what you do know more credible.
**Shibboleth usage:** "I need to thicken this section by acknowledging the Copenhagen interpretation" (expert understanding ethos) vs. "I won't mention that counterexample" (novice thinking concealment = strength).
---
### "Research as zigzagging through fog"
Research doesn't follow linear path from topic→thesis→notes→draft. It's recursive, uncertain, messy—searching for something you won't recognize until you see it. Plans guide but don't constrain.
**Shibboleth usage:** "My problem shifted as I discovered..." (expert accepting non-linearity) vs. "I can't start writing until I know exactly what I'll say" (novice expecting false certainty).
---
### "Primary/secondary sources are relative, not absolute"
Source classification depends on YOUR research project, not inherent properties. Same source can be primary for one study, secondary for another. Key question: How many steps removed from phenomena you're studying?
**Shibboleth usage:** "For my purposes, this is a primary source because..." (expert understanding relativity) vs. "This is a secondary source" (novice treating as fixed category).
---
### "Problem significance measured by reader's cost, not researcher's interest"
The worst response isn't "I disagree" but "I don't care." Problems must be framed from reader's perspective showing consequences THEY care about, not just explaining your curiosity.
**Shibboleth usage:** "Readers in my field care about this because..." (expert framing) vs. "I'm interested in this topic because..." (novice framing).
## Temporal Knowledge
**19th century:** Primary/secondary source distinction originated with historians establishing evidence reliability; later became standard across disciplines as research professionalized.
**Early experimental science (~1700s):** Researchers relied on witnesses to attest experimental accuracy before standardized methodologies emerged as modern replacement for verification.
**Pre-Internet era (pre-1990s):** Citation indexing required hours/days with printed indexes. Card catalogs were standard. Bibliographic trail-following was laborious physical process.
**Contemporary era (post-2000):** Online databases make citation indexing instant, but information overload and unmonitored Internet content paradoxically make libraries and expert curation MORE essential, not less. Google ubiquity creates false confidence in research reliability.
**Field-specific temporal standards:** Currency requirements vary dramatically—molecular biology may require sources from last 2-3 years, while history may heavily cite centuries-old primary sources. Recognize your field's temporal norms.
## References
- Source: *The Craft of Research* (4th edition) by Wayne C. Booth, Gregory G. Colomb, Joseph M. Williams, Joseph Bizup, and William T. FitzGeraldRelated Skills
research-analyst
Conducts thorough landscape research, competitive analysis, best practices evaluation, and evidence-based recommendations. Expert in market research and trend analysis.
2026-legal-research-agent
Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape. Activate on "find expungement data", "scrape state laws", "legal research", "court URLs", "statute sources", "Clean Slate laws", "automatic expungement research". NOT for interpreting laws (use national-expungement-expert), building UI, or legal advice.
skill-coach
Guides creation of high-quality Agent Skills with domain expertise, anti-pattern detection, and progressive disclosure best practices. Use when creating skills, reviewing existing skills, or when users mention improving skill quality, encoding expertise, or avoiding common AI tooling mistakes. Activate on keywords: create skill, review skill, skill quality, skill best practices, skill anti-patterns. NOT for general coding advice or non-skill Claude Code features.
3d-cv-labeling-2026
Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).
wisdom-accountability-coach
Longitudinal memory tracking, philosophy teaching, and personal accountability with compassion. Expert in pattern recognition, Stoicism/Buddhism, and growth guidance. Activate on 'accountability', 'philosophy', 'Stoicism', 'Buddhism', 'personal growth', 'commitment tracking', 'wisdom teaching'. NOT for therapy or mental health treatment (refer to professionals), crisis intervention, or replacing professional coaching credentials.
windows-95-web-designer
Modern web applications with authentic Windows 95 aesthetic. Gradient title bars, Start menu paradigm, taskbar patterns, 3D beveled chrome. Extrapolates Win95 to AI chatbots, mobile UIs, responsive layouts. Activate on 'windows 95', 'win95', 'start menu', 'taskbar', 'retro desktop', '95 aesthetic', 'clippy'. NOT for Windows 3.1 (use windows-3-1-web-designer), vaporwave/synthwave, macOS, flat design.
windows-3-1-web-designer
Modern web applications with authentic Windows 3.1 aesthetic. Solid navy title bars, Program Manager navigation, beveled borders, single window controls. Extrapolates Win31 to AI chatbots (Cue Card paradigm), mobile UIs (pocket computing). Activate on 'windows 3.1', 'win31', 'program manager', 'retro desktop', '90s aesthetic', 'beveled'. NOT for Windows 95 (use windows-95-web-designer - has gradients, Start menu), vaporwave/synthwave, macOS, flat design.
win31-pixel-art-designer
Expert in Windows 3.1 era pixel art and graphics. Creates icons, banners, splash screens, and UI assets with authentic 16/256-color palettes, dithering patterns, and Program Manager styling. Activate on 'win31 icons', 'pixel art 90s', 'retro icons', '16-color', 'dithering', 'program manager icons', 'VGA palette'. NOT for modern flat icons, vaporwave art, or high-res illustrations.
win31-audio-design
Expert in Windows 3.1 era sound vocabulary for modern web/mobile apps. Creates satisfying retro UI sounds using CC-licensed 8-bit audio, Web Audio API, and haptic coordination. Activate on 'win31 sounds', 'retro audio', '90s sound effects', 'chimes', 'tada', 'ding', 'satisfying UI sounds'. NOT for modern flat UI sounds, voice synthesis, or music composition.
wedding-immortalist
Transform thousands of wedding photos and hours of footage into an immersive 3D Gaussian Splatting experience with theatre mode replay, face-clustered guest roster, and AI-curated best photos per person. Expert in 3DGS pipelines, face clustering, aesthetic scoring, and adaptive design matching the couple's wedding theme (disco, rustic, modern, LGBTQ+ celebrations). Activate on "wedding photos", "wedding video", "3D wedding", "Gaussian Splatting wedding", "wedding memory", "wedding immortalize", "face clustering wedding", "best wedding photos". NOT for general photo editing (use native-app-designer), non-wedding 3DGS (use drone-inspection-specialist), or event planning (not a wedding planner).
websocket-streaming
Implements real-time bidirectional communication between DAG execution engines and visualization dashboards via WebSocket. Covers connection management, typed event protocols, reconnection with backoff, and React hook integration. Activate on "WebSocket", "real-time updates", "live streaming", "execution events", "state streaming", "push notifications". NOT for HTTP REST APIs, server-sent events (SSE), or general networking.
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Activate on: Playwright, webapp testing, browser automation, E2E testing, UI testing. NOT for API-only testing without browser, unit tests, or mobile app testing.