Easyskillz

easyskillz

**Status:** easyskillz solved cross-tool skill wiring by fully materializing skills into every host's native directory. As libraries grew, that approach started advertising more to the model than any single task needs. [Skillweft](https://github.com/DurdeuVlad/skillweft) is the successor: same author, a progressive-disclosure direction — skills stay hidden in a library until a router searches and opens exactly the one a task needs. easyskillz still works and is maintained for existing users, but new projects should start with Skillweft.

Easyskillz 0.5.1 keeps reusable agent skills honest across tools. You author one complete skill directory under `.easyskillz/skills/`; Easyskillz validates it, plans target changes, and materializes the complete native directory each host discovers.

Requires Node.js 22+.

What changed in 0.5

• Complete native directory delivery by link or atomic copy. Scripts, references, assets, and the real SKILL.md move together.
• Strict YAML and schema-2 config validation. Read-only commands never rewrite source bytes.
• Preview-first mutations with --dry-run, local ownership state, hashes, shared-consumer tracking, and safe cleanup.
• Explicit docs ownership. project sync does not scan or rewrite instruction files.
• One declared CLI grammar with stable JSON envelopes, usage exits, and help that cannot dispatch.

The executable is the CLI-only public API. Requiring internal JavaScript modules is unsupported.

Install

npm install --global easyskillz@0.5.1
easyskillz --version

Start

# inspect first
easyskillz project doctor
easyskillz skill validate
easyskillz project sync --dry-run

# apply the reviewed project plan
easyskillz project sync --confirm

Canonical sources are committed. Generated outputs and machine-local `.easyskillz/state.json` are not.

.easyskillz/
  easyskillz.json       committed desired state, schema 2
  skills//        committed canonical skill direct