eden-skills

<div align="center"> <!-- markdownlint-disable-line -->
  <img src="images/banner-export.png" alt="Eden-Skills — Deterministic & Blazing-Fast Skills Manager for AI Agents" width="100%" /> <!-- markdownlint-disable-line -->
</div>

# eden-skills

[![CI](https://github.com/AI-Eden/eden-skills/actions/workflows/ci.yml/badge.svg)](https://github.com/AI-Eden/eden-skills/actions/workflows/ci.yml)
[![crates.io](https://img.shields.io/crates/v/eden-skills)](https://crates.io/crates/eden-skills)
[![downloads](https://img.shields.io/crates/d/eden-skills)](https://crates.io/crates/eden-skills)

Deterministic, self-healing skills manager for AI agents. Single binary. Zero runtime dependencies.

*Built by a [three-model AI engineering team](#built-with-agentic-engineering) — 38K lines of Rust, 476 tests, 57 behavior specs.*

## Why eden-skills

- **Installs are deterministic:** `skills.lock` pins every installed skill by commit SHA and target path. Run `apply` on any machine and get exactly the same state — like Terraform for agent skills.

- **Broken installs self-heal:** `doctor` detects broken symlinks, missing sources, drift, and risk findings. Use `doctor --no-warning` when you want an error-focused view. `repair` fixes recoverable drift automatically. No competitor offers this.

- **Config is code:** `skills.toml` is your single source of truth. Version it, share it with your team, and `apply` it anywhere.

- **Docker-native:** Install skills directly into running containers with `--target docker:<container>`. Use `docker mount-hint` to configure bind mounts for live sync.

- **Zero runtime:** Single ~10 MB binary. No Node.js, no npm, no Python — just `eden-skills` and `git`.

## Quick Start

**Prerequisite:** Git

**Linux / macOS:**

```bash
curl -fsSL https://raw.githubusercontent.com/AI-Eden/eden-skills/main/install.sh | bash
```

**Windows (PowerShell):**

```powershell
irm https://raw.githubusercontent.com/AI-Eden/eden-skills/main/install.ps1 | iex
```

<details> <!--