# Gmai Starship Page > Create, update, or delete a "Starship" project subpage for the GMAI Lab Jekyll website (repo: uni-medical/gmai-web). Handles both English and Chinese versions, uploads images, and updates the homepage landing panel link. Use when adding a new research project page, modifying an existing one, or removing it. Covers the full file chain: pages/projects/{slug}.md · pages/zh/projects/{slug}.md · index.md · zh/index.md · assets/images/projects/{slug}/. - Skill: `uni-medical/gmai-starship-page` (Agent Skill) - Install (CLI): `npx skillmds@latest add uni-medical/gmai-starship-page` - Raw SKILL.md: https://api.skillmd.com/api/skills/uni-medical/gmai-starship-page/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Research & Search - Author: uni-medical (https://skillmd.com/u/uni-medical) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/uni-medical/gmai-starship-page --- # GMAI Lab — Starship Project Subpage Skill ## Overview The GMAI Lab website has **five research sections** on its homepage (`index.md` / `zh/index.md`). Each section links to a dedicated "Starship" project subpage. Current implementations: | Section | Theme CSS class | Watermark | Current Starship | |---------|-----------------|-----------|------------------| | 1 — Medical Data Infrastructure | `vis-neural` | `01` | `/projects/imaging-x/` | | 2 — Medical Multimodal LLMs | `vis-genomics` | `02` | `/projects/gmai-vl/` | | 3 — Medical Image Segmentation | `vis-molecular` | `03` | `/projects/sam-med3d/` | | 4 — Clinical AI Systems | `vis-clinical` | `04` | `/projects/slide-chat/` | | 5 — Scalable Segmentation | `vis-stunet` | `05` | `/projects/stu-net/` | **Additional Starship pages** (not on landing but in project listing): - `/projects/medsegagent/` — MedSegAgent multi-agent segmentation - `/projects/ophclip/` — OphCLIP surgical video-language model ## Cross-Linking Requirements When creating a Starship subpage, also ensure: 1. **`_data/projects.yml`** has a matching entry with `slug`, `thumbnail`, `links` 2. **Landing page** (`index.md` + `zh/index.md`) links to the subpage (if featured) 3. **Thumbnail image** exists for the project listing page (`pages/projects.md`) 4. **`.rs-thumb`** floating thumbnail added inside the landing section's `.rs-text` div Use the existing subpages as ground-truth templates: - **EN template**: `pages/projects/imaging-x.md` or `pages/projects/sam-med3d.md` - **ZH template**: `pages/zh/projects/imaging-x.md` or `pages/zh/projects/sam-med3d.md` --- ## When to Use This Skill Trigger phrases / scenarios: - "Add a Starship subpage for [project name]" - "Create the GMAI-VL project page" - "我们来做 Section 2 的 Starship 子页" - "Update the SAM-Med3D page with new figures" - "Remove the imaging-x starship page" - "Change the Section 4 link to DTR-MAS" --- ## Prerequisites: Collect Before Starting Ask the user for (or derive from context): ### Required ``` SLUG kebab-case identifier, e.g. "gmai-vl" → used in all file paths & URLs SECTION homepage section number: 1 / 2 / 3 / 4 TITLE_EN English project title, e.g. "GMAI-VL" TITLE_ZH Chinese project title, e.g. "GMAI-VL" SUBTITLE_EN One-sentence italic subtitle (EN) SUBTITLE_ZH One-sentence italic subtitle (ZH) AREA_EN Short area label, e.g. "Medical Vision-Language Models" AREA_ZH Short area label, e.g. "医学多模态大模型" INSTITUTION_EN Lead institution + collaborators (EN) INSTITUTION_ZH Lead institution + collaborators (ZH) GITHUB_URL Full GitHub URL (or empty string if none) ARXIV_ID arXiv ID, e.g. "2411.14522" (or empty if none) INTRO_EN 2–3 paragraphs of introductory text (EN) INTRO_ZH 2–3 paragraphs of introductory text (ZH) HIGHLIGHTS List of 4 highlight objects (see format below) CONCLUSION_EN Conclusion callout paragraph (EN) CONCLUSION_ZH Conclusion callout paragraph (ZH) CONTRIBUTIONS_EN 4 bullet points (EN) CONTRIBUTIONS_ZH 4 bullet points (ZH) AUTHORS_EN Full comma-separated author list; PI "Junjun He" bold in AUTHORS_ZH Same list in ZH convention (usually same names) IMAGES List of image filenames the user will supply (placed in assets/images/projects/{SLUG}/) ``` ### Highlight object format ``` { number: "01" title_en: "Short highlight title" title_zh: "短标题" body_en: "1–2 paragraph body text (EN)" body_zh: "1–2 paragraph body text (ZH)" figure_file: "filename.png" # image in assets/images/projects/{SLUG}/ caption_en: "Figure caption (EN)" caption_zh: "Figure caption (ZH)" loading: "eager" | "lazy" # eager for first figure, lazy for rest } ``` ### Optional links ``` HUGGINGFACE_PAPER_URL (e.g. https://huggingface.co/papers/2411.14522) HUGGINGFACE_DATASET_URL (e.g. https://huggingface.co/datasets/...) DEMO_URL (live demo link) LINK_BTN_TEXT_EXTRA custom label for extra button ``` --- ## Repository & Stack Quick Reference ``` Repo: git@github.com:uni-medical/gmai-web.git Stack: Jekyll 4 · GitHub Pages · SCSS · No npm · No custom plugins Local: export GEM_HOME="$HOME/.local/share/gem/ruby/3.2.0" export PATH="$GEM_HOME/bin:$PATH" bundle exec jekyll serve --baseurl "" --port 4001 Deploy: git push origin main → GitHub Actions auto-deploys WSL2 note: jekyll --watch does NOT auto-regenerate on NTFS drives. Must Ctrl+C and restart server after every file change. ``` ### Key file map ``` index.md EN homepage (4 research sections) zh/index.md ZH homepage (mirrors EN, Chinese text) pages/projects/{slug}.md EN project subpage ← CREATE THIS pages/zh/projects/{slug}.md ZH project subpage ← CREATE THIS assets/images/projects/{slug}/ Images for the project ← UPLOAD HERE _data/publications.yml Publication metadata (authors, links) _data/team.yml Team member data _config.yml Site-wide settings (lab.pi_last = "He") ``` --- ## Operation: CREATE ### Step 1 — Create image directory ```bash mkdir -p /path/to/gmai-web/assets/images/projects/{SLUG} touch /path/to/gmai-web/assets/images/projects/{SLUG}/.gitkeep ``` If user has provided image files, place them in this directory. If images are pending, use the **placeholder `
` pattern** (see Image Placeholders section). ### Step 2 — Write EN subpage File: `pages/projects/{SLUG}.md` Use the template in the **EN Page Template** section below. Replace every `{PLACEHOLDER}` with the collected inputs. ### Step 3 — Write ZH subpage File: `pages/zh/projects/{SLUG}.md` Use the template in the **ZH Page Template** section below. Same structure, Chinese text, permalink `/zh/projects/{SLUG}/`. ### Step 4 — Update EN homepage link File: `index.md` Find the Section corresponding to {SECTION} (use watermark number to locate): ```
{SECTION_PADDED}
e.g. 02 ``` Within that section's `
` block, find and replace the `rs-link`: ```html View publications → Explore {TITLE_EN} → ``` ### Step 5 — Update ZH homepage link File: `zh/index.md` Same pattern as Step 4 but in the ZH file: ```html 查看论文 → 探索 {TITLE_ZH} → ``` ### Step 6 — Verify locally ```bash # Start server export GEM_HOME="$HOME/.local/share/gem/ruby/3.2.0" && export PATH="$GEM_HOME/bin:$PATH" bundle exec jekyll serve --baseurl "" --port 4001 # Check HTTP status curl -s -o /dev/null -w "%{http_code}" http://localhost:4001/projects/{SLUG}/ curl -s -o /dev/null -w "%{http_code}" http://localhost:4001/zh/projects/{SLUG}/ # Check content curl -s http://localhost:4001/projects/{SLUG}/ | grep -o "]*>[^<]*" curl -s http://localhost:4001/ | grep "rs-link" | head -8 ``` Expected: all return `200`, h1 contains the correct title, homepage links updated. ### Step 7 — Commit and push ```bash git add pages/projects/{SLUG}.md git add pages/zh/projects/{SLUG}.md git add assets/images/projects/{SLUG}/ git add index.md zh/index.md git commit -m "feat: add {TITLE_EN} Starship subpage" git push origin main ``` GitHub Actions deploys automatically. Live at: - `https://uni-medical.github.io/gmai-web/projects/{SLUG}/` - `https://uni-medical.github.io/gmai-web/zh/projects/{SLUG}/` --- ## Operation: UPDATE To update content on an existing Starship page: 1. **Read the file first**: `Read pages/projects/{SLUG}.md` 2. **Edit using Edit tool**: Use exact string matching 3. **If updating images**: Place new files in `assets/images/projects/{SLUG}/`, update `` paths 4. **Restart Jekyll** (WSL2 limitation) 5. **Commit**: `git add` changed files + `git commit -m "feat: update {SLUG} Starship content"` To update the landing panel text (tags, stats, body text, topics): - Edit the relevant `
` block in `index.md` and `zh/index.md` --- ## Operation: DELETE 1. Remove the subpage files: ```bash rm pages/projects/{SLUG}.md rm pages/zh/projects/{SLUG}.md rm -rf assets/images/projects/{SLUG}/ ``` 2. Revert the homepage links: - In `index.md`: change `rs-link` back to `{{ '/publications/' | relative_url }}` or appropriate fallback - In `zh/index.md`: same, revert to `{{ '/zh/publications/' | relative_url }}` 3. Commit: ```bash git add -A git commit -m "chore: remove {SLUG} Starship subpage" git push origin main ``` --- ## EN Page Template Copy verbatim and replace `{PLACEHOLDER}` tokens. ```markdown --- layout: page title: "{TITLE_EN}" permalink: /projects/{SLUG}/ lang: "en" ---
{AREA_EN}

{TITLE_EN}

{SUBTITLE_EN}

{INSTITUTION_EN}
{IF GITHUB_URL}GitHub{/IF} {IF ARXIV_ID}arXiv Paper{/IF} {IF HUGGINGFACE_PAPER_URL}🤗 HuggingFace Paper{/IF} {IF HUGGINGFACE_DATASET_URL}🤗 Dataset{/IF}
{HERO_IMAGE_ALT}
{HERO_CAPTION_EN}

{INTRO_PARAGRAPH_1_EN}

{INTRO_PARAGRAPH_2_EN}

🌟 Core Highlights

01 — {H1_TITLE_EN}

{H1_BODY_EN}

{H1_FIGURE_ALT}
{H1_CAPTION_EN}

02 — {H2_TITLE_EN}

{H2_BODY_EN}

{H2_FIGURE_ALT}
{H2_CAPTION_EN}

03 — {H3_TITLE_EN}

{H3_BODY_EN}

{H3_FIGURE_ALT}
{H3_CAPTION_EN}

04 — {H4_TITLE_EN}

{H4_BODY_EN}

{H4_FIGURE_ALT}
{H4_CAPTION_EN}
Conclusion

{CONCLUSION_EN}

Key Contributions

  • {CONTRIB_1_EN}
  • {CONTRIB_2_EN}
  • {CONTRIB_3_EN}
  • {CONTRIB_4_EN}

Authors

{AUTHORS_EN}

{IF GITHUB_URL}GitHub Repository{/IF} {IF ARXIV_ID}arXiv Paper{/IF} ← Back to Projects
``` --- ## ZH Page Template Same HTML structure, Chinese content, different front matter and breadcrumb. ```markdown --- layout: page title: "{TITLE_ZH} — GMAI Lab" permalink: /zh/projects/{SLUG}/ lang: "zh" ---
{AREA_ZH}

{TITLE_ZH}

{SUBTITLE_ZH}

{INSTITUTION_ZH}
{IF GITHUB_URL}GitHub{/IF} {IF ARXIV_ID}arXiv 论文{/IF} {IF HUGGINGFACE_PAPER_URL}🤗 HuggingFace{/IF}
{HERO_IMAGE_ALT_ZH}
{HERO_CAPTION_ZH}

{INTRO_PARAGRAPH_1_ZH}

{INTRO_PARAGRAPH_2_ZH}

🌟 核心亮点

01 — {H1_TITLE_ZH}

{H1_BODY_ZH}

{H1_FIGURE_ALT_ZH}
{H1_CAPTION_ZH}

02 — {H2_TITLE_ZH}

{H2_BODY_ZH}

{H2_FIGURE_ALT_ZH}
{H2_CAPTION_ZH}

03 — {H3_TITLE_ZH}

{H3_BODY_ZH}

{H3_FIGURE_ALT_ZH}
{H3_CAPTION_ZH}

04 — {H4_TITLE_ZH}

{H4_BODY_ZH}

{H4_FIGURE_ALT_ZH}
{H4_CAPTION_ZH}
结语

{CONCLUSION_ZH}

主要贡献

  • {CONTRIB_1_ZH}
  • {CONTRIB_2_ZH}
  • {CONTRIB_3_ZH}
  • {CONTRIB_4_ZH}

作者团队

{AUTHORS_ZH}

{IF GITHUB_URL}GitHub 仓库{/IF} {IF ARXIV_ID}arXiv 论文{/IF} ← 返回项目列表
``` --- ## Image Placeholders (when images not yet available) Replace `` with this pattern so the page looks intentional, not broken: ```html
[{FIGURE_LABEL} — to be added]
{CAPTION_EN}
``` When images arrive, replace the placeholder `
` with: ```html {ALT_TEXT} ``` Use `loading="eager"` for the first/hero image only. All others use `loading="lazy"`. --- ## Homepage Landing Panel Reference The landing page uses `.rs-section` blocks. Here is the minimal diff needed to wire a new Starship page to an existing section. Only the `.rs-link` line changes: ```html View publications → Explore GMAI-VL → ``` ```html 查看论文 → 探索 GMAI-VL → ``` **Do NOT touch anything else in the `.rs-section` blocks** — tags, stats, body text, and topics are independent of the subpage and are updated separately if needed. --- ## Verification Checklist After creating a Starship subpage, verify all of the following before committing: ``` EN subpage [ ] curl http://localhost:4001/projects/{SLUG}/ → HTTP 200 [ ]

contains correct title [ ] All images load (no 404 in browser DevTools) [ ] Resource link buttons present (GitHub, arXiv, etc.) [ ] Authors section has Junjun He in [ ] "← Back to Projects" link works ZH subpage [ ] curl http://localhost:4001/zh/projects/{SLUG}/ → HTTP 200 [ ]

contains correct title [ ] Content is in Chinese (not English copy-paste error) [ ] "← 返回项目列表" link works [ ] Breadcrumb links to /zh/projects/ Homepage integration [ ] curl http://localhost:4001/ | grep "projects/{SLUG}" returns a match [ ] curl http://localhost:4001/zh/ | grep "projects/{SLUG}" returns a match [ ] Click-through on live site works (Section N → subpage) Git [ ] git status shows correct files staged [ ] Commit message follows: feat: add {TITLE_EN} Starship subpage [ ] git push origin main succeeds [ ] GitHub Actions workflow passes (check Actions tab) ``` --- ## Notes on the GMAI Lab Jekyll Architecture - **No custom plugins**: All Liquid templates must use GitHub Pages whitelisted plugins only - **Baseurl**: In production the site is at `/gmai-web/` (set in `_config.yml`); always use `{{ '/path/' | relative_url }}` filter, never hardcode paths - **PI auto-bolding**: The publication card (`_includes/pub_card.html`) auto-bolds `site.lab.pi_last` ("He") in author lists. On subpages, manually wrap `Junjun He` in the authors paragraph - **SCSS layers**: Homepage styles live in `_sass/_home.scss`; subpage interior styles in `_sass/_components.scss`. Subpages use inline styles to avoid class naming conflicts - **Language system**: Data files (`_data/*.yml`) are shared; UI strings are in `_data/strings.yml` keyed by `en` / `zh`; page language set by `lang:` front matter - **WSL2 limitation**: `jekyll serve --watch` does NOT detect file changes on NTFS mounts. After every file edit, restart the server manually (`Ctrl+C` → re-run command)