easyskillz

<div align="center">

# 🧠 easyskillz

[![npm version](https://img.shields.io/npm/v/easyskillz?style=flat)](https://www.npmjs.com/package/easyskillz)
[![license](https://img.shields.io/github/license/DurdeuVlad/easyskillz?style=flat)](LICENSE)
[![last commit](https://img.shields.io/github/last-commit/DurdeuVlad/easyskillz?style=flat)](https://github.com/DurdeuVlad/easyskillz/commits/main)

**Simple, easy to use and brings order to AI agent chaos.**

*One folder. All your tools. Zero repetition.*

</div>

---

## The Problem

You use Claude Code. And Cursor. Maybe Windsurf. Each one has its own skills folder, its own config, its own path. You build a great `review-pr` skill — and now you maintain it in three places.

Your teammate clones the repo. Nothing works.

---

## The Solution

```
.easyskillz/skills/     ← one folder, committed to git
    review-pr/
        SKILL.md
    commit-msg/
        SKILL.md
```

Run `easyskillz sync` once. Every tool gets a symlink. Every teammate who clones runs `easyskillz sync` and everything is wired in seconds.

---

## Install

```bash
npm install -g easyskillz
```

---

## Three Commands

```bash
easyskillz sync               # detect tools, wire everything, set up .easyskillz/
easyskillz add <name>         # create a skill and wire it to all your tools instantly
easyskillz register <tool>    # add a tool and wire all existing skills to it
```

That's the whole API.

---

## What `sync` Looks Like

```
$ easyskillz sync

Scanning for AI tools...
  ✓ Claude Code      (.cursor/skills)
  ✓ Cursor           (.cursor/skills)
  ✗ Codex            (not found)

Reading config (.easyskillz/easyskillz.json)...
  Registered: cursor, cursor
  Strategy:   symlink

Testing symlink support...
  ✓ symlinks work

Scanning for unwired skills...
  review-pr    → Claude Code: ✗ missing
  review-pr    → Cursor:      ✗ missing
  commit-msg   → Claude Code: ✗ missing

Plan:
  [ wire ]      .cursor/skills/review-pr   →  .easyskillz/skills/review-pr