research-methodology-academic-writing - GitLite

KO | EN

gitlite — search

#self-hosted #mcp #http #privacy #electron #graphql #openai #codex #vue #claude

research-methodology-academic-writing

(★ 9)

Comprehensive Research Methodology & Academic Writing Skill for Hermes Agent - bilingual (Persian/English), covers paradigms, quantitative/qualitative/mixed methods, thesis/dissertation architecture, Iran/International standards, arts research, instructional design, bilingual glossary, templates, checklists, CLI tools

File Explorer

ZIP Download

- addie_model.svg
- mixed_methods_designs.svg
- paradigms_comparison.svg
- wineglass_model.svg
- arts_research_methods.md
- bilingual_glossary.md
- checklists.md
- instructional_design_models.md
- prompts.md
- readme.md
- templates.md
- helper_scripts.py
- chapter_templates.md
README.md
SKILL.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# اسکیل جامع روش‌های تحقیقاتی و نگارش علمی آکادمیک

**Version:** 1.0.0 | **Date:** 2026-07-19 | **Author:** PeDitX (Hermes Agent) | **License:** MIT

---

## 📋 Overview | 📋 خلاصه

**English:** This skill provides a **Single Source of Truth** for all methodological and academic writing needs of researchers, graduate/PhD students, scientific writers, and university faculty. All content is based on **classic global references** (Creswell, Yin, APA, Lincoln & Guba, Johnson & Onwuegbuzie) and **Iran's official standards** (Ministry of Science, Academy of Persian Language, university styles).

**فارسی:** این اسکیل یک **مرجع کامل و واحد** (Single Source of Truth) برای تمام نیازهای روش‌شناختی و نگارشی محققان، دانشجویان ارشد/دکترا، نویسندگان علمی، و اساتید دانشگاه‌ها فراهم می‌کند. تمام محتوا بر پایه **منابع کلاسیک جهانی** (Creswell, Yin, APA, Lincoln & Guba, Johnson & Onwuegbuzie) و **استانداردهای رسمی ایران** (وزارت علوم، فرهنگستان، استایل‌های دانشگاهی) تدوین شده است.

---

## 🎯 Coverage Areas (14 Domains) | 🎯 حوزه‌های پوشش‌داده شده (۱۴ حوزه اصلی)

| # | Domain / حوزه | Description / توضیح |
|---|--------------|-------------------|
| **1** | **Research Paradigms / پردیس‌های فلسفی** | Positivism, Constructivism, Pragmatism, Critical Theory — with full comparison matrix |
| **2** | **Quantitative Methods / روش‌های کمی** | Experimental/Non-experimental designs, Meta-analysis, Descriptive/Inferential stats, SEM, MLM, IRT |
| **3** | **Qualitative Methods / روش‌های کیفی** | 7 Approaches (Ethnography, GT, Phenomenology, Narrative, Case Study, Discourse, IPA), Trustworthiness |
| **4** | **Mixed Methods / روش‌های مختلط** | 4 Creswell Design Classes, Integration Strategies, Multiple Validities Legitimation |
| **5** | **Research Design & Sampling / طراحی و نمونه‌گیری** | Design Classification, Research Logic, Probability/Non-probability Sampling, Sample Size Calculation |
| **6** | **Validity & Reliability / روایی و پایایی** | 8 Quantitative Validities, Lincoln & Guba 4 Criteria, CTT/IRT, Mixed Methods Validities |
| **7** | **Research Ethics / اخلاقیات پژوهش** | Belmont Principles, Informed Consent, IRB, Vulnerable Populations, FFP/QRPs, COI, Open Science |
| **8** | **Academic Writing IMRAD / نگارش علمی IMRAD** | Abstract, Funnel Introduction, 5-Step Lit Review, Methods, Results, Discussion, Conclusion |
| **9** | **Citation Styles (Global) / استایل‌های استنادی جهانی** | APA 7th, MLA 9th, Chicago 18th, Harvard, IEEE, Vancouver — with Comparison Tables |
| **10** | **Iran Standards / استانداردهای ایران** | Ministry of Science Guidelines, Tehran/Sharif Styles, ISIRI 3342, Farhangestan Terminology, Persian Tables/Figures |
| **11** | **Thesis/Dissertation Architecture / معماری پایان‌نامه** | Master vs PhD Differences, Chapter Structure, Proposal (14 Elements), Defense, Evaluation, Submission Checklist |
| **12** | **Bilingual Academic Glossary / بانک لغات تخصصی دو زبانه** | 500+ Terms Persian↔English, 11 Categories, Export: CSV/JSON/Anki/LaTeX |
| **13** | **Arts & Performing Arts Research / رشته‌های هنری/نمایشی** | PbR, Practice-led, ABR (A/R/Tography, Poetic Inquiry), PaR, Artistic Evaluation Criteria |
| **14** | **Book→Courseware Conversion / تبدیل محتوا به جزوه درسی** | ADDIE, Backward Design, Bloom Revised, Mayer's 12 Principles, SCORM/xAPI, WCAG 2.1 AA, Ministry Regulations |

---

## 📁 Skill File Structure | 📁 ساختار فایل‌های اسکیل

```
~/.hermes/skills/research/research-methodology-academic-writing/
├── SKILL.md                           # Main documentation
├── references/
│   ├── bilingual_glossary.md          # 500+ Persian↔English technical terms
│   ├── templates.md                   # LaTeX/Word/Overleaf templates for thesis/proposal
│   ├── arts_research_methods.md       # Arts/Performing arts research methods (PbR/ABR/PaR)
│   ├── instructional_design_models.md # ADDIE, Backward Design, Book→Courseware conversion
│   ├── checklists.md                  # 7 comprehensive checklists
│   ├── prompts.md                     # 10 ready-to-use prompts for common tasks
│   └── readme.md                      # This file
├── templates/
│   └── chapter_templates.md           # Chapter 1-5 thesis templates
├── scripts/
│   └── helper_scripts.py              # CLI tools: Glossary export, Ref validation, Thesis validation, Gantt, SCORM
└── assets/
    ├── paradigms_comparison.svg       # 3 Paradigms comparison diagram
    ├── wineglass_model.svg            # IMRAD Wineglass Model
    ├── mixed_methods_designs.svg      # 4 Creswell Mixed Methods Designs
    └── addie_model.svg                # ADDIE Instructional Design Model
```

---

## 🚀 Quick Start | 🚀 نحوه استفاده

### 1. Load Skill in Hermes | ۱. بارگذاری اسکیل در هرمس
```bash
hermes skill load research-methodology-academic-writing
```

### 2. Use Ready Prompts in Code | ۲. استفاده از پرامپت‌های آماده
```python
from hermes_tools import skill_view

# View prompts
prompts = skill_view(name="research-methodology-academic-writing", 
                     file_path="references/prompts.md")

# Use in execute_code
skill = skill_view(name="research-methodology-academic-writing")
```

### 3. Run Helper Scripts (CLI) | ۳. اجرای اسکریپت‌های کمکی

```bash
# Generate glossary exports (CSV, JSON, Anki, LaTeX, MD)
python scripts/helper_scripts.py glossary \
  --input references/bilingual_glossary.md \
  --output exports/glossary \
  --format csv json anki latex md

# Validate BibTeX references (APA 7th or Tehran Style)
python scripts/helper_scripts.py validate-refs \
  --bib references.bib \
  --style apa7

# Validate thesis directory structure
python scripts/helper_scripts.py validate-thesis \
  --path ./my_thesis_project

# Generate Gantt chart (Mermaid + Excel)
python scripts/helper_scripts.py gantt \
  --output exports/timeline \
  --format mermaid excel \
  --start-year 2026

# Package SCORM course
python scripts/helper_scripts.py scorm \
  --source ./course_package \
  --output course.zip \
  --meta course_metadata.json
```

---

## 📚 Core References | 📚 منابع مرجع اصلی

### Research Methodology / متدولوژی پژوهش
- **Creswell & Creswell (2023).** *Research Design: Qualitative, Quantitative, and Mixed Methods Approaches* (6th ed.). Sage.
- **Yin (2018).** *Case Study Research and Applications* (6th ed.). Sage.
- **Tashakkori & Teddlie (2021).** *SAGE Handbook of Mixed Methods* (2nd ed.). Sage.
- **Johnson, Onwuegbuzie, & Turner (2007).** Toward a definition of mixed methods research. *JMMR*.
- **Lincoln & Guba (1985).** *Naturalistic Inquiry*. Sage. ← Trustworthiness Classics

### Academic Writing & Citation Styles / نگارش علمی و استایل‌ها
- **APA Publication Manual (7th ed., 2020).** Official APA Reference.
- **MLA Handbook (9th ed., 2021).** Official MLA Reference.
- **Chicago Manual of Style (18th ed., 2024).** Official CMOS Reference.
- **IEEE Editorial Style Manual (2025).** IEEE Reference.
- **Glasman-Deal (2009).** *Science Research Writing for Non-Native Speakers*. Imperial College Press.
- **Hofmann (2020).** *Scientific Writing and Communication*. Oxford UP.

### Iran Standards / استانداردهای ایران
- **Ministry of Science, Research and Technology.** *Thesis Writing Guidelines* (Updated 1402).
- **University of Tehran / Sharif.** *Thesis Writing Guides* (Localized APA/IEEE Styles).
- **Academy of Persian Language and Literature.** *Specialized Terminology* (farhangestan.ir).
- **Iran National Standard.** *ISIRI 3342* (Citation).

### Instructional Design / طراحی آموزشی
- **Branch (2009).** *Instructional Design: The ADDIE Approach*. Springer.
- **Wiggins & McTighe (2005).** *Understanding by Design* (2nd ed.). ASCD.
- **Mayer (2009).** *Multimedia Learning* (2nd ed.). Cambridge UP.
- **Quality Matters / OLC.** Rubrics & Scorecards.

---

## 🎨 Visual Assets (SVG) | 🎨 نمودارهای بصری

| File / فایل | Description / توضیح | Use Case / کاربرد |
|------------|-------------------|------------------|
| `paradigms_comparison.svg` | 3 Paradigms Comparison (Positivism/Constructivism/Pragmatism) | Defense Slides, Ch 3, Teaching |
| `wineglass_model.svg` | IMRAD Wineglass Model (Intro/Discussion Symmetry) | Article Writing, IMRAD Teaching |
| `mixed_methods_designs.svg` | 4 Creswell Designs with Symbols & Integration | Mixed Methods, Proposal |
| `addie_model.svg` | ADDIE + Backward Design + Phase Details | Courseware Design, ID Projects |

---

## 📦 Installation & Deployment to peditx Account | 📦 نصب و استقرار در اکانت peditx

```bash
# 1. Clone repo (in peditx account)
git clone https://github.com/peditx/research-methodology-academic-writing.git
cd research-methodology-academic-writing

# 2. Copy to Hermes skills directory
cp -r research-methodology-academic-writing ~/.hermes/skills/

# 3. Load in Hermes
hermes skill load research-methodology-academic-writing

# 4. Verify version
hermes skill view research-methodology-academic-writing
```

**Prerequisites / پیش‌نیازها:**
- Python 3.11+ with: `pandas`, `pylatexenc`, `csl-json`, `zotero-api`, `openpyxl`, `lxml`
- LaTeX (TeX Live/MiKTeX) for thesis templates
- Zotero/EndNote/Mendeley for reference management
- Docker (optional) for data analysis containers

---

## 🤝 Contributing | 🤝 مشارکت

1. Fork repo at `https://github.com/peditx/research-methodology-academic-writing`
2. New branch: `git checkout -b feature/new-methodology`
3. Changes + test: `python scripts/test_skill.py`
4. Commit: `git commit -m "feat: add new arts research method"`
5. Push + PR

**Contributing Guide:** `CONTRIBUTING.md` in repo root

---

## 📞 Support & Contact | 📞 پشتیبانی و ارتباط

- **GitHub Issues:** Bugs, Feature Requests, Documentation Improvements
- **Discussions:** Methodological Questions, Writing Consultation
- **Email:** research@peditx.ir (Specialized Thesis/Proposal Consultation)

---

## ⚠️ Known Limitations | ⚠️ محدودیت‌ها و سقف‌ها

| Limitation / محدودیت | Description / توضیح | Upgrade Path / راهکار ارتقا |
|---------------------|-------------------|---------------------------|
| **University Styles** | Each university has custom modifications | Add university-specific templates in `templates/university_specific/` |
| **Iran Copyright Law** | Recent changes in Author Protection Law | Monthly update `references/iran_copyright_law.md` |
| **AI Tools in Research** | New COPE/ICMJE Guidelines for GenAI | Module `ethics/ai_usage_guidelines.md` |
| **Persian Journal Indexing** | Limited indexing for Persian articles | Guide `publishing/persian_journals_strategy.md` |

---

## 📜 License | 📜 مجوز

MIT License — Free to Use, Modify, Distribute. Full text in `LICENSE`.

---

## 💎 Key Principle | 💎 نکته کلیدی

> **This skill is designed as a Single Source of Truth for all your methodological and academic writing needs. All content is grounded in classic global references and Iran's official standards.**

> **این اسکیل به عنوان مرجع واحد (Single Source of Truth) برای تمام نیازهای روش‌شناختی و نگارشی شما طراحی شده. تمام محتوا بر پایه منابع کلاسیک جهانی و استانداردهای رسمی ایران تدوین شده است.**

> **_"The best research is that in which question, paradigm, method, and analysis move in concert within a coherent system."_** — From Skill Text

---

**Last Updated:** 2026-07-19 | **Version:** 1.0.0