Skip to content

v0.6.0

Choose a tag to compare

View all tags
@xFurti xFurti released this 13 Jul 17:09
· 56 commits to main since this release
v0.6.0
ed6ad16

Project-local skills, explicit global installs, and Pi support

skillctl now treats a project as the default home for its skills. Version 0.6.0 makes local skill sets reproducible and shareable with the repository, while keeping personal skills available through an explicit global mode.

Added

  • Project-local skill store: skillctl init creates .skillctl/skills/. Local commands find the nearest parent project containing agent-skills.json, so they work from subdirectories too.
  • Vendored local skills: skillctl add ./path/to/skill copies the skill into .skillctl/skills/<name> and records a portable file:./.skillctl/skills/<name> entry. Commit this directory to share private or unpublished skills with the team.
  • Explicit global operations: use -g for personal skills outside a project:
    • skillctl add -g <source>
    • skillctl list -g
    • skillctl doctor -g
    • skillctl remove -g <name>
  • Simplified import: skillctl import discovers skills in supported agent directories, copies them into the project store, deduplicates identical content, and stops safely on conflicting same-name skills. --dry-run, --select, --interactive, and --sources are supported.
  • Pi adapter: supports .pi/skills for project skills and ~/.pi/agent/skills for global skills.

Changed

  • Project-local storage is now the default; the global ~/.skillctl/skills store is reserved for explicit -g operations.
  • Local operations outside an initialized project fail with a clear next step: initialize a project or install globally.
  • Imported skills are reproducible project files instead of depending on an agent directory or another developer's home directory.
  • README, changelog, and contributor guidance now document the local/global workflow.

Compatibility and safety

  • Existing immutable GitHub, npm, and skills.sh resolution metadata and integrity checks remain in place.
  • Legacy global lock paths remain readable.
  • Frozen installs resolve project-local stores correctly.
  • Sync and removal retain managed-target safety protections.

Verification

The release passed build, lint, tests, coverage, production audit, skill validation, packaging checks, and CI on Ubuntu, macOS, and Windows with Node.js 22.13 and 24.

Install

npm install --global @skillctl/cli@0.6.0
skillctl --version
Assets 2
Loading