skillshare v0.21.12 Release Notes

TL;DR

1. Instruction files for tools that get skills through universal. Codex, Gemini CLI, Pi and similar tools read skills from ~/.agents/skills but keep their own instruction file. Universal's AGENTS.md tab now lets you pick them from a dropdown and edit that file, and a shared AGENTS.md can be connected to them.
2. Removing a target no longer breaks another one in the same folder. Removing codex used to turn universal's synced skills into unmanaged copies.
3. A clearer upgrade error. A skill left owned by root by an old sudo upgrade now tells you the command that fixes it.

Instruction files for tools that get skills through universal

Many tools read skills from ~/.agents/skills, the folder of the universal target. If you sync skills there and don't add those tools as targets of their own, they still get the skills, but each reads its own instruction file: Codex reads ~/.codex/AGENTS.md, Gemini CLI reads ~/.gemini/GEMINI.md, Pi reads ~/.pi/agent/AGENTS.md. None of them reads ~/.agents/AGENTS.md. Until now those files had no page in the dashboard.

Open universal's AGENTS.md tab: a dropdown lists universal's own file and every such tool installed on this machine. Pick one to see and edit its file. The same tools appear in the shared AGENTS.md list under Extras, so one shared file can reach Codex and Gemini as well as Claude.

skillshare ui

A tool you later add as its own target leaves the dropdown and shows up as a normal target, keeping any shared file it was connected to. Cline and the Warp Agent CLI do read ~/.agents/AGENTS.md, so they are shown as sharing universal's file.

Removing a target keeps the skills another target still uses

codex and universal both write to ~/.agents/skills. Removing one of them used to turn the other's synced skills into local copies that skillshare no longer updated. Removal now leaves the folder alone while another target still uses it, and says so:

skillshare target remove codex --dry-run

Bug fixes

A skill left owned by root now says how to fix it. An upgrade run with sudo before v0.21.10 wrote the built-in skill as root, and every later upgrade failed with only permission denied. The error now includes the chown command that gives the skills folder back to you.

skillshare upgrade