github-and-linkedin-engine

---
name: github-and-linkedin-engine
version: 1.0.0
description: "Package biomechanical research, software pipelines, and lab experiments into publication-ready GitHub repositories and craft high-impact, authentic LinkedIn showcase posts in Persian and English. Trigger when preparing a project for GitHub, authoring a scientific README, generating CITATION.cff, or writing LinkedIn research announcements without AI cringe."
tools: [bash, python, read_file, write_file]
metadata:
  platforms: [GitHub, LinkedIn]
  languages: [fa-IR, en-US]
  domain: research-dissemination
---

# GitHub Repository & LinkedIn Research Showcase Engine
# موتور انتشار پروژه‌ها در گیت‌هاب و تولید پست‌های حرفه‌ای لینکدین

## مأموریت (Mission)
تبدیل کدها، داده‌ها و آزمایش‌های بیومکانیک به ریپازیتوری‌های استاندارد و معتبر گیت‌هاب (همراه با README، نشان‌های پویا، فایل استناد و راهنمای بازتولید)، و تدوین پست‌های جذاب، موثق و مقتدرانه لینکدین به دو زبان فارسی و انگلیسی بدون کلیشه‌های مبتذل شرکتی («هیجان‌زده‌ام که اعلام کنم!») و بدون ردپای هوش مصنوعی.

---

## ۱. الزامات ریپازیتوری استاندارد گیت‌هاب (GitHub Standards)

یک مخزن تحقیقاتی بیومکانیک در گیت‌هاب باید شامل مؤلفه‌های زیر باشد:
1. **فایل `README.md` جذاب و جامع:**
   - عنوان، خلاصه یک‌خطی، نشان‌های وضعیت (Python version, License, Zenodo DOI, CI Status).
   - نمودار تصویری چشم‌نواز یا گیف متحرک از شبیه‌سازی/حرکت استخوان در OpenSim یا نمودار گیت.
   - معماری پروژه و فلوچارت داده‌ها (C3D $\rightarrow$ فیلترگذاری $\rightarrow$ دینامیک معکوس).
   - راهنمای گام‌به‌گام نصب، پیش‌نیازها و اجرای تست‌ها (`python -m pytest`).
   - استناد دانشگاهی (`BibTeX` و لینک مقاله).
2. **فایل استناد استاندارد (`CITATION.cff`):** برای امکان استناد مستقیم گیت‌هاب به مقاله یا ریپازیتوری شما.
3. **مشخصات وابستگی‌ها:** `pyproject.toml` یا `requirements.txt` بدون ابهام در نسخه‌ها.
4. **مجوز نرم‌افزار (`LICENSE`):** مجوز آزاد آکادمیک (معمولاً MIT یا Apache-2.0).

---

## ۲. فرمول طلایی پست لینکدین دانشگاهی (The 4-Part LinkedIn Architecture)

پست‌های لینکدین پژوهشگران باید ترکیبی از **کنجکاوی علمی**، **ارائه شواهد ملموس**، و **بینش فنی عمیق** باشد:

```
[۱. قلاب مسئله‌محور (The Hook)]
   یک پارادوکس بیومکانیکی یا چالش حل‌نشده در یک جمله جذاب و بدون کلیشه.
   ❌ "خوشحالم اعلام کنم مقاله جدیدم چاپ شد!"
   ✅ "چرا مفاصل زانو در سرعت‌های بالای راه رفتن تا ۴ برابر وزن بدن نیرو تحمل می‌کنند بدون آنکه غضروف تخریب شود؟"

[۲. راهکار و مداخله تجربی (The Intervention)]
   روش آزمایشگاهی، ابزارها و نوآوری در ۲ تا ۳ سطر کوتاه.
   "در آزمایشگاه بیومکانیک دانشگاه با استفاده از سیستم موکپ ۱۰ دوربینه و شبیه‌سازی دینامیک معکوس..."

[۳. داده‌های عددی و غافلگیری علمی (The Evidence & Insight)]
   اعداد واقعی، درصد بهبود، یا یافته‌ای که برخلاف انتظار بود.
   "یافته جالب: برخلاف تصور اولیه، اعمال گشتاور ارتز در فاز بارگیری..."

[۴. دعوت به گفتگو و لینک‌ها (The Takeaway & CTA)]
   طرح یک پرسش فنی، لینک به مخزن گیت‌هاب، مقاله یا فایل پیوست.
   "کد کامل پردازش داده‌های C3D و اسکریپت پایتون را در گیت‌هاب منتشر کردم: [لینک]"
```

---

## قوانین ضدکلیشه لینکدین (Anti-Cringe Guidelines)
- حذف عبارات تکراری و نچسب مانند: «افتخار این را داشتم»، «با کمال مسرت و مباهات»، «یک تجربه فوق‌العاده و بی‌نظیر»، «Excited to announce!».
- استفاده از تصویر واقعی در آزمایشگاه (کنار دوربین‌های موکپ، پوشیدن مارکرها یا نمودار برداری باکیفیت)، نه تصاویر تزئینی هوش مصنوعی بدون روح.
- در نسخه فارسی: رعایت دقیق نیم‌فاصله‌ها و اجتناب کامل از هکسره.

• SKILL.md 5 KB
• references/github_open_science_standards.md 4 KB
• references/linkedin_post_architecture.md 4 KB
• templates/linkedin_showcase_templates_bilingual.md 9 KB
• templates/project_readme_template.md 5 KB