v1.10.0 - Multi-Agent Native Support

🚀 skilz-cli v1.10.0 - Multi-Agent Native Support

This major release adds native support for 17 new AI coding agents, bringing total supported agents from 14 to 30+.

🎯 Issues Addressed

• Issue #46: ✅ Qwen Code native support (.qwen/skills/)
• Issue #47: ✅ Google Antigravity native support (.agent/skills/ project, ~/.gemini/antigravity/skills/ global)
• Issue #49: ✅ 23 additional agents from comprehensive popularity table

✨ New Features

Tier 1: Full Native Support (User + Project Level)

New agents with dedicated skill directories:

• Gemini CLI (highest priority per Issue #49)
• OpenHands - Autonomous AI software engineer
• Cline - AI coding assistant
• Goose - Lightweight terminal assistant
• Roo Code - Multi-file editing agent
• Kilo Code - Large-scale edit assistance
• Trae - AI coding assistant
• Droid (Factory) - Automation agent
• Clawdbot - Unique skills/ project root
• Kiro CLI - AI coding assistant
• Pi - AI coding assistant
• Neovate - AI coding assistant
• Zencoder - AI coding assistant
• Amp (Sourcegraph) - Developer tooling
• Qoder - AI coding assistant
• Command Code - AI coding assistant

Upgraded Agents

Existing agents upgraded to full native support:

• Cursor → ~/.cursor/skills/ + .cursor/skills/
• Windsurf → ~/.codeium/windsurf/skills/ + .windsurf/skills/
• GitHub Copilot → ~/.copilot/skills/ + .github/skills/
• Qwen Code → ~/.qwen/skills/ + .qwen/skills/
• Google Antigravity → ~/.gemini/antigravity/skills/ + .agent/skills/

🔧 Technical Changes

• Agent Detection Priority: Now follows Issue #49 GitHub popularity order (Gemini > OpenCode > OpenHands > Claude...)
• Native Skill Support: All new agents read skills directly from their dedicated directories
• No Config Sync: Native agents don't need AGENTS.md injection
• Unique Configurations:
  • Antigravity: .agent/skills/ (project) + ~/.gemini/antigravity/skills/ (global)
  • Clawdbot: skills/ (project root)
  • OpenCode: .opencode/skill/ (singular)

📚 Documentation Updates

• SUPPORTED_AGENTS.md: Complete rewrite with tier structure for all 30+ agents
• COMPREHENSIVE_USER_GUIDE.md: Updated agent table and examples
• USER_MANUAL.md: Updated with new agent examples and version 1.10.0

🧪 Testing

• 703 tests (up from 694)
• 88% code coverage maintained
• 9 new integration tests for new agents
• 40+ new unit tests for agent configurations

📦 Installation

pip install --upgrade skilz

💡 Usage Examples

# Install to new agents
skilz install mastering-git-cli --agent openhands
skilz install mastering-git-cli --agent cline
skilz install mastering-git-cli --agent goose
skilz install mastering-git-cli --agent antigravity

# List skills for specific agent
skilz list --agent openhands
skilz list --agent cline

🙏 Contributors

Thanks to all contributors who helped make this release possible!

---

Full Changelog: v1.9.4...v1.10.0

🚀 Skilz CLI v1.9.4: GitHub Shorthand URLs & Search Improvements

🚀 Skilz CLI v1.9.4 Release Notes

Release Date: January 21, 2026
Version: 1.9.4
Tag: v1.9.4

🎯 Overview

This release significantly improves the user experience with major enhancements to skill discovery and installation workflows. The highlight is GitHub shorthand URL support, making it much easier to install skills directly from search results.

✨ What's New

🔗 GitHub Shorthand URL Support (v1.9.4)

The Big Feature: You can now use GitHub shorthand URLs with the -g flag!

# ✅ NEW: This now works!
skilz install -g tfriedel/claude-office-skills

# ✅ OLD: This still works
skilz install -g https://github.com/tfriedel/claude-office-skills

How it works: When you use -g owner/repo, skilz automatically converts it to https://github.com/owner/repo behind the scenes.

Why this matters:

• 🎯 Easier workflow: Search → Copy repo name → Install directly
• ⚡ Faster typing: No need for full URLs
• 🔄 Seamless integration: Works with existing search results

🔍 Search Functionality Restored (v1.9.3)

Problem Fixed: skilz search was returning no results for any queries.

Solution: Complete overhaul of search logic:

• Better Query: Changed from {query} skill OR skills to {query} claude
• Smart Sorting: Results now sorted by GitHub stars (most popular first)
• More Results: Significantly improved result quality and quantity

Real Examples:

skilz search docx
# Returns 10 results, top: tfriedel/claude-office-skills (208 stars)

skilz search excel  
# Returns 94 results, top: mcp-excel-server (81 stars)

skilz search python
# Returns 10 results with relevant Claude/AI repositories

🛠️ Bug Fixes & Improvements

v1.9.2: OpenCode Directory Path Fix

• Fixed: OpenCode skills directory path
• Was: ~/.config/opencode/skills (plural) ❌
• Now: ~/.config/opencode/skill (singular) ✅
• Impact: skilz list --agent opencode now correctly finds installed skills

v1.9.1: Configuration & Path Improvements

• Usage Notes Fix: Usage instructions now only appear for agents that need them
  • Native agents (Claude, OpenCode, Codex): No usage notes clutter
  • Non-native agents (Gemini, Cursor, etc.): Clear usage instructions
• Path Consistency: Fixed directory paths for 8 non-native agents to use .skilz/skills

🎯 Complete Workflow Example

Here's how the improved workflow looks:

# 1. Search for skills
skilz search docx
# Found 10 skill(s) matching 'docx':
# tfriedel/claude-office-skills    208  Office document creation...

# 2. Install directly with shorthand
skilz install -g tfriedel/claude-office-skills
# Found 4 skills in repository:
#   [1] docx  (public/docx)
#   [2] pdf   (public/pdf)
#   [3] pptx  (public/pptx)  
#   [4] xlsx  (public/xlsx)

# 3. Select and install
# Select skill(s) [1-4, A, Q]: 1
# Installed: docx -> Claude Code (user) [git]

📊 Technical Details

Quality Assurance

• ✅ 659 tests passing (100% test suite success)
• ✅ Type safety: Full mypy compliance
• ✅ Code quality: Ruff linting passed
• ✅ Coverage: 85%+ test coverage maintained

Agent Support Matrix

Agent	Directory	Native Support	Config Sync
Claude Code	~/.claude/skills/	✅ All	❌ Not needed
OpenCode	~/.config/opencode/skill/	✅ All	❌ Not needed
Codex	~/.codex/skills/	✅ All	❌ Not needed
Gemini	~/.gemini/skills/	✅ With plugin	✅ GEMINI.md
Universal	~/.skilz/skills/	❌ None	✅ AGENTS.md
Others (8)	.skilz/skills/	❌ None	✅ AGENTS.md

Files Changed

• Core Logic: src/skilz/commands/install_cmd.py - GitHub shorthand support
• Search: src/skilz/commands/search_cmd.py - Query and sorting improvements
• Agents: src/skilz/agents.py - OpenCode path fix
• Config: src/skilz/config_sync.py - Usage notes logic
• Registry: src/skilz/agent_registry.py - Path consistency
• Tests: tests/test_agents.py - Updated for path changes

🔄 Migration Guide

For Existing Users

No action required! All existing functionality continues to work:

• Existing installations remain unchanged
• All previous command syntax still works
• Configuration files are automatically updated

New Capabilities

You can now use these new patterns:

# GitHub shorthand (NEW)
skilz install -g owner/repo

# Search and install workflow (IMPROVED)
skilz search <term>
skilz install -g <repo-from-results>

🐛 Known Issues

• Minor: Debug output may appear during GitHub shorthand URL conversion (cosmetic only)
• This will be addressed in a future patch release

📈 Impact Metrics

Before v1.9.4

• Search: ❌ No results returned
• Install: Required full GitHub URLs
• OpenCode: ❌ Skills not detected
• UX: Cluttered usage notes for all agents

After v1.9.4

• Search: ✅ 10-94 results per query
• Install: ✅ Shorthand URLs work
• OpenCode: ✅ Skills properly detected
• UX: ✅ Clean, agent-appropriate guidance

🙏 Acknowledgments

This release addresses multiple user pain points identified through community feedback:

• Simplified installation workflow
• Better skill discovery
• Improved agent compatibility
• Cleaner user interface

🔗 Links

• Repository: https://github.com/SpillwaveSolutions/skilz-cli
• Documentation: User Manual
• Issues: https://github.com/SpillwaveSolutions/skilz-cli/issues
• PyPI: https://pypi.org/project/skilz/

📦 Installation

New Installation

pip install skilz

Upgrade from Previous Version

pip install --upgrade skilz

Verify Installation

skilz --version
# skilz 1.9.4

skilz search test
# Should return results

---

Full Changelog: v1.9.3...v1.9.4

Questions? Open an issue or check our documentation.

---

📦 PyPI Release

✅ Now Available on PyPI: https://pypi.org/project/skilz/1.9.4/

Install or Upgrade

# New installation
pip install skilz

# Upgrade from previous version  
pip install --upgrade skilz

# Verify installation
skilz --version  # Should show: skilz 1.9.4

Release Status: ✅ Complete - Available on both GitHub and PyPI

Release v1.8.0

🎯 SKILZ CLI v1.8.0 - Major Feature Release

🚀 New Features

Enhanced List Command (SKILZ-68)

• ✅ Agent Column: Display user-friendly agent names (Claude Code, OpenAI Codex, etc.)
• ✅ --all Flag: Scan all 14+ supported agents (default: top 5 popular agents)
• ✅ Accurate Status: Fixed status reporting using correct manifest.skill_id
• ✅ JSON Enhancement: Added agent_display_name field for API consumers

Improved CLI Help (SKILZ-66)

• ✅ Complete Examples: All commands now have comprehensive usage examples
• ✅ Better Descriptions: Clearer command explanations and option details
• ✅ Full Discoverability: Every available option and pattern is documented

🐛 Bug Fixes

Visit Command URL Correction (SKILZ-70)

• ✅ Correct Marketplace URLs: Fixed base URL and slug format
• ✅ Clean Format: skillzwave.ai/agent-skill/owner__repo__skill
• ✅ Smart Organization Handling: Single skill names default to spillwavesolutions

📊 Quality Metrics

• 640 tests passed (88% coverage)
• Zero linting errors
• Zero type checking errors
• All quality gates passed

📦 Installation

pip install skilz==1.8.0
# or
pip install --upgrade skilz

🎯 Usage Examples

# Enhanced list command
skilz list                    # Shows Agent column, top 5 agents
skilz list --all             # Shows all 14+ agents
skilz list --json            # Includes agent_display_name

# Improved help
skilz --help                 # Complete examples for all commands

# Fixed visit command
skilz visit sdd              # Correct marketplace URL

---

Full changelog: https://github.com/SpillwaveSolutions/skilz-cli/blob/main/CHANGELOG.md

🚀 Skilz v1.7.0: NEW Install Format & Comprehensive E2E Testing

🚀 Skilz v1.7.0: Revolutionary Install Format & Comprehensive Testing

Major release featuring the revolutionary NEW install format with REST-first resolution, comprehensive Gemini CLI native support, and industry-leading E2E testing.

---

🎯 Headline Features

🆕 NEW Install Format Support (SKILZ-FORMAT-001)

The most intuitive way to install AI skills - now live!

# NEW Format (Recommended) - Intuitive GitHub-style format
skilz install anthropics/skills/algorithmic-art

# LEGACY Format - Backwards compatible  
skilz install anthropics_skills/algorithmic-art

# SLUG Format - Direct Firestore doc ID
skilz install anthropics__skills__algorithmic-art

Key Benefits:

• 🎯 Intuitive: Matches GitHub repository structure (owner/repo/skill)
• ⚡ REST-First: Tries marketplace API before GitHub fallback
• 🔄 100% Backwards Compatible: All existing skill IDs work unchanged
• 📊 Enhanced Logging: Verbose mode shows format detection and resolution method
• 🛡️ Robust Error Handling: Clear messages for invalid formats

🔍 Comprehensive E2E Testing Revolution

Industry-leading testing with real marketplace validation

We've implemented the most comprehensive E2E testing suite in the AI skills ecosystem:

🌐 REST Marketplace E2E Testing (scripts/test_rest_marketplace_e2e.sh)

• API Endpoint Validation: Tests live skillzwave.ai REST API reachability
• Format Detection Accuracy: Validates NEW/LEGACY/SLUG format recognition
• Real-World Resolution: Tests actual skill installation for all formats
• Error Handling: Validates 404/400 responses for non-existent skills
• Verbose Logging Verification: Confirms format detection and resolution logging
• Live API Integration: Uses real marketplace data, not mocks

📋 API Integration Testing (scripts/test_api_integration.sh)

• Endpoint Testing: Validates REST API endpoints with real data
• Response Validation: Checks JSON structure and required fields
• Error Scenarios: Tests invalid requests and error handling

🧪 Quality Metrics

• 633 Total Tests: All passing (100% success rate)
• 25 New API Client Tests: Comprehensive format detection and parsing
• Real API Testing: No mocks - tests against live skillzwave.ai API
• Multiple Test Layers: Unit → Integration → E2E → Live API

---

🔧 Technical Implementation

📡 Enhanced API Client Architecture

Major improvements to src/skilz/api_client.py:

• Replaced parse_skill_id(): Now supports 3 formats (NEW/LEGACY/SLUG)
• Enhanced is_marketplace_skill_id(): Recognizes all marketplace formats
• Added get_skill_id_format(): Returns format type for any skill ID
• Improved Error Messages: More descriptive errors for invalid formats
• REST-First Resolution: All marketplace formats try REST API before GitHub

📝 Enhanced Installer Logging

Verbose output improvements in src/skilz/installer.py:

$ skilz -v install anthropics/skills/theme-factory --agent claude
Using specified agent: Claude Code
Looking up skill: anthropics/skills/theme-factory
  [INFO] Skill ID format: NEW
  [INFO] Attempting REST API lookup at skillzwave.ai...
  [SUCCESS] REST API resolved skill: anthropics/skills/theme-factory

---

🎮 Gemini CLI Native Support

🏠 Native Skill Directories

• Project-level: Skills install to .gemini/skills/ (native location)
• User-level: Skills install to ~/.gemini/skills/ (native location)
• No Config Needed: Gemini reads directory natively (requires experimental.skills plugin)
• Auto-Detection: Detects Gemini from .gemini/ directory

🔄 Legacy Workflow Support

For users without experimental.skills plugin:

skilz install anthropics/skills/pdf-reader --agent universal --project --config GEMINI.md

---

🌐 Universal Agent Enhancements

📁 Project-Level Support

# Install with automatic AGENTS.md creation
skilz install anthropics/skills/excel --agent universal --project

# Custom config file targeting
skilz install anthropics/skills/docx --agent universal --project --config CUSTOM.md

⚙️ Custom Config File Targeting

• Syntax: skilz install <skill> --project --config <filename>
• Flexible: Supports any filename (GEMINI.md, CUSTOM_SKILLS.md, etc.)
• Precise Control: Only updates specified file (overrides auto-detection)

---

🔄 Migration & Compatibility

✅ 100% Backwards Compatible

• All existing skill IDs continue to work unchanged
• No breaking changes to CLI interface
• Existing installations remain functional

📈 Recommended Migration

• NEW Format: Use owner/repo/skill for new installations
• Documentation: Update scripts to use NEW format for clarity
• Both Work: LEGACY format remains fully supported

---

📊 Quality Assurance

🧪 Testing Excellence

• 633 Tests Total: 100% passing success rate
• 25 New API Tests: Comprehensive format detection coverage
• E2E Validation: Real marketplace API testing
• Quality Checks: Linting, type checking, coverage all passing

🔍 Format Detection Testing

# Comprehensive test coverage for all formats
TestParseSkillIdNewFormat     # Tests owner/repo/skill parsing
TestParseSkillIdSlugFormat    # Tests owner__repo__skill parsing  
TestIsMarketplaceSkillIdFormats # Tests format recognition
TestGetSkillIdFormat          # Tests automatic detection

🌐 Live API Testing

Our E2E tests validate against the real skillzwave.ai marketplace:

• Endpoint Reachability: Confirms API is accessible
• Format Resolution: Tests all 3 formats resolve correctly
• Error Handling: Validates 404/400 responses
• Response Structure: Checks required JSON fields

---

🚀 Installation & Usage

📦 Install Skilz v1.7.0

pip install skilz==1.7.0

🎯 Try the NEW Format

# Install using the NEW intuitive format
skilz install anthropics/skills/algorithmic-art

# See format detection in action
skilz -v install anthropics/skills/theme-factory --agent claude

# Backwards compatibility - still works!
skilz install anthropics_skills/algorithmic-art

🧪 Run E2E Tests

# Run comprehensive REST marketplace E2E tests
./scripts/test_rest_marketplace_e2e.sh

# Run API integration tests  
./scripts/test_api_integration.sh

---

📚 Documentation

• 📖 User Manual - Complete usage guide
• 🎯 Comprehensive Guide - All agent-specific instructions
• 🚀 Gemini Migration - Gemini CLI support guide
• 🌐 Universal Agent Guide - Multi-agent setup

---

🙏 Acknowledgments

This release represents a major milestone in AI skills package management. The NEW install format makes Skilz more intuitive than ever, while our comprehensive E2E testing ensures reliability at scale.

Built by Spillwave — Leaders in agentic software development.

Browse skills at Skillzwave.ai — The largest agent and agent skills marketplace.

---

🔗 What's Next?

• Enhanced marketplace integration
• Additional agent support
• Performance optimizations
• Community-driven features

Happy skill installing! 🎉

v1.6.0: GitHub Copilot Native Support & OpenCode Path Fix

What's New in 1.6.0

GitHub Copilot Native Skill Support (SKILZ-54)

• Native Installation: Copilot now reads skills natively from .github/skills/
• Project-Level Only: Skills installed for Copilot go directly to .github/skills/
• No Config Injection: Copilot reads the directory natively, no configuration file modifications needed
• Auto-Detection: When you run skilz install <skill> --agent copilot, it automatically uses project-level installation with a helpful message:

  Info: GitHub Copilot only supports project-level installation (.github/skills/)
  

OpenCode Full Native Support

• Corrected Paths: OpenCode paths now use singular skill format matching OpenCode's actual configuration
  • Home directory: ~/.config/opencode/skill/
  • Project directory: .opencode/skill/
• Full Native Support: Changed native_skill_support from "home" to "all"

Enhanced E2E Tests

• Added comprehensive GitHub Copilot tests
• Tests auto project-level detection
• Verifies .github/skills/ installation path

Installation

pip install --upgrade skilz

Usage Examples

# Install for GitHub Copilot (auto project-level)
skilz install anthropics_skills/theme-factory --agent copilot

# Install for OpenCode (corrected paths)
skilz install anthropics_skills/theme-factory --agent opencode

# List installed skills
skilz list --agent copilot --project
skilz list --agent opencode

Full Changelog

See CHANGELOG.md for complete details.

1.5.0 Search, Visit, Aliases & Developer Experience

What's New

Release 1.5.0 brings major developer experience improvements including new commands for discovering and exploring skills, Unix-style aliases for faster workflows, and a comprehensive end-to-end test suite.

Installation

pip install skilz==1.5.0

📦 PyPI: https://pypi.org/project/skilz/1.5.0/

---

✨ New Features

🔍 skilz search Command

Search GitHub for available skills directly from the CLI:

# Basic search
skilz search excel

# Limit results
skilz search "data analysis" --limit 5
skilz search pdf -l 3

# JSON output for scripting
skilz search skill --json

🌐 skilz visit Command

Open skill pages in browser - defaults to Skilzwave marketplace, with GitHub fallback:

# Open marketplace page (default)
skilz visit Jamie-BitFlight/claude_skills/brainstorming-skill

# Force GitHub page
skilz visit -g anthropics/skills
skilz visit --git anthropics/skills/skills/xlsx

# Dry-run: output URL without opening browser
skilz visit --dry-run owner/repo/skill
skilz visit -g --dry-run anthropics/skills

⌨️ Unix-Style Command Aliases

Familiar shortcuts for power users:

Alias	Command
skilz ls	skilz list
skilz rm	skilz remove
skilz uninstall	skilz remove

🚀 -p Short Flag for --project

Added -p as short alias for --project on all commands:

skilz ls -p                         # List project skills
skilz install skill-id -p           # Install to project
skilz rm my-skill -p -y             # Remove project skill
skilz read skill-name -p            # Read project skill

🔗 URL Auto-Detection for Git Install

No more -g flag needed for Git URLs - skilz automatically detects them:

# These all work without -g flag now
skilz install https://github.com/owner/repo --skill my-skill
skilz install https://github.com/owner/repo.git --all
skilz install git@github.com:owner/repo.git --skill my-skill

⚡ Native Agent Optimization

Agents with native skill support (Claude Code, OpenCode, Codex) now skip config file modification for faster installs:

• Skip config sync: These agents read skills directories natively
• --force-config: Override when you need config file updates

# Normal install (skips config for native agents)
skilz install my-skill --agent claude

# Force config update
skilz install my-skill --agent claude --force-config

---

🧪 Testing

Unit Tests

• 587 tests covering all features
• All tests passing

End-to-End Test Suite

New comprehensive E2E test script (scripts/end_to_end.sh):

• 66+ tests across all major features
• Tests multiple agents (claude, opencode, codex, gemini, universal)
• Tests install sources (marketplace, git HTTPS, git SSH, filesystem)
• Tests all new commands and aliases
• Summary table showing all tested commands with PASS/FAIL status

# Run E2E tests
./scripts/end_to_end.sh

---

📋 Full Feature List

Feature	Description
skilz search	Search GitHub for skills
skilz visit	Open skill pages (marketplace/GitHub)
skilz ls	Alias for list
skilz rm	Alias for remove
skilz uninstall	Alias for remove
-p flag	Short for --project
--dry-run (visit)	Output URL without opening browser
-g (visit)	Force GitHub URL
URL auto-detect	Git URLs work without -g flag
--force-config	Force config sync for native agents

---

🔧 Bug Fixes

• Fixed URL auto-detection for skilz install (SKILZ-48)
• Fixed config sync behavior for native agents (SKILZ-49)
• Fixed E2E test visit command paths

---

Full Changelog: v1.4.0...v1.5.0

1.4.0 Multi-Skill Repository Support

What's New

🎯 Multi-Skill Repository Support

This release adds support for installing skills from git repositories containing multiple skills, like theone-training-skills with 38+ skills.

Installation

pip install skilz==1.4.0

📦 PyPI: https://pypi.org/project/skilz/1.4.0/

✨ New Features

• --skill flag: Install a specific skill by name without the interactive menu

  skilz install -g https://github.com/example/repo --skill my-skill --agent universal

• Interactive skill selection: When a repo has multiple skills, skilz now shows a menu to select which skill(s) to install

• Official marketplace.json support: Discovers skills from .claude-plugin/marketplace.json (per official Claude Code docs)

🐛 Bug Fixes

• Hidden directory filter: Fixed skill discovery to properly find skills in .claude/skills/ and .opencode/skills/ directories (previously these were incorrectly filtered out)

📋 Usage Examples

# Install from multi-skill repo (shows interactive menu)
skilz install -g https://github.com/The1Studio/theone-training-skills --agent universal

# Install specific skill by name (no menu)
skilz install -g https://github.com/The1Studio/theone-training-skills --skill theone-cocos-standards --agent universal

# Install all skills at once
skilz install -g https://github.com/example/repo --all --agent universal

🔍 Skill Discovery Priority

1. .claude-plugin/marketplace.json (official Claude Code location)
2. marketplace.json at repo root (fallback)
3. Recursive SKILL.md search (fallback)

---

Full Changelog: v1.3.0...v1.4.0

Version 1.3.0 - Install from Github Repo

Summary

• Implements direct skill installation from git repository URLs using -g/--git flag
• Supports multi-skill repositories with interactive selection menu
• Parses skill names from SKILL.md YAML frontmatter
• Adds --all flag to install all skills without prompting
• Global -y flag also skips prompts for git installs
• Version bumped to 1.3.0

Changes

New Files

• src/skilz/git_install.py - Core git installation logic (317 lines)
• tests/test_git_install.py - 30 comprehensive tests
• docs/plans/git-install-feature.md - Implementation plan

Modified Files

• src/skilz/cli.py - Added --all flag
• src/skilz/commands/install_cmd.py - Integrated git installation
• src/skilz/installer.py - Added skill_name parameter for git sources
• pyproject.toml & __init__.py - Version 1.3.0

Usage Examples

# Install from git URL (single skill)
skilz install -g https://github.com/user/my-skill

# Multi-skill repo shows selection menu
skilz install -g https://github.com/user/skill-collection
# Found 3 skills in repository:
#   [1] skill-one  (skills/one)
#   [2] skill-two  (skills/two)
#   [3] skill-three  (skills/three)
#   [A] Install all
#   [Q] Cancel
# Select skill(s) [1-3, A, Q]: 

# Install all skills without prompting
skilz install -g https://github.com/user/skill-collection --all

# Or use global -y flag
skilz install -g https://github.com/user/skill-collection -y

What's Changed

• docs: update documentation for v1.2.0 PyPI release by @RichardHightower in #22
• feat: Add git URL installation support with -g/--git flag by @RichardHightower in #23

Full Changelog: v1.2.0...v1.3.0

Install to PyPI: https://pypi.org/project/skilz/

Version 1.2.0 Added file copy support

Summary

• Add -f/--file flag to install skills from local filesystem paths
• Enables sharing skills between agents (Claude → Gemini, OpenCode → Claude, etc.)
• Implements install_local_skill() function in installer module
• Updates documentation with usage examples and XML config injection details

Changes

• src/skilz/commands/install_cmd.py: Wire up -f flag to new install function
• src/skilz/installer.py: Add install_local_skill() with copy-only mode
• docs/USER_MANUAL.md: Add local skills documentation section
• docs/COMPREHENSIVE_USER_GUIDE.md: Add examples for cross-agent skill sharing
• pyproject.toml + init.py: Version bump to 1.2.0

Version 1.1.0 Added support for 14 Code Agents

Summary

Phase 6 & 7 implementation bringing multi-agent CLI support and universal skills directory to Skilz CLI.

New Features

14 AI Agent Support

• With Native Skills: Claude Code, OpenAI Codex, OpenCode CLI, Universal
• Project-Level Only: Gemini CLI, GitHub Copilot, Cursor, Aider, Windsurf, Qwen CLI, Kimi CLI, Crush, Plandex, Zed AI

Universal Skills Directory

• Central storage at ~/.skilz/skills/ for sharing skills across agents
• User-level installation for agents with home directory support
• Project-level installation for sandboxed agents

Copy vs Symlink Modes

• --copy (default): Copies skill files directly, works with all agents including sandboxed tools
• --symlink: Creates symlinks to central storage, saves disk space but doesn't work with sandboxed agents

Config File Sync

• Automatic injection of skill references into agent config files (GEMINI.md, CLAUDE.md, QWEN.md, etc.)
• Follows agentskills.io standard for skill discovery
• XML-formatted skill elements with name, description, and location

skilz read Command

• Load skill content for agents without native skill loading
• Resolves symlinks correctly
• Outputs skill content with base directory for resource resolution

Documentation

• Comprehensive User Guide: Detailed documentation for all 14 agents
• CHANGELOG.md: Version history for v1.0.0, v1.0.1, v1.0.2
• Updated README with multi-agent support

Test Coverage

• 418 tests passing
• All lint checks pass

Files Changed

• src/skilz/agent_registry.py - 14 agent configurations
• src/skilz/config_sync.py - Config file synchronization
• src/skilz/commands/read_cmd.py - New read command
• src/skilz/installer.py - Copy/symlink mode support
• docs/COMPREHENSIVE_USER_GUIDE.md - New comprehensive guide
• CHANGELOG.md - Version history
• Updated README.md with 14-agent table

What's Changed

• feat: Integrate skilz CLI with Skillzwave Marketplace API by @RichardHightower in #1
• add deploymnet docs by @RichardHightower in #10
• feat: Phase 6 & 7 - Multi-Agent CLI Support + Universal Skills Directory by @RichardHightower in #11
• test: Add comprehensive tests for git_ops functions by @RichardHightower in #20

New Contributors

• @RichardHightower made their first contribution in #1

Full Changelog: v0.1.0-phase5...v1.1.0