Claude-skill-registry academic-homepage-generator
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'.
git clone https://github.com/majiayu000/claude-skill-registry
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/academic-homepage-generator" ~/.claude/skills/majiayu000-claude-skill-registry-academic-homepage-generator && rm -rf "$T"
skills/data/academic-homepage-generator/SKILL.mdSkill: 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.
- Retrieve Personal Data: Extract the user's structured academic profile from memory using
. This data is the single source of truth for all content updates.memory-read_graph - Fork Template Repository: Use
on the target template (e.g.,github-fork_repository
).academicpages/academicpages.github.io - Identify User Account: Use
to get the forking user's GitHub username.github-get_me - Rename Repository: Use
to give the fork a user-specified name (e.g.,github-rename_repository
).LJT-Homepage - Analyze Repository Structure: Examine key directories (
,_pages/
,_publications/
,_data/
) to understand the template's layout._config.yml - Update Core Configuration Files:
: Update site title, description, URL, and most importantly, the_config.yml
section with personal details (name, bio, location, employer, email, social links).author
: Simplify the site's main navigation menu. Typically, reduce it to only essential links like "Publications" as per user instruction._data/navigation.yml
: 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._pages/about.md
- Manage Publication Files:
- Delete all existing sample files in the
directory._publications/ - Create new Markdown files for each of the user's publications, using a consistent naming convention (e.g.,
). Each file must contain valid YAML frontmatter (YYYY-MM-DD-short-title.md
,title
,collection
,date
,venue
).citation
- Delete all existing sample files in the
- Final Verification: Check that all key files (
,_config.yml
,_pages/about.md
) and publication entries have been correctly created and contain no placeholder data._data/navigation.yml
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
page, clearly distinguishing between first-author and co-authored works. Also create individual publication Markdown files for each.about.md - 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.
memory-read_graphgithub-fork_repositorygithub-get_megithub-rename_repositorygithub-get_file_contentsgithub-create_or_update_filegithub-delete_file
Failure Recovery
- Concurrent Write Conflicts: If
orgithub-create_or_update_file
fails with a "409 conflict" error, fetch the latest repository state (github-delete_file
on the root) to get the newgithub-get_file_contents
, then retry the operation with the updatedsha
.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>).