mrkeyoor.com_
Thu 24 Sept 20:02 UTC
Dev Toolsevaluationupdated 26 Aug 2026

skills review

Skills is an English-language command-line manager for finding, installing, updating, using, and removing instruction packages across Claude Code, Codex, Cursor, OpenCode, and dozens of other coding agents. It solves the incompatible-folder problem by discovering `SKILL.md` files once and placing them where each supported agent expects them.

+383stars / 7d
Verdict

Our Skills run installed 126 packages in 5 seconds, then passed its 9-second build and 32-second test step, making it a credible cross-agent installer with one serious current caution. Use it for add, list, use, and carefully scoped updates across mixed agent setups. Until issue 2054 is fixed and released, avoid remove --all in repositories where a skills/ tree contains source material or documentation.

We ran it

Lab card: what happened when we ran skillsScreenshot of skills (skills.sh)
Install✓ · 5s126 packages · 94 MB
Build✓ · 9s
Tests✓ · 32sran, no count parsed
Repo118 files~27,133 lines of source · 1 MB · 3 CI workflows · tests dir

Answers from our run

Does skills build from source?

Dependencies installed in 5 seconds (126 packages), and the build succeeded in 9 seconds. We cloned commit 435076e into a clean Debian container with 3 CPUs and no project-specific setup.

Do skills's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use skills?

Users who assume downloaded instructions are safe because the CLI installed them: the README documents transport and size limits, not a trust guarantee for skill content.

What are the alternatives to skills?

Agent Skills specification, Anthropic Skills, Claude Code plugins. Our Skills run installed 126 packages in 5 seconds, then passed its 9-second build and 32-second test step, making it a credible cross-agent installer with one serious current caution.

Setup4/55-second install and clear npx commands across many agents
Docs5/5Sources, scopes, discovery, auth, compatibility, and telemetry covered
Community5/529,708 stars with a very large active issue and PR queue
Maturity3/5v1.5.23 tests pass, but removal and scope bugs remain open

Who it’s for

Developers who use several coding agents and want one skill installation command.
Teams that keep shared agent instructions in Git repositories.
Skill authors who need a minimal initializer plus cross-agent discovery rules.
Private-repository users already set up with Git credentials, GitHub CLI, SSH, or an explicit token.

Who it’s NOT for

Users who assume downloaded instructions are safe because the CLI installed them: the README documents transport and size limits, not a trust guarantee for skill content.
Anyone planning to run remove --all inside a repository with an unrelated skills/ directory on version 1.5.23: issue 2054 reproduces deletion of non-skill folders.
Teams that need consistent advanced behavior across agents: the compatibility table says forked context and hooks are supported by only some clients.
Organizations that prohibit source identifiers in telemetry without configuration: non-GitHub remote sources may send source and skill identifiers unless telemetry is disabled.
Administrators who need install and activation managed separately: issue 2010 describes that model as a requested feature rather than current behavior.

Setup reality

Our pnpm sandbox installed 126 packages in 5 seconds and used 94 MB. The build succeeded in 9 seconds, and tests succeeded in 32 seconds. The 118-file checkout contained about 27,133 source lines and was 1 MB before dependencies.

Normal use needs Node plus network or local access to a skill source. Private repositories depend on existing Git, GitHub CLI, SSH, credential-helper, or token configuration. Targets must also be writable in each agent's project or global skill directory.

The repository has 3 CI workflows and a tests directory, but no Dockerfile. Symlinks are the recommended installation method; --copy creates independent copies. Anonymous telemetry is enabled unless DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 is set.

One CLI targets 77 coding-agent integrations

Skills turns repositories containing SKILL.md files into installable instruction packages. The README names OpenCode, Claude Code, Codex, and Cursor, then says 73 more agents are supported. Each integration maps project and global skill directories, while the CLI handles source discovery and prompts for targets. This is useful for developers whose instructions otherwise get copied into several hidden folders and drift apart.

The core commands cover adding, temporary use, listing, searching, updating, removing, and initializing skills. skills use can print a generated prompt or start a supported agent with that prompt. Project installation is the default; --global writes to the user's agent locations. Interactive installs recommend a canonical copy with symlinks, while --copy produces independent copies that can diverge after manual edits.

Git, archives, and local paths are valid sources

A source can be GitHub shorthand, a full GitHub or GitLab URL, another Git URL, a local directory, a direct SKILL.md, or an archive download. Archive defaults cap downloads at 10 MiB, extracted content at 25 MiB, and file count at 1,000. Those limits reduce accidental expansion, though the README permits overrides when the user trusts the source.

Private GitHub installs first try normal Git credentials, then authenticated GitHub CLI cloning, then SSH. The program does not call gh auth token or copy that stored credential into its Node process. API lookups can use an explicit GITHUB_TOKEN or GH_TOKEN; otherwise they try anonymous access and gh api before falling back to a clone. That is a thoughtful authentication chain for private skill repositories.

What happened when we ran it

Our clean Node 22 sandbox installed 126 pnpm packages in 5 seconds and occupied 94 MB. The build succeeded in 9 seconds. Tests also succeeded, finishing in 32 seconds. commit 435076e therefore passed every install, build, and test step that our harness invoked, with no failure log to qualify.

The checkout itself was small at 1 MB, with 118 files and about 27,133 source lines. It contained 3 CI workflow files and a tests directory, but no Dockerfile. Those measurements fit a developer CLI that runs through npx; a service container would add little. They do not inspect the safety or correctness of any third-party skill installed through the tool.

Skill discovery is broad and sometimes agent-specific

Skills searches the repository root, several conventional skill containers, agent-owned paths, and Claude plugin manifests. The normal catalog walk goes 3 levels deep, with a full-depth option for less conventional layouts. If standard locations produce nothing, the CLI performs a recursive search. Valid frontmatter requires a name and description, while internal entries can be hidden unless a dedicated environment setting enables them.

Basic skill files travel well, but richer features do not. The compatibility table says allowed-tools works across most named clients. Forked context is shown only for Claude Code, and hooks work in a smaller set including Claude Code, Cline, and Kiro CLI. A shared installer cannot make an agent implement semantics it lacks, so authors still need to state which advanced fields their skill relies on.

Version 1.5.23 has a dangerous removal report

Issue 2054 reproduces a removal bug against version 1.5.23 and source commit 435076e. The report says remove counted directories that were not installed skills. In its isolated fixture, remove --all deleted skills/docs/ and skills/templates/ from a source repository because an agent integration also used skills/ as an installation path. Pull request 2055 proposes requiring SKILL.md during that scan.

That report should change current operating advice. Avoid broad removal in a repository, inspect the exact target, and keep source work under version control so deletion is recoverable. Release 1.5.23 already fixed another remove --all case involving named skills, but its changelog predates issue 2054. A separate issue reports that project updates can create duplicate skill copies on a clean CI home directory.

Telemetry and activation need deliberate settings

The CLI collects anonymous usage data by default. For public GitHub repositories, it sends repository and skill identifiers only after GitHub confirms public visibility. Other remote-source types may include those identifiers because visibility cannot be checked the same way. DISABLE_TELEMETRY=1 and DO_NOT_TRACK=1 disable collection, which regulated or private environments should set before the first command.

Installation and activation are still coupled enough that users have requested separate enable and disable state. Issue 2010 proposes global defaults with repository overrides while keeping installed files updateable. Until such management exists, exposing a skill generally follows where the CLI places or links it and how the agent scans that path. Skills is already valuable for mixed-agent teams, but filesystem scope remains part of its user interface.

August maintenance is fast and noisy

GitHub recorded 29,708 stars, a push on August 18, 2026, and release v1.5.23 on the same date. The release added a select-all control, another agent integration, private-authentication work, and fixes for pinned references and internal skills. GitHub also reported 1,127 combined issues and pull requests, a huge queue that includes directory-listing requests alongside code defects.

The passing 46 seconds of build and test work supports trying the CLI, while the removal report argues for narrow commands and recoverable repositories. Use explicit sources, pin references where stability matters, disable telemetry if identifiers are sensitive, and inspect changes after updates. That discipline leaves Skills doing its best job: translating one instruction package into the folder conventions of many agents.

Alternatives

ProjectWhat it isPick it when
Agent Skills specificationThe shared format and client guidance without a multi-agent package manager.pick this instead when you are implementing skill support inside an agent or validating the format itself.
Anthropic Skills gh↗A public catalog of authored skills rather than an installer for many agents.pick this instead when you want reviewed skill content and will use your agent's native installation path.
Claude Code pluginsClaude Code's native package format for skills, commands, hooks, and related assets.pick this instead when Claude Code is your only target and plugin-specific features matter.

What people are saying

  1. [github-trending] ConardLi/garden-skills
  2. [github-trending] xingkongliang/skills-manager
  3. [github-trending] ibelick/ui-skills
  4. [github-trending] VoltAgent/awesome-agent-skills
  5. [github-trending] google-labs-code/stitch-skills
  6. [github-trending] ComposioHQ/awesome-claude-skills

Sources

  1. Skills README
  2. Skills v1.5.23 release
  3. Removal scans non-skill directories issue
  4. Project update duplicate-copy issue
  5. Install and activation scope proposal

More dev tools reviews

zeron · cs2-dumper · hackingtool · react-native-continued-task · selfdb · DLSS5oneclick · the whole board →