Skill Tracer
Skills › Scientific Agent Skills › markdown-mermaid-writing › research_paper.md

research_paper.md

306 lines · skills/markdown-mermaid-writing/templates/research_paper.md at 5f2bc03

Open on GitHub
1<!-- Source: https://github.com/SuperiorByteWorks-LLC/agent-project | License: Apache-2.0 | Author: Clayton Young / Superior Byte Works, LLC (Boreal Bytes) -->
2
3# Research Paper / Technical Analysis Template
4
5> **Back to [Markdown Style Guide](../references/markdown_style_guide.md)** — Read the style guide first for formatting, citation, and emoji rules.
6
7**Use this template for:** Research papers, technical analyses, literature reviews, data-driven reports, competitive analyses, market research, or any document built around evidence and methodology. Designed for heavy citation, structured argumentation, and reproducible findings.
8
9**Key features:** Abstract for quick assessment, methodology section for credibility, findings with supporting data/diagrams, rigorous footnote citations throughout, and a complete references section.
11**Philosophy:** A great research document lets the reader evaluate your conclusions independently. Show your work. Cite your sources. Present counter-arguments. The reader should trust your findings because the evidence is right there — not because you said so.
13---

<!-- Source: https://github.com/SuperiorByteWorks-LLC/agent-project | License: Apache-2.0 | Author: Clayton Young / Superior Byte Works, LLC (Boreal Bytes) -->

Research Paper / Technical Analysis Template

Back to Markdown Style Guide — Read the style guide first for formatting, citation, and emoji rules.

Use this template for: Research papers, technical analyses, literature reviews, data-driven reports, competitive analyses, market research, or any document built around evidence and methodology. Designed for heavy citation, structured argumentation, and reproducible findings.

Key features: Abstract for quick assessment, methodology section for credibility, findings with supporting data/diagrams, rigorous footnote citations throughout, and a complete references section.

Philosophy: A great research document lets the reader evaluate your conclusions independently. Show your work. Cite your sources. Present counter-arguments. The reader should trust your findings because the evidence is right there — not because you said so.


Raw lines 1 to 14
15## How to Use
171. Copy this file to your project
182. Replace all `[bracketed placeholders]` with your content
193. Adjust sections — not every paper needs every section, but the core flow (Abstract → Introduction → Methodology → Findings → Conclusion) should stay intact
204. **Cite aggressively** — every claim, every statistic, every external methodology reference gets a `[^N]` footnote
215. Add [Mermaid diagrams](../references/mermaid_style_guide.md) for any process, architecture, data flow, or comparison
23---

How to Use

  1. Copy this file to your project
  2. Replace all [bracketed placeholders] with your content
  3. Adjust sections — not every paper needs every section, but the core flow (Abstract → Introduction → Methodology → Findings → Conclusion) should stay intact
  4. Cite aggressively — every claim, every statistic, every external methodology reference gets a [^N] footnote
  5. Add Mermaid diagrams for any process, architecture, data flow, or comparison

Raw lines 15 to 24
25## Template Structure
27```
281. Abstract — What you did, what you found, why it matters (150-300 words)
292. 📋 Introduction — Problem statement, context, scope, research questions
303. 📚 Background — Prior work, literature review, industry context
314. 🔬 Methodology — How you did the research, data sources, approach
325. 📊 Findings — What you discovered, with evidence and diagrams
336. 💡 Analysis — What the findings mean, implications, limitations
347. 🎯 Conclusions — Summary, recommendations, future work
358. 🔗 References — All cited sources with full URLs
36```
38---

Template Structure

1. Abstract — What you did, what you found, why it matters (150-300 words)
2. 📋 Introduction — Problem statement, context, scope, research questions
3. 📚 Background — Prior work, literature review, industry context
4. 🔬 Methodology — How you did the research, data sources, approach
5. 📊 Findings — What you discovered, with evidence and diagrams
6. 💡 Analysis — What the findings mean, implications, limitations
7. 🎯 Conclusions — Summary, recommendations, future work
8. 🔗 References — All cited sources with full URLs

Raw lines 25 to 39
40## The Template
42Everything below the line is the template. Copy from here; commands, API routes,
43versions, thresholds, and numerical values are illustrative placeholders. Verify them
44against the actual project before publishing. Follow its existing tracker and PR conventions.
46---
48# [Paper Title: Descriptive and Specific]
50_[Author(s) or Team] · [Organization] · [Date]_
52---

The Template

Everything below the line is the template. Copy from here; commands, API routes, versions, thresholds, and numerical values are illustrative placeholders. Verify them against the actual project before publishing. Follow its existing tracker and PR conventions.


[Paper Title: Descriptive and Specific]

[Author(s) or Team] · [Organization] · [Date]


Raw lines 40 to 53
54## Abstract
56[150–300 word summary structured as: **Context** (1–2 sentences on the problem space), **Objective** (what this paper investigates), **Method** (how the research was conducted), **Key findings** (the most important results), **Significance** (why this matters and who should care).]
58**Keywords:** [keyword 1], [keyword 2], [keyword 3], [keyword 4], [keyword 5]
60---

Abstract

[150–300 word summary structured as: Context (1–2 sentences on the problem space), Objective (what this paper investigates), Method (how the research was conducted), Key findings (the most important results), Significance (why this matters and who should care).]

Keywords: [keyword 1], [keyword 2], [keyword 3], [keyword 4], [keyword 5]


Raw lines 54 to 61
62## 📋 Introduction

📋 Introduction

Raw lines 62 to 63
64### Problem statement
66[What problem exists? Why does it matter? Who is affected? Be specific — include metrics where available.]
68[The scope of the problem, with citation][^1].

Problem statement

[What problem exists? Why does it matter? Who is affected? Be specific — include metrics where available.]

[The scope of the problem, with citation][^1].

Raw lines 64 to 69
70### Research questions
72This paper investigates:
741. **[RQ1]** — [Specific, answerable question]
752. **[RQ2]** — [Specific, answerable question]
763. **[RQ3]** — [Specific, answerable question]

Research questions

This paper investigates:

  1. [RQ1] — [Specific, answerable question]
  2. [RQ2] — [Specific, answerable question]
  3. [RQ3] — [Specific, answerable question]
Raw lines 70 to 77
78### Scope and boundaries
80- **In scope:** [What this paper covers]
81- **Out of scope:** [What this paper deliberately excludes and why]
82- **Target audience:** [Who will benefit from these findings]
84<details>
85<summary><strong>💬 Context Notes</strong></summary>
87- Why this research was initiated
88- Organizational context or business driver
89- Relationship to prior internal work
90- Known constraints that shaped the scope
92</details>
94---

Scope and boundaries

  • In scope: [What this paper covers]
  • Out of scope: [What this paper deliberately excludes and why]
  • Target audience: [Who will benefit from these findings]

<details> <summary><strong>💬 Context Notes</strong></summary>

  • Why this research was initiated
  • Organizational context or business driver
  • Relationship to prior internal work
  • Known constraints that shaped the scope

</details>


Raw lines 78 to 95
96## 📚 Background

📚 Background

Raw lines 96 to 97
98### Industry context
100[Current state of the field. What's known. What the established approaches are. Cite existing work.]
102[Key finding from prior research][^2]. [Another relevant study found][^3].

Industry context

[Current state of the field. What's known. What the established approaches are. Cite existing work.]

[Key finding from prior research][^2]. [Another relevant study found][^3].

Raw lines 98 to 103
104### Prior work
106| Study / Source | Key Finding | Relevance to Our Work |
107| ------------------- | ----------------- | --------------------- |
108| [Author (Year)][^4] | [What they found] | [How it connects] |
109| [Author (Year)][^5] | [What they found] | [How it connects] |
110| [Author (Year)][^6] | [What they found] | [How it connects] |

Prior work

Study / SourceKey FindingRelevance to Our Work
[Author (Year)][^4][What they found][How it connects]
[Author (Year)][^5][What they found][How it connects]
[Author (Year)][^6][What they found][How it connects]
Raw lines 104 to 111
112### Gap in current knowledge
114[What's missing from existing research? What question remains unanswered? This is the gap your paper fills.]
116<details>
117<summary><strong>📋 Extended Literature Review</strong></summary>
119[Deeper discussion of related work, historical context, evolution of approaches, and detailed comparison of methodologies used by prior researchers. This depth supports the paper's credibility without cluttering the main flow.]
121</details>
123---

Gap in current knowledge

[What's missing from existing research? What question remains unanswered? This is the gap your paper fills.]

<details> <summary><strong>📋 Extended Literature Review</strong></summary>

[Deeper discussion of related work, historical context, evolution of approaches, and detailed comparison of methodologies used by prior researchers. This depth supports the paper's credibility without cluttering the main flow.]

</details>


Raw lines 112 to 124
125## 🔬 Methodology

🔬 Methodology

Raw lines 125 to 126
127### Approach
129[Describe your research methodology — qualitative, quantitative, mixed methods, experimental, observational, case study, etc.]
131```mermaid
132flowchart LR
133 accTitle: Research Methodology Flow
134 accDescr: Four-phase research process from data collection through analysis to validation and reporting
136 collect[📥 Data collection] --> clean[⚙️ Data cleaning]
137 clean --> analyze[🔍 Analysis]
138 analyze --> validate[🧪 Validation]
139 validate --> report[📤 Report findings]
141 classDef process fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
142 class collect,clean,analyze,validate,report process
143```

Approach

[Describe your research methodology — qualitative, quantitative, mixed methods, experimental, observational, case study, etc.]

flowchart LR
    accTitle: Research Methodology Flow
    accDescr: Four-phase research process from data collection through analysis to validation and reporting

    collect[📥 Data collection] --> clean[⚙️ Data cleaning]
    clean --> analyze[🔍 Analysis]
    analyze --> validate[🧪 Validation]
    validate --> report[📤 Report findings]

    classDef process fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
    class collect,clean,analyze,validate,report process
Raw lines 127 to 144
145### Data sources
147| Source | Type | Size / Scope | Collection Period |
148| ---------- | -------------------------------- | ------------------------- | ----------------- |
149| [Source 1] | [Survey / API / Database / etc.] | [N records / respondents] | [Date range] |
150| [Source 2] | [Type] | [Size] | [Date range] |

Data sources

SourceTypeSize / ScopeCollection Period
[Source 1][Survey / API / Database / etc.][N records / respondents][Date range]
[Source 2][Type][Size][Date range]
Raw lines 145 to 151
152### Tools and technologies
154- **[Tool 1]** — [Purpose and version]
155- **[Tool 2]** — [Purpose and version]
156- **[Analysis framework]** — [Why this was chosen]

Tools and technologies

  • [Tool 1] — [Purpose and version]
  • [Tool 2] — [Purpose and version]
  • [Analysis framework] — [Why this was chosen]
Raw lines 152 to 157
158### Limitations of methodology
160> ⚠️ **Known limitations:** [Be upfront about what could affect the validity of your results — sample size, selection bias, time constraints, data quality issues. This builds credibility, not weakness.]
162<details>
163<summary><strong>🔧 Detailed Methodology</strong></summary>

Limitations of methodology

⚠️ Known limitations: [Be upfront about what could affect the validity of your results — sample size, selection bias, time constraints, data quality issues. This builds credibility, not weakness.]

<details> <summary><strong>🔧 Detailed Methodology</strong></summary>

Raw lines 158 to 164
165### Data collection protocol
167[Step-by-step description of how data was gathered]

Data collection protocol

[Step-by-step description of how data was gathered]

Raw lines 165 to 168
169### Cleaning and preprocessing
171[What transformations were applied, what was excluded and why]

Cleaning and preprocessing

[What transformations were applied, what was excluded and why]

Raw lines 169 to 172
173### Statistical methods
175[Specific tests, confidence levels, software used]

Statistical methods

[Specific tests, confidence levels, software used]

Raw lines 173 to 176
177### Reproducibility
179[How someone else could replicate this research — data availability, code repositories, environment setup]
181</details>
183---

Reproducibility

[How someone else could replicate this research — data availability, code repositories, environment setup]

</details>


Raw lines 177 to 184
185## 📊 Findings
187### Finding 1: [Descriptive title]
189[Present the finding clearly. Lead with the conclusion, then show the evidence.]
191[Data supporting this finding][^7]:
193| Metric | Before | After | Change |
194| ---------- | ------- | ------- | ------- |
195| [Metric 1] | [Value] | [Value] | [+/- %] |
196| [Metric 2] | [Value] | [Value] | [+/- %] |
198> 📌 **Key insight:** [One-sentence takeaway from this finding]

Finding 1: [Descriptive title]

[Present the finding clearly. Lead with the conclusion, then show the evidence.]

[Data supporting this finding][^7]:

MetricBeforeAfterChange
[Metric 1][Value][Value][+/- %]
[Metric 2][Value][Value][+/- %]
📌 Key insight: [One-sentence takeaway from this finding]
Raw lines 187 to 199
200### Finding 2: [Descriptive title]
202[Present the finding. Include a diagram if the finding involves relationships, processes, or comparisons.]
204```mermaid
205xychart-beta
206 title "[Chart title]"
207 x-axis ["Category A", "Category B", "Category C", "Category D"]
208 y-axis "Measurement" 0 --> 100
209 bar [45, 72, 63, 89]
210```
212[Explanation of what the data shows and why it matters.]

Finding 2: [Descriptive title]

[Present the finding. Include a diagram if the finding involves relationships, processes, or comparisons.]

xychart-beta
    title "[Chart title]"
    x-axis ["Category A", "Category B", "Category C", "Category D"]
    y-axis "Measurement" 0 --> 100
    bar [45, 72, 63, 89]

[Explanation of what the data shows and why it matters.]

Raw lines 200 to 213
214### Finding 3: [Descriptive title]
216[Present the finding with supporting evidence.]
218<details>
219<summary><strong>📊 Supporting Data Tables</strong></summary>
221[Detailed data tables, raw numbers, statistical breakdowns that support the findings but would interrupt the reading flow if placed inline. Readers who want to verify can expand.]
223</details>
225---

Finding 3: [Descriptive title]

[Present the finding with supporting evidence.]

<details> <summary><strong>📊 Supporting Data Tables</strong></summary>

[Detailed data tables, raw numbers, statistical breakdowns that support the findings but would interrupt the reading flow if placed inline. Readers who want to verify can expand.]

</details>


Raw lines 214 to 226
227## 💡 Analysis
229### Interpretation
231[What do the findings mean? Connect back to your research questions. Explain the "so what?"]
233- **RQ1:** [How Finding 1 answers Research Question 1]
234- **RQ2:** [How Finding 2 answers Research Question 2]
235- **RQ3:** [How Finding 3 answers Research Question 3]

Interpretation

[What do the findings mean? Connect back to your research questions. Explain the "so what?"]

  • RQ1: [How Finding 1 answers Research Question 1]
  • RQ2: [How Finding 2 answers Research Question 2]
  • RQ3: [How Finding 3 answers Research Question 3]
Raw lines 229 to 236
237### Implications
239**For [audience 1]:**
241- [What this means for them and what action they should consider]
243**For [audience 2]:**
245- [What this means for them and what action they should consider]

Implications

For [audience 1]:

  • [What this means for them and what action they should consider]

For [audience 2]:

  • [What this means for them and what action they should consider]
Raw lines 237 to 246
247### Comparison with prior work
249[How do your findings compare with the studies referenced in the Background section? Do they confirm, contradict, or extend prior work?]

Comparison with prior work

[How do your findings compare with the studies referenced in the Background section? Do they confirm, contradict, or extend prior work?]

Raw lines 247 to 250
251### Limitations
253[What caveats should the reader keep in mind? What factors might affect generalizability? Be honest — this is where credibility is built.]
255<details>
256<summary><strong>💬 Discussion Notes</strong></summary>
258- Alternative interpretations of the data
259- Edge cases or outliers observed
260- Areas where more data would strengthen conclusions
261- Potential confounding variables
263</details>
265---

Limitations

[What caveats should the reader keep in mind? What factors might affect generalizability? Be honest — this is where credibility is built.]

<details> <summary><strong>💬 Discussion Notes</strong></summary>

  • Alternative interpretations of the data
  • Edge cases or outliers observed
  • Areas where more data would strengthen conclusions
  • Potential confounding variables

</details>


Raw lines 251 to 266
267## 🎯 Conclusions

🎯 Conclusions

Raw lines 267 to 268
269### Summary
271[3–5 sentences. Restate the problem, summarize the key findings, and state the primary recommendation. A reader who skips to this section should understand the entire paper's value.]

Summary

[3–5 sentences. Restate the problem, summarize the key findings, and state the primary recommendation. A reader who skips to this section should understand the entire paper's value.]

Raw lines 269 to 272
273### Recommendations
2751. **[Recommendation 1]** — [Specific, actionable. What to do, who should do it, expected impact]
2762. **[Recommendation 2]** — [Specific, actionable]
2773. **[Recommendation 3]** — [Specific, actionable]

Recommendations

  1. [Recommendation 1] — [Specific, actionable. What to do, who should do it, expected impact]
  2. [Recommendation 2] — [Specific, actionable]
  3. [Recommendation 3] — [Specific, actionable]
Raw lines 273 to 278
279### Future work
281- [Research direction 1] — [What it would investigate and why it matters]
282- [Research direction 2] — [What it would investigate and why it matters]
284---

Future work

  • [Research direction 1] — [What it would investigate and why it matters]
  • [Research direction 2] — [What it would investigate and why it matters]

Raw lines 279 to 285
286## 🔗 References
288_All sources cited in this paper:_
290[^1]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
292[^2]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
294[^3]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
296[^4]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
298[^5]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
300[^6]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
302[^7]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
304---
306_Last updated: [Date]_

🔗 References

All sources cited in this paper:

[^1]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>

[^2]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>

[^3]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>

[^4]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>

[^5]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>

[^6]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>

[^7]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>


Last updated: [Date]

Raw lines 286 to 306