github-stars-notion-sync
Installation
SKILL.md
GitHub Stars to Notion Sync Skill
This skill allows you to automate the process of exporting your GitHub starred repositories (grouped by custom lists/categories) and syncing them into a structured Notion database.
Instructions
When this skill is active, you can perform the following tasks:
1. Export GitHub Stars
Use the shell script in ./scripts/export_stars.sh to fetch all starred repositories and save them to ./assets/starred_lists.md.
- Requirement: GitHub CLI (
gh) must be installed and authenticated. - Output: A Markdown file with tables for each category.
2. Sync to Notion
Use the Python script in ./scripts/sync_stars_to_notion_db.py to parse the exported Markdown and populate a Notion database.
- Requirement:
NOTION_API_KEYenvironment variable must be set. - Requirement:
requestslibrary must be installed. - Config: Local state is tracked in
./assets/.notion_sync_config.json.