Skip to content

1.5.0 Search, Visit, Aliases & Developer Experience

Choose a tag to compare

View all tags
@RichardHightower RichardHightower released this 03 Jan 00:40
· 28 commits to main since this release
v1.5.0
7bdc6ad
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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

Assets 2
Loading