Ion

A skill manager for AI agents

◆

A command-line tool for installing, validating, and organizing reusable skills across AI coding agents — Claude, Cursor, Windsurf, and others.

$ curl -fsSL https://raw.githubusercontent.com/Roger-luo/Ion/main/install.sh | sh

Installation

Add skills from GitHub repositories, Git URLs, or HTTP endpoints with a single command. Declarative manifests and lockfiles ensure reproducibility across environments.

Validation

Automated quality checks for security issues, structural problems, and adherence to the skill format specification before skills reach your agents.

Discovery

Search for skills across GitHub, the skills.sh registry, and custom sources. Browse interactively in the terminal or query from the command line.

Multi-agent

Target Claude, Cursor, Windsurf, and other AI tools simultaneously from a single project configuration file.

Or let your agent do it

Paste these prompts into Claude Code, Cursor, or any agent — in order or as needed.

1
Install Ion

Have your agent run the official installer and verify it worked.

Install Ion on my machine by running the official installer: curl -fsSL https://raw.githubusercontent.com/Roger-luo/Ion/main/install.sh | sh — then verify it's working with ion self info.

2
Set up a project

Initialize Ion, detect the language stack, and scaffold an AGENTS.md.

Set up Ion in this project: run ion init to create Ion.toml, detect whether I'm using Rust, Python, or Julia and initialize an AGENTS.md with the right builtin template, then commit the result.

3
Find & add a skill

Search the registry for skills relevant to your workflow and install one.

Use ion search to find skills relevant to this project's main workflow, show me the options, then add the best match with ion add.

4
Write a local skill

Scaffold and author a skill tailored to this project's workflow.

Create a new local skill for this project's main recurring workflow: use ion new to scaffold it, then write a SKILL.md with clear instructions for when to use it and what steps to follow.