SkillHome v1.0.0

SkillHome v1.0.0

Unified skill management for AI agents — one central repository, junctions/symlinks for every agent. Windows, Linux, macOS.

You can have many AI agents, but your skills should have only one home.

Install

npx skills add Haaaiawd/skillhome -g

Or download skillhome.zip below, extract to ~/.skillhome/, then:

python ~/.skillhome/bin/skillhome.py init
python ~/.skillhome/bin/skillhome.py sync

What's in the zip

skillhome/
├── bin/
│   └── skillhome.py    # Single-file CLI (all commands)
├── SKILL.md            # Skill definition for agent discovery
├── README.md
└── README.zh-CN.md

Requirements

• Python 3.8+
• Zero third-party dependencies
• Windows: NTFS junction (no admin needed)
• Linux/macOS: symlink

add command

skillhome add <source> -g installs a skill into the central repo and global-shares it to all agents:

• Local zip / directory → installed directly into the central repo. No npx needed. Handles non-UTF-8 SKILL.md (gb18030/gbk/utf-16 fallback), re-encodes to UTF-8 so downstream agents read cleanly.
• Remote source (owner/repo, URL) → wraps npx skills add, then auto-syncs.

Discovery

Auto-discovery scans by structural features, not by directory name. Any directory whose children follow the SKILL.md / .skill-metadata.yaml convention is found — regardless of what it's called. No hardcoded agent names, no special-case paths.