Oh My Agent Skills

A terminal-based skill manager for Claude AI coding assistants. Browse, search, and manage your AI-generated coding skills with an elegant TUI interface.

Features

• Terminal UI: Ratatui-powered interface with ASCII art loading screen
• Smart Search: Real-time filtering across skill names, descriptions, and owners
• Skill Management: Markdown parsing and metadata handling
• Performance: Async I/O, memory safe, zero unsafe code
• Rust: Modern patterns, error handling, and type safety

Screenshots

Main Dashboard

Search Functionality

Installation

Install directly from crates.io:

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

Controls

• ↑↓/jk: Navigate skills
• Enter: View details
• /: Search mode
• h: Help
• q: Quit

Development

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

Code Quality

This project uses:

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

Run these before committing:

cargo fmt --check    # Check formatting
cargo clippy         # Run linter

Release Process

The project includes automated scripts for releases:

For GitHub Releases (with binaries)

./release.sh 0.7.0 "Added new feature X"

For Crates.io Publishing

./publish.sh
# Follow prompts to bump version and publish

How It Works

Architecture:

1. main.rs loads skills asynchronously from .agents/ directory
2. Skills are parsed from markdown with YAML frontmatter
3. TUI provides navigation and search interface
4. Real-time filtering across skill names, descriptions, and owners

Components:

• main.rs: Async file I/O and app initialization
• skill.rs: Data models, parsing, and search logic
• tui.rs: Terminal UI rendering and event handling
• Skills: Markdown files with YAML frontmatter

Skill Format:

---
name: "my-skill"
description: "Does amazing things"
category: "Development"
triggers: "amazing", "skill"
---

# My Skill

Skill documentation here...

Contributing

1. Fork the repo
2. Create a feature branch
3. Make your changes
4. Test with cargo test
5. Submit a PR

Requirements

• Rust: 1.70+
• Terminal: Unicode support, 80×24 minimum size
• Platforms: Linux, macOS, Windows

Support

• Documentation: Ratatui • Tokio

Built with Rust. oh-my-agent-skills/README.md