numman-ali/openskills v1.2.0

v1.2.0 - Universal Skills Support

on GitHub

Major Features

🚀 Universal Skills Support (--universal flag)

Install skills to .agent/skills/ for use with any coding agent (Claude Code, Cursor, Windsurf, Aider) via AGENTS.md:

# Install to .agent/skills (universal)
openskills install anthropics/skills --universal

# Install to .agent/skills globally
openskills install anthropics/skills --global --universal

Use case: Advanced users running multiple coding agents with one AGENTS.md file. Avoids duplicates with Claude Code's native plugin system.

🎯 Project Install Now Default

Project install is now the default behavior (was global):

# Default: installs to .claude/skills (project)
openskills install anthropics/skills

# Advanced: install globally
openskills install anthropics/skills --global

Breaking: Removed --project flag, added --global flag.

📁 4 Installation Locations Supported

Priority order (read/list/sync check all locations):

1. .agent/skills/ (project universal)
2. ~/.agent/skills/ (global universal)
3. .claude/skills/ (project)
4. ~/.claude/skills/ (global)

🔍 Smart Deduplication

Skills with same name only show once in list (highest priority wins). Prevents duplicates when skills exist in both .agent/ and .claude/.

What's Changed

Added:

• --universal flag for .agent/skills/ installation
• --global flag (replaced --project)
• Support for 4 installation locations
• Deduplication in list/read/sync commands
• 2 new tests (11 total passing)

Changed:

• Default install location: global → project
• Priority order: .agent/ before .claude/

Removed:

• --project flag (project is now default)

Migration Guide

# Before v1.2.0
openskills install X              # Global install
openskills install X --project    # Project install

# After v1.2.0
openskills install X              # Project install (NEW DEFAULT)
openskills install X --global     # Global install
openskills install X --universal  # Universal (.agent/skills)

Use Cases

Claude Code only:

openskills install anthropics/skills
# → .claude/skills (default)

Claude Code + other agents (Cursor, Windsurf):

openskills install anthropics/skills --universal
# → .agent/skills (universal AGENTS.md)

Share skills across all projects:

openskills install anthropics/skills --global
# → ~/.claude/skills

Installation

npm i -g openskills@1.2.0

Full Changelog

v1.1.0...v1.2.0