All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.3.0 - 2025-12-14
-
Symlink support - Skills can now be symlinked into the skills directory (#3)
- Enables git-based skill updates by symlinking from a cloned repo
- Supports local skill development workflows
- Broken symlinks are gracefully skipped
-
Configurable output path - New
--output/-oflag for sync command (#5)- Sync to any
.mdfile (e.g.,.ruler/AGENTS.md) - Auto-creates file with heading if it doesn't exist
- Auto-creates nested directories if needed
- Sync to any
-
Local path installation - Install skills from local directories (#10)
- Supports absolute paths (
/path/to/skill) - Supports relative paths (
./skill,../skill) - Supports tilde expansion (
~/my-skills/skill)
- Supports absolute paths (
-
Private git repo support - Install from private repositories (#10)
- SSH URLs (
git@github.com:org/private-skills.git) - HTTPS with authentication
- Uses system SSH keys automatically
- SSH URLs (
-
Comprehensive test suite - 88 tests across 6 test files
- Unit tests for symlink detection, YAML parsing
- Integration tests for install, sync commands
- E2E tests for full CLI workflows
-
--yesflag now skips all prompts - Fully non-interactive mode for CI/CD (#6)- Overwrites existing skills without prompting
- Shows
Overwriting: <skill-name>message when skipping prompt - All commands now work in headless environments
-
CI workflow reordered - Build step now runs before tests
- Ensures
dist/cli.jsexists for E2E tests
- Ensures
- Path traversal protection - Validates installation paths stay within target directory
- Symlink dereference -
cpSyncusesdereference: trueto safely copy symlink targets - Non-greedy YAML regex - Prevents potential ReDoS in frontmatter parsing
1.2.1 - 2025-10-27
- README documentation cleanup - removed duplicate sections and incorrect flags
1.2.0 - 2025-10-27
--universalflag to install skills to.agent/skills/instead of.claude/skills/- For multi-agent setups (Claude Code + Cursor/Windsurf/Aider)
- Avoids conflicts with Claude Code's native marketplace plugins
- Project install is now the default (was global)
- Skills install to
./.claude/skills/by default
1.1.0 - 2025-10-27
- Comprehensive single-page README with technical deep dive
- Side-by-side comparison with Claude Code
- Location tag now correctly shows
projectorglobalbased on install location
1.0.0 - 2025-10-26
- Initial release
openskills install <source>- Install skills from GitHub reposopenskills sync- Generate<available_skills>XML for AGENTS.mdopenskills list- Show installed skillsopenskills read <name>- Load skill content for agentsopenskills manage- Interactive skill removalopenskills remove <name>- Remove specific skill- Interactive TUI for all commands
- Support for Anthropic's SKILL.md format
- Progressive disclosure (load skills on demand)
- Bundled resources support (references/, scripts/, assets/)