Skip to content
/

oh-my-agent-skills

lukasdias-oh-my-agent-skills · Lukasdias/oh-my-agent-skills · ★ 1 · last commit 2026-01-25

Primitive shape
No installable primitives
00

Summary

oh-my-agent-skills — Summary

oh-my-agent-skills by Lukasdias is a Rust-based terminal UI (TUI) application for browsing, searching, filtering, and copying skill names from a .agents/ directory. It is a skill viewer/manager tool, not an AI orchestration framework. Built with Ratatui (Rust TUI library) and Tokio, it reads skill markdown files with YAML frontmatter (name, description, tags) from .agents/skills/ and displays them in a navigable terminal interface. Users can search by name/description/tags, select multiple skills, and copy selected skill names to clipboard. Published on crates.io as oh-my-agent-skills and installable via cargo install oh-my-agent-skills.

Differs from seeds: None of the 11 seeds address skill catalog browsing or TUI-based skill discovery. Like ssenart-oh-my-claude (status line viewer), this is a developer tooling layer rather than an agent behavioral framework. The closest seed is superpowers (skills-based framework whose skills would be browsed by this tool), but oh-my-agent-skills adds the UI surface layer for navigating skill collections rather than defining skills themselves.

01

Overview

oh-my-agent-skills — Overview

Origin

A Rust TUI application for skill navigation in Claude/Opencode coding assistant environments. Built with Ratatui + Tokio. Published on crates.io. 1 star, MIT license.

Purpose

The README describes it as: "A beautiful terminal-based skill viewer for Claude/Opencode coding assistants."

This tool solves a specific problem: when you have many skill files in .agents/skills/, finding and selecting the right skill names to use becomes cumbersome. oh-my-agent-skills provides a visual browser.

Features

  • List skills from .agents/ directory
  • View skill details and descriptions
  • Filter skills by name, description, or tags
  • Copy selected skill names to clipboard (the primary action)

Not an Orchestration Framework

Unlike most other "oh-my-*" projects, this is a developer utility, not an AI agent harness. It doesn't ship agents, hooks, or skills — it reads them from an external directory and provides a UI for selection.

"oh-my-*" Name Context

The "oh-my-" prefix here comes from the zsh/shell customization tradition (oh-my-zsh, oh-my-posh), signaling a terminal enhancement tool. Similar to ssenart-oh-my-claude.

02

Architecture

oh-my-agent-skills — Architecture

Distribution

  • Type: Rust binary (crates.io)
  • Version: unknown (not in README)
  • License: MIT
  • Stars: 1

Install

cargo install oh-my-agent-skills
oh-my-agent-skills  # Run the app

Directory Tree

oh-my-agent-skills/
├── src/
│   ├── main.rs            # Entry point
│   ├── models.rs          # Data models
│   ├── skill.rs           # Skill struct + parsing
│   ├── skill_loader.rs    # Loads skills from .agents/ directory
│   ├── ui.rs              # Main UI layout
│   ├── ui_components.rs   # Reusable UI components
│   └── ui/                # UI submodules
├── skills/                # Demo skill files (for development)
├── assets/
│   └── images/
│       ├── dashboard.png
│       └── search.png
├── Cargo.toml
├── Cargo.lock
├── Makefile
├── publish.sh
└── release.sh

Skill Format Read

Reads markdown files from .agents/ directory with YAML frontmatter:

---
name: skill-name
description: What this skill does
tags: [tag1, tag2]
---

# Skill content...

Required Runtime

  • Rust 1.70+
  • Unicode-capable terminal
  • Minimum 80×24 terminal size

Target Tools

  • Claude (coding assistant)
  • Opencode
  • Any tool that uses .agents/skills/ skill file convention
03

Components

oh-my-agent-skills — Components

Rust Source Modules

Module Purpose
main.rs Application entry point, Tokio async runtime
models.rs Data structures for skills and UI state
skill.rs Skill struct, YAML frontmatter parsing
skill_loader.rs Reads skill files from .agents/ directory
ui.rs Main TUI layout using Ratatui
ui_components.rs Reusable UI widgets (list, detail view, search bar)
ui/ UI submodule components

TUI Features

Feature Key Description
Navigate ↑↓ / jk Move through skill list
Select Space Select/deselect skills for collection
View Enter View skill details
Collect e Copy selected skill names to clipboard
Search / Enter search/filter mode
Category filter c Toggle category filter
Tag filter t Toggle tag filter
Clear filters r Reset all filters
UI demo u Show UI components demo
Help h Show help screen
Quit q Exit

No AI Components

  • No agents
  • No skills (shipped)
  • No hooks
  • No commands
  • No MCP servers

The .skills/ directory in the repo contains demo skill files for development/testing, not installed skills.

05

Prompts

oh-my-agent-skills — Prompt Excerpts

This tool contains no AI prompt files — it is a Rust TUI application for reading and displaying skill files. There are no agent prompts, behavioral instructions, or LLM-facing text in the source code.

Excerpt 1: Skill File Format (Demo Skill)

Technique: YAML frontmatter + markdown body (the format this tool reads, not ships)

The tool reads files matching this format from .agents/skills/:

---
name: example-skill
description: An example skill for demonstration
tags: [development, testing]
---

# Skill Content

Detailed skill instructions...

Note: The skills in the skills/ directory within the repository are sample data for development testing, not installed skills.

Excerpt 2: Cargo.toml (Technology Stack)

Technique: Rust + Ratatui TUI framework

# From Cargo.toml (inferred from README tech references)
[dependencies]
ratatui = "..."        # Terminal UI framework
tokio = "..."          # Async runtime

The app uses:

  • Ratatui for terminal UI rendering
  • Tokio for async file I/O
  • Clipboard integration for e key copy action

This is the only framework in the batch implemented in Rust.

09

Uniqueness

oh-my-agent-skills — Uniqueness

Differs from Seeds

None of the 11 seeds provide a TUI for skill browsing or catalog management. The problem this tool solves — navigating large collections of skill files to find and copy skill names — is entirely absent from the seed corpus. The only seed with skills is superpowers (14 skills), but superpowers has no browsing interface. This tool's value grows proportionally with the number of skills installed; frameworks like baekenough-oh-my-customcodex (123 skills) or Yeachan-Heo/oh-my-claudecode (28+ skills) are the target use case.

Positioning

  • A "utility belt tool" for the oh-my-* ecosystem, not a framework itself
  • Complements skill-heavy frameworks by solving the skill discovery problem
  • The only Rust binary in this batch (vs shell scripts, TypeScript, Python)
  • crates.io distribution is unique — all other frameworks use npm or shell

Observable Failure Modes

  1. Terminal size constraint: Minimum 80×24 — fails on very small terminals without useful error
  2. Unicode dependency: Requires Unicode-capable terminal for Nerd Font icons (if used)
  3. Static skill loading: Skills loaded at startup; adding a new skill requires restart
  4. Clipboard API: Clipboard copy depends on OS clipboard API (xclip/pbcopy) — may fail on headless environments
  5. No write capability: If a user wants to create a new skill from within the TUI, they cannot — read-only by design
04

Workflow

oh-my-agent-skills — Workflow

User Workflow

1. Run: oh-my-agent-skills
2. TUI opens showing all skills in .agents/ directory
3. Browse, search, filter skills
4. Press Space to select multiple skills
5. Press e to copy selected skill names to clipboard
6. Paste skill names into Claude/Opencode prompt

No AI Workflow

This tool has no AI agent workflow. It is purely a UI utility for skill discovery.

Search and Filter Workflow

  1. Press / to enter search mode
  2. Type to filter by name or description
  3. Press c to add category filter
  4. Press t to add tag filter
  5. Press r to reset all filters

Typical Use Case

When a developer wants to invoke a specific skill in their Claude/Opencode session but can't remember the exact skill name:

  1. Run oh-my-agent-skills in terminal
  2. Search for "test" or "review"
  3. Find the correct skill (e.g., code-review, tdd, verification)
  4. Press Space to select it
  5. Press e to copy to clipboard
  6. Paste into Claude prompt: Use the code-review skill to review my changes
06

Memory Context

oh-my-agent-skills — Memory & Context

State

  • Application state: In-memory only (TUI session)
  • Skill data: Read from .agents/ directory on startup
  • Filter/selection state: In-memory per session, not persisted

No Persistent State

The application does not write any files. It reads from .agents/skills/ and copies to clipboard — read-only operation.

No AI Memory

No vector database, no SQLite, no session state persistence. This is a stateless viewer.

07

Orchestration

oh-my-agent-skills — Orchestration

Multi-Agent Pattern

None — this is not an orchestration framework.

Execution Model

  • Interactive TUI: User-driven navigation in terminal
  • Single process: Rust binary, no subprocesses
  • Async file I/O: Tokio async runtime for loading skill files

What it Orchestrates

Nothing. It helps humans find and select skill names that they then use to invoke agents in other tools (Claude, Opencode).

08

Ui Cli Surface

oh-my-agent-skills — UI/CLI Surface

THE PRIMARY SURFACE IS THE TUI

This framework's entire value is the terminal UI. The "binary" IS the UI.

Binary

oh-my-agent-skills    # Launch TUI

TUI Layout

┌──────────────────────────────────────────┐
│ Skills (Dashboard)                        │
│ ┌─────────────────┐ ┌──────────────────┐ │
│ │ skill-list      │ │ skill-detail     │ │
│ │ • code-review   │ │ Name: code-review│ │
│ │ • tdd           │ │ Tags: [review]   │ │
│ │ ▶ verification  │ │ Desc: ...        │ │
│ └─────────────────┘ └──────────────────┘ │
│ [/] Search  [c] Category  [t] Tags  [q] Quit │
└──────────────────────────────────────────┘

Screenshots

  • assets/images/dashboard.png — main dashboard view
  • assets/images/search.png — search functionality

Install

cargo install oh-my-agent-skills

Build from Source

cargo build    # Build
cargo test     # Run tests
cargo run      # Run app
cargo check    # Quick compile check
cargo clippy   # Lint
cargo fmt      # Format

Release Process

  • release.sh — GitHub releases with binaries
  • publish.sh — crates.io publishing

Quality Tooling

  • rustfmt for code formatting (configured in rustfmt.toml)
  • clippy with pedantic rules (configured in Cargo.toml)

Related frameworks

same archetype · same primary tool · same memory type

claude-mem (thedotmack) ★ 78k

Background worker service captures every tool call as an observation, AI-compresses sessions, and auto-injects relevant past…

pi (badlogic/earendil) ★ 55k

A minimal, hackable, multi-provider terminal coding agent that adapts to your workflows via npm-installable TypeScript Extensions…

Agent Skills (Addy Osmani) ★ 46k

Encodes senior-engineer software development lifecycle as 23 auto-routed skills and 7 slash commands for any AI coding agent.

wshobson/agents Plugin Marketplace ★ 36k

Single Markdown source for 83 domain-specialized plugins that auto-generates idiomatic artifacts for five AI coding harnesses.

TabbyML/Tabby ★ 34k

Self-hosted AI coding assistant server (alternative to GitHub Copilot) with admin dashboard, RAG-based completions, and multi-IDE…

Compound Engineering ★ 17k

Make each unit of engineering work compound into easier future work via brainstorm→plan→execute→review→learn cycles.