Vaibhav Shukla

Vaibhav Shukla

Astrophysics MSc with hands-on expertise in scientific ML, generative AI, and data-driven research.

CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this project is

A personal academic website for Vaibhav Shukla, built on the Academic Pages Jekyll template (itself a fork of Minimal Mistakes). Hosted at https://whyvav.github.io via GitHub Pages. Jekyll transforms Markdown/YAML/HTML source files into a static site on every git push to main.

Running locally

Native Ruby on Windows (PowerShell) — Ruby 3.3 + DevKit is installed at C:\Ruby33-x64\.

First-time setup (already done):

gem install bundler
bundle install

Start the dev server (run this every time):

bundle exec jekyll serve -l -H localhost

Site is at http://localhost:4000. Stop with Ctrl+C.

Changing _config.yml requires restarting the server; Markdown/HTML changes hot-reload automatically.

Note: Gemfile includes tzinfo-data and wdm (Windows-required gems). Do not remove them.

_site/ (Jekyll’s compiled output) is gitignored — GitHub Pages re-runs Jekyll on push, so committing _site/ is never needed.

Architecture — how content flows

The site separates content (what you write) from presentation (the theme machinery). As a rule, never touch _layouts/, _includes/, _sass/, or assets/ unless you are intentionally restyling.

Content you will actually edit

WhatWhereKey front-matter fields
Home / About page_pages/about.mdplain prose + HTML notice block at top
CV (Markdown)_pages/cv.mdplain Markdown sections
Sidebar profile_config.yml → author: blockavatar, bio, location, employer, email, social links
Navigation bar_data/navigation.ymladd/remove/reorder top-level links
Publications_publications/*.mdtitle, collection: publications, category (manuscripts/conferences/books), date, venue, paperurl, slidesurl, bibtexurl, citation
Talks_talks/*.mdtitle, collection: talks, type (Talk/Tutorial), date, venue, location
Teaching_teaching/*.mdtitle, collection: teaching, type, venue, date, location
Projects_projects/*.mdtitle, collection: projects, optional header.image
Blog posts_posts/YYYY-MM-DD-slug.mdtitle, date, tags, categories
Downloadable filesfiles/linked as /files/filename.pdf
Profile photoimages/profile.jpgreferenced in _config.yml author.avatar

File naming for dated collections: always YYYY-MM-DD-slug.md. The date in the filename drives sort order in archive pages and on the CV.

How the CV page works

_pages/cv.md contains hand-written Markdown sections (Education, Work, Skills, etc.) plus Liquid loops that pull from the collections automatically:







<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/publications/2026-vlm-ism-detection" rel="permalink">Vision-Language Model Detection of Interstellar Medium Structures
</a>
      
    </h3>
    
    <p class="archive__item-excerpt" itemprop="description">V. Shukla, et al. (in preparation). &quot;Vision-Language Model Detection of Interstellar Medium Structures.&quot; <i>Astronomy &amp; Astrophysics</i>.</p> 
    </li>
 </article>
</div>






<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/publications/2026-colorism-multimodal-ai" rel="permalink">An Empirical Exploration of Socioeconomic Linguistic Bias in Text-to-Image Generation
</a>
      
    </h3>
    
    <p class="archive__item-excerpt" itemprop="description">R. G. Maurya, V. Shukla, S. Panat (2026). &quot;An Empirical Exploration of Socioeconomic Linguistic Bias in Text-to-Image Generation.&quot; <i>Student Research Workshop, EACL 2026</i>.</p> 
    </li>
 </article>
</div>






<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/publications/2025-misinformation-llms" rel="permalink">Simulating Misinformation Propagation in Social Networks using LLMs
</a>
      
    </h3>
    
    <p class="archive__item-excerpt" itemprop="description">R. G. Maurya, V. Shukla, et al. (2025). &quot;Simulating Misinformation Propagation in Social Networks using LLMs.&quot; <i>LASS Workshop, ACM CIKM 2025</i>.</p> 
    </li>
 </article>
</div>







<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/talks/2026-03-eacl-srw" rel="permalink">An Empirical Exploration of Socioeconomic Linguistic Bias in Text-to-Image Generation
</a>
      
    </h3>
    <p class="page__meta"><i class="fa fa-clock" aria-hidden="true"></i> March 26, 2026</p>
    <p class="archive__item-excerpt" itemprop="description">Talk at Student Research Workshop (SRW), EACL 2026,  Malta</p>
    </li>
  </article>
</div>







<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/talks/2025-11-lass-cikm" rel="permalink">Simulating Misinformation Propagation in Social Networks using LLMs
</a>
      
    </h3>
    <p class="page__meta"><i class="fa fa-clock" aria-hidden="true"></i> November 01, 2025</p>
    <p class="archive__item-excerpt" itemprop="description">Talk at 1st Workshop on LLM Agents for Social Simulation (LASS), ACM CIKM 2025,  Atlanta, GA, USA</p>
    </li>
  </article>
</div>







<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/talks/2025-06-junge-ag-potsdam" rel="permalink">X-ray Evolution of Supernova Remnants in the Large Magellanic Cloud
</a>
      
    </h3>
    <p class="page__meta"><i class="fa fa-clock" aria-hidden="true"></i> June 01, 2025</p>
    <p class="archive__item-excerpt" itemprop="description">Talk at "junge AG" Summer School, Astronomische Gesellschaft,  Potsdam, Germany</p>
    </li>
  </article>
</div>







<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/talks/2025-02-msc-thesis-defense" rel="permalink">X-ray Evolution of Supernova Remnants in the Large Magellanic Cloud
</a>
      
    </h3>
    <p class="page__meta"><i class="fa fa-clock" aria-hidden="true"></i> February 01, 2025</p>
    <p class="archive__item-excerpt" itemprop="description">Talk at MSc Thesis Colloquium, Dr. Karl Remeis-Sternwarte Bamberg (ECAP, FAU),  Bamberg, Germany</p>
    </li>
  </article>
</div>







<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/talks/2023-03-remeis-tmc" rel="permalink">The Taurus Molecular Cloud
</a>
      
    </h3>
    <p class="page__meta"><i class="fa fa-clock" aria-hidden="true"></i> March 01, 2023</p>
    <p class="archive__item-excerpt" itemprop="description">Talk at Interstellar Medium Seminar, Dr. Karl Remeis-Sternwarte Bamberg (ECAP, FAU),  Bamberg, Germany</p>
    </li>
  </article>
</div>







<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/talks/2023-02-ecap-ism-sun" rel="permalink">The Interstellar Medium Around the Sun
</a>
      
    </h3>
    <p class="page__meta"><i class="fa fa-clock" aria-hidden="true"></i> February 01, 2023</p>
    <p class="archive__item-excerpt" itemprop="description">Talk at Seminar on Particle Physics &amp; Astrophysics, Erlangen Centre for Astroparticle Physics (ECAP), FAU Erlangen-Nürnberg,  Erlangen, Germany</p>
    </li>
  </article>
</div>








<div class="list__item">
  <article class="archive__item" itemscope itemtype="http://schema.org/CreativeWork">
    <li>
    
    <h3 class="archive__item-title" itemprop="headline">
      
        <a href="https://whyvav.github.io/teaching/2023-remeis-lab-tutor" rel="permalink">Lab Tutor — Astronomical CCD Experiment
</a>
      
    </h3>
    
    <p class="archive__item-excerpt" itemprop="description"></p> 
    </li>
 </article>
</div>

So adding a file to _publications/ automatically populates both the Publications page and the CV.

Theme and visual settings

  • Theme variant: set site_theme in _config.yml. Options: default, air, sunrise, mint, dirt, contrast. Each has automatic light/dark mode.
  • Dark/light toggle: built into the masthead; no config needed.
  • Custom CSS: add to assets/css/main.scss (imports _sass/ partials; safe to append overrides at the bottom).

Bulk content generation

markdown_generator/ contains Jupyter notebooks that convert CSV/TSV spreadsheets into correctly-formatted Markdown files for publications and talks. Useful workflow when adding many entries at once.

Current content state

The site is populated with Vaibhav’s real academic/professional information. All upstream template examples have been replaced.

What is filled in

  • images/ — contains only site assets: favicons, profile.jpg, under_construction.gif, and the themes/ subfolder. Template placeholder images (editing-talk.png, bio-photo*.jpg, 500x300.png) have been deleted.
  • files/ — contains cv.pdf (linked from the CV page). Template bibtex1.bib still present — can be deleted (see below).
  • _pages/about.md — real bio (astrophysics focus, MSc FAU, current ML/VLM work). Has an “under construction” notice block with a GIF (/images/under_construction.gif) at the top.
  • _pages/cv.md — full CV: Education, Work Experience, Selected Projects, Publications (liquid loop), Interests & Skills, Workshops & Events, MSc Courses, Awards, Talks (liquid loop), Teaching (liquid loop). Has a “Download PDF” button linking to /files/cv.pdf.
  • _config.yml author: block — name, bio, location, employer, email, LinkedIn, GitHub (whyvav), arXiv, Google Scholar, ORCID filled in.
  • _data/navigation.yml — Publications, Projects, Talks, Teaching, CV. Blog Posts and Guide links removed.
  • _publications/ — 3 real entries: VLM ISM detection (in prep, manuscripts), Colorism/EACL 2026 (conferences), Misinformation LLMs/CIKM 2025 (conferences).
  • _talks/ — 6 real entries: 2 Remeis/ECAP seminars (2023), MSc thesis defense (Feb 2025), junge AG Potsdam (Jun 2025), LASS/CIKM 2025 (Nov 2025), EACL SRW 2026 (Mar 2026).
  • _teaching/ — 1 entry: Remeis CCD Lab Tutor (Apr 2023 – Oct 2024).
  • _projects/ — 3 entries: MSc thesis (LMC SNRs), Ising model (MCMC), Visualizing Relativity (BSc).

What still needs to be done / open items

  • _posts/ — 5 template blog post files remain (2012-..., 2013-..., 2014-..., 2199-...). Kept intentionally — blog posts may be added later. To re-enable the Blog Posts section in the nav, add it back to _data/navigation.yml.
  • files/bibtex1.bib — template artifact (fake example entry), nothing links to it. Delete it. For real per-publication BibTeX, add individual .bib files to files/ and set bibtexurl: /files/yourpaper.bib in the publication’s front matter.
  • CV PDF — files/cv.pdf should be kept up to date. The CV page links to it.
  • markdown_generator/ — template Jupyter notebooks, no longer needed for routine edits.

Deployment

Push to main → GitHub Actions builds the site → live at https://whyvav.github.io within ~1 minute. No manual deploy step.