Based on repository activity, growth velocity and community engagement.
24
Growth2/30
Activity9/25
Popularity3/25
Trust10/20
4
Stars
High
Sentiment
Votes
4
README.md
StarLearner-Nexus for Hermes Agent
Automatically turn your GitHub starred repositories into usable Hermes Agent skills.
🚀 Overview
StarLearner-Nexus is a Hermes Agent skill that transforms your GitHub starred repositories into a personalized, automatically-updating library of Hermes skills. Instead of manually creating skills for every interesting repo you find, this skill:
🌟 Features
Automated Repository Ingestion: Fetches your starred repositories from GitHub API
Intelligent Categorization: Sorts repositories by topic using keyword matching
Skill Generation: Creates complete Hermes skills (.SKILL.md) from repo data
Automatic Updates: Daily sync keeps your skill library current
Multiple Categories: Supports AI/ML, development tools, privacy, finance, and more
Easy Installation: Simple tap, install, and configure workflow
Cron-Ready: Designed for automatic daily execution via cron job
Once installed and configured, StarLearner-Nexus runs via:
# List available skills to find StarLearner-Nexus
hermes skills list
# Run the skill manually (fetches, categorizes, and generates skills)
hermes skills run starlearner-nexus --script daily_sync.sh
# Run individual steps if needed
hermes skills run starlearner-nexus --script fetch_starred_repos.sh
hermes skills run starlearner-nexus --script categorize_repos.py
hermes skills run starlearner-nexus --script generate_skills.py
🎯 Customization
Adjust Processing Limits
Edit the scripts to change how many repositories are processed:
Modify fetch_starred_repos.sh to adjust API call limits
Edit generate_skills.py to change the number of skills per category (currently top 5 by stars)
Modify Categorization Rules
Edit references/categories.json to:
Add/remove domains or adjust keywords
Change how repositories are classified into topics
Improve accuracy for your specific star collection
Change Schedule
Update the cronjob schedule using your preferred cron editor:
# To change from daily 2 AM to daily 9 AM:
0 9 * * * /path/to/.hermes/skills/starlearner-nexus/scripts/daily_sync.sh
🔧 Troubleshooting
No Skills Generated
Verify your GitHub token is configured: hermes auth list
Check that you have starred public repositories on GitHub
Some repositories may cause skill generation to fail with 'NoneType' object has no attribute 'strip' when repository data contains null values. To resolve:
Check execution logs for the specific repository causing the issue
Consider creating skills manually for problematic repositories
Verify repository metadata (description, topics) is not null
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
