academic-homepage-generator

---
name: academic-homepage-generator
description: When the user requests to create or customize an academic personal website from a GitHub template repository. This skill handles the complete workflow of forking academic template repositories (like academicpages.github.io), extracting structured personal information from memory or provided data, and systematically updating configuration files (_config.yml), navigation menus (_data/navigation.yml), content pages (_pages/about.md), and publication listings (_publications/). It specifically handles academic profiles including personal details, education background, research experience, publications, skills, and contact information. Triggers include requests to 'fork and customize academic homepage', 'build personal academic website', 'create research portfolio', or 'set up GitHub pages with academic template'.
---
# Skill: Academic Homepage Generator

## Primary Objective
Fork a specified academic GitHub Pages template repository, rename it, and populate it with a user's personal academic information extracted from memory or provided data. The final output is a fully configured, personalized academic homepage ready to be hosted on GitHub Pages.

## Core Workflow
The skill follows a strict, sequential workflow to ensure a successful deployment. Deviations may cause errors.

1.  **Retrieve Personal Data**: Extract the user's structured academic profile from memory using `memory-read_graph`. This data is the single source of truth for all content updates.
2.  **Fork Template Repository**: Use `github-fork_repository` on the target template (e.g., `academicpages/academicpages.github.io`).
3.  **Identify User Account**: Use `github-get_me` to get the forking user's GitHub username.
4.  **Rename Repository**: Use `github-rename_repository` to give the fork a user-specified name (e.g., `LJT-Homepage`).
5.  **Analyze Repository Structure**: Examine key directories (`_pages/`, `_publications/`, `_data/`, `_config.yml`) to understand the template's layout.
6.  **Update Core Configuration Files**:
    *   `_config.yml`: Update site title, description, URL, and most importantly, the `author` section with personal details (name, bio, location, employer, email, social links).
    *   `_data/navigation.yml`: Simplify the site's main navigation menu. Typically, reduce it to only essential links like "Publications" as per user instruction.
    *   `_pages/about.md`: Completely replace the default content with a structured personal profile containing: Introduction, Research Interests, Education, Research Experience, Publications (listed in-text), Skills, and Contact Information.
7.  **Manage Publication Files**:
    *   Delete all existing sample files in the `_publications/` directory.
    *   Create new Markdown files for each of the user's publications, using a consistent naming convention (e.g., `YYYY-MM-DD-short-title.md`). Each file must contain valid YAML frontmatter (`title`, `collection`, `date`, `venue`, `citation`).
8.  **Final Verification**: Check that all key files (`_config.yml`, `_pages/about.md`, `_data/navigation.yml`) and publication entries have been correctly created and contain no placeholder data.

## Critical Constraints & Guardrails
*   **Data Fidelity**: Do not add, modify, or hallucinate any personal information. Use **only** the data provided in the memory graph. If information is missing (e.g., a specific social media link not in memory), leave the field blank in the configuration.
*   **Publication Inclusion**: List **all** publications from memory in the `about.md` page, clearly distinguishing between first-author and co-authored works. Also create individual publication Markdown files for each.
*   **Navigation Simplification**: Adhere to the user's request regarding the navigation menu. If asked to show only specific pages, remove all other links from `_data/navigation.yml`.
*   **No Extra Pages**: Do not create, enable, or modify pages beyond those explicitly mentioned in the workflow (e.g., do not activate blog, teaching, or portfolio sections unless specified).

## Required Tools
This skill requires sequential use of the following tools. Ensure all necessary permissions/scopes are available.
1.  `memory-read_graph`
2.  `github-fork_repository`
3.  `github-get_me`
4.  `github-rename_repository`
5.  `github-get_file_contents`
6.  `github-create_or_update_file`
7.  `github-delete_file`

## Failure Recovery
*   **Concurrent Write Conflicts**: If `github-create_or_update_file` or `github-delete_file` fails with a "409 conflict" error, fetch the latest repository state (`github-get_file_contents` on the root) to get the new `sha`, then retry the operation with the updated `sha`.
*   **Missing Data**: If a required field from the memory graph is empty, log a clear note and proceed, leaving the corresponding website field blank. Do not invent data.

## Output
The skill is complete when the user's forked GitHub repository contains all personalized files and the commit history shows successful updates. Provide the user with the URL to their new repository (e.g., `https://github.com/<username>/<repo-name>`).