Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<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
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.lockpins every installed skill by commit SHA and target path. Runapplyon any machine and get exactly the same state — like Terraform for agent skills.
- Broken installs self-heal:
doctordetects broken symlinks, missing sources, drift, and risk findings. Usedoctor --no-warningwhen you want an error-focused view.repairfixes recoverable drift automatically. No competitor offers this.
- Config is code:
skills.tomlis your single source of truth. Version it, share it with your team, andapplyit anywhere.
- Docker-native: Install skills directly into running containers with
--target docker:<container>. Usedocker mount-hintto configure bind mounts for live sync.
- Zero runtime: Single ~10 MB binary. No Node.js, no npm, no Python — just
eden-skillsandgit.
Quick Start
Prerequisite: Git
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/AI-Eden/eden-skills/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/AI-Eden/eden-skills/main/install.ps1 | iex<details> <!-- markdownlint-disable-line --> <summary>Alternative: install via Cargo or from source</summary> <!-- markdownlint-disable-line -->
cargo install eden-skills --lockedgit clone https://github.com/AI-Eden/eden-skills.git
cd eden-skills
cargo install --path crates/eden-skills-cli --locked --force</details>
Install your first skill:
eden-skills install vercel-labs/agent-skillsAuto-detects installed agents (Claude Code, Cursor, Codex, Windsurf, etc.) and links the skill to each. When multiple skills are found, an interactive selector appears.
Verify the installation is healthy:
eden-skills doctorIf anything is broken:
eden-skills repairSee It In Action
Interactive install, simulated damage, and self-healing recovery:
<div align="center"> <!-- markdownlint-disable-line --> <img src="images/demos/readme-demo.gif" alt="eden-skills terminal demo: interactively install a skill, simulate install damage, diagnose it with doctor, repair it, and verify the final healthy state" width="95%" /> <!-- markdownlint-disable-line --> </div>
Commands
| Command | Description |
|---|---|
install <source> | Install skills from GitHub, URL, or local path |
remove [skills...] | Remove skills (batch or interactive) |
list | List installed skills and their source origins |
apply | Reconcile all skills to the desired config state |
plan | Preview planned changes (read-only) |
doctor | Detect broken links, drift, and risk findings (--no-warning hides warnings) |
repair | Self-heal broken symlinks and drifted state |
update | Sync registry indexes to latest |
clean | Remove orphaned repo-cache entries and stale temp directories |
init | Initialize a new skills.toml config |
add / set | Add or update skill entries in config |
config export / import | Export or import config |
docker mount-hint | Show recommended bind mounts for a container |
See CLI Reference for full options, flags, and examples.
Supported Agents
40+ agents including Claude Code, Cursor, Codex, Windsurf, Gemini CLI, GitHub Copilot, Cline, Roo, Continue, and more. Docker containers (docker:<name>) and arbitrary paths (custom:<path>) are also supported.
See full agent list.
Documentation
- Quickstart: First Successful Run
- Config Lifecycle Management
- Registry and Install Workflow
- Docker Targets Guide
- Safety, Strict Mode, and Exit Codes
- Troubleshooting Playbook
- CLI Reference
- Agentic Engineering Workflow
Current Status
- Phase 1 (CLI foundation): complete
- Phase 2 (async reactor, Docker adapter, registry): complete
- Phase 2.5 (URL install, agent auto-detection, binary distribution): complete
- Phase 2.7 – 2.98 (lock file, TUI, output polish, interactive UX, cache clean, doctor/list polish): complete
- Phase 3 (crawler / taxonomy / curation): planned
eden-skills is under active development. Avoid production use where breaking changes are not tolerable.
Repository Layout
crates/eden-skills-core— domain logic (config, plan, verify, safety, reactor, adapter, registry)crates/eden-skills-cli— user-facing CLI binarycrates/eden-skills-indexer— Phase 3 placeholderspec/— normative behavior contracts (index)docs/— tutorials and guidesprompt/— agentic engineering kick files (workflow guide)
Built with Agentic Engineering
eden-skills was built using a three-model AI collaboration workflow:
- Scout (Gemini) — market research, competitive analysis, roadmap planning
- Architect (Claude) — behavior spec authoring, architecture decisions, large-scale refactoring
- Builder (GPT) — implementation from specs, tests, CI integration
The prompt/ directory contains the complete set of kick files — role-scoped prompts with identity constraints, pre-flight checks, and batch/handoff protocols. Each prompt enforces strict role boundaries: the Architect cannot write code; the Builder cannot modify specs.
The 62 spec files under spec/ are not a barrier to contribution — they are the Architect agent's work product. You do not need to write specs yourself. See the Agentic Workflow Guide to learn how to use AI agents to contribute to this project.
Contributing
Contributions welcome — issues, bug reports, docs, tests, and pull requests.
To understand the development workflow, start with the Agentic Workflow Guide. For normative behavior contracts, see spec/. Track progress in STATUS.yaml and EXECUTION_TRACKER.md. See the Roadmap for strategic milestones.