skill-cli 0.1.0

Initial production release of the Swift-native skill CLI.

Highlights

Provides the singular skill executable, plus the Swift-prefixed swift-skill executable.
Bundles a skill-cli companion skill that teaches agents to use the skill CLI for skill lifecycle management.
Installs and restores pinned project or user skills with skill install from skills.resolved state.
Separates resolved state, source checkout cache, canonical installed copies, and agent projections.
Uses .agents/skills as the canonical universal skill surface for Codex, Cursor, Gemini CLI, and OpenCode, with native projections for Claude Code.
Uses skill add <source> to add or update selected-scope skill dependencies and refresh resolved state.
Supports SwiftPM-inspired source requirements such as --branch, --revision, --exact, and --from.
Checks out fetched remote branch heads for branch requirements so stale local cache branches do not mask upstream changes.
skill list reports managed skills by default; skill list --all scans unmanaged filesystem installs.
skill list --skill <name> filters both managed and --all installed lists.
Keeps managed watch state in .agent/skills-state.json and keeps watch head refresh internal; no public sync command is exposed.
Keeps unsupported discovery routes out of the production CLI. Future hosted source-index discovery is tracked as a proposal without reserving a command name.

python3 /Users/xudongxu/.agents/skills/skill-creator/scripts/validate_skill_package.py skills/skill-cli
skill list . --path skills/skill-cli --json
swift-format lint --configuration .swift-format --recursive Package.swift Sources Tests
swift test (89 tests)
swift build -c release --product skill
Release CLI smoke for --version, command help, and unknown command boundary.
brew audit --formula --strict --online skill-cli/tap/skill-cli
brew test skill-cli/tap/skill-cli