oh-my-skills

한국어 README

Local GUI and CLI for managing SKILL.md folders across Codex, Claude, and generic Agent Skills.

oh-my-skills answers a very simple question:

“What skills are installed on this machine, and which ones can I safely edit?”

It scans local skill directories, shows duplicates, lets you inspect and edit user-owned skills, and keeps system/plugin skills read-only.

Demo

Watch the full demo video: docs/assets/oh-my-skills-demo.mp4

Features

• Local browser GUI: search, filter, inspect, edit, create, and archive skills.
• English/Korean GUI toggle.
• Light/dark GUI theme toggle with the same mono README-style interface.
• CLI inventory: export Markdown or JSON reports.
• Duplicate detection across Codex, Claude, Agents, and plugin cache skills.
• Safe editing: backs up SKILL.md before saving.
• Safe cleanup: archives user skills instead of permanently deleting them.
• Local-first: runs on 127.0.0.1; no account, cloud sync, database, or telemetry.
• Dependency-light: Python standard library only.

What It Scans

By default, oh-my-skills scans:

Quick Start

Run From Source

git clone https://github.com/AIjunja/oh-my-skills.git
cd oh-my-skills
python -m skill_ledger gui

Open the printed local URL. By default:

http://127.0.0.1:8765/

If port 8765 is busy, oh-my-skills automatically tries the next available port.

Install From GitHub

After this repository is public, users can install it directly:

pipx install git+https://github.com/AIjunja/oh-my-skills.git
oh-my-skills gui

The legacy skill-ledger command is kept as a compatibility alias.

Without pipx:

python -m pip install git+https://github.com/AIjunja/oh-my-skills.git
oh-my-skills gui

Editable Development Install

git clone https://github.com/AIjunja/oh-my-skills.git
cd oh-my-skills
python -m pip install -e .
oh-my-skills gui

CLI Usage

Generate a Markdown inventory:

python -m skill_ledger scan --format markdown --out inventory/skills.md

Generate JSON:

python -m skill_ledger scan --format json --out inventory/skills.json

Print duplicate and metadata warnings:

python -m skill_ledger doctor

Scan specific folders:

python -m skill_ledger scan \
  --root ~/.codex/skills \
  --root ~/.claude/skills \
  --format markdown

GUI Usage

python -m skill_ledger gui

The GUI lets users:

• browse all discovered skills;
• search by name, description, path, or source;