AgentSkillsCN

academic-homepage-generator

当用户请求从GitHub模板仓库创建或自定义学术个人网站时，此技能会完整地完成工作流程：从学术模板仓库（如academicpages.github.io）进行分叉，从记忆或提供的数据中提取结构化的个人信息，并系统性地更新配置文件（_config.yml）、导航菜单（_data/navigation.yml）、内容页面（_pages/about.md）以及出版物列表（_publications/）。尤其擅长处理学术个人资料，包括个人详细信息、教育背景、科研经历、出版物、技能以及联系方式。触发条件包括“分叉并自定义学术主页”、“构建个人学术网站”、“创建科研作品集”或“使用学术模板搭建GitHub页面”。

SKILL.md
--- frontmatter
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>).