Iris is a plugin for herdr. Iris shows a searchable list of your AI agent skills. Iris types the skill you select into your pane.
The name comes from Iris, the Greek messenger goddess. Iris carries a skill's name from the list into your pane, the same way.
Press a key. Iris opens a list of skills. The list shows the skills for the agent in your pane. Select a skill. Iris types the skill into that pane.
- Scoped to your agent, or grouped by agent if herdr can't detect one
- Reads real skill files: Claude Code's
SKILL.md, Cursor's.cursor/rules - Search by name or author, literal text, not fuzzy (
/) - Real author, not a guess: the skill-installer's own record, or "you"
- Full description, word-wrapped, in a preview pane (
?) - Edit a skill in your own editor (
o), reload the list after (Ctrl-R) - Types the skill into your pane, doesn't run it for you (
Enter) - Hides a skill you've turned off (
skillOverrides) - Shows a clear "degraded" message in the header if detection breaks, instead of quietly acting unscoped
Full detail on each of these: FEATURES.md.
- herdr, version 0.7.0 or later.
- fzf and jq.
herdr plugin installinstalls both for you, through Homebrew, apt, dnf, or pacman (seeinstall-deps.sh). If none of these tools are on your machine, install stops and shows you the one command to run by hand. Without fzf, Iris still shows the list, as plain text. Without fzf, search, the preview, edit, reload, and type-to-pane do not work.
herdr plugin install a-curious-coder/herdr-iris
git clone https://github.com/a-curious-coder/herdr-iris.git
herdr plugin link ./herdr-iris
Add a key binding in ~/.config/herdr/config.toml:
[[keys.command]]
key = "prefix+shift+k"
type = "plugin_action"
command = "cmc.iris.open"
description = "skills cheatsheet (Iris)"| Key | Action |
|---|---|
/ |
Start a search, by name or author (literal text, not fuzzy) |
? |
Show or hide the description preview |
o |
Open the skill's file in your editor. Close the editor to return to the list |
Ctrl-R |
Rebuild the list from disk |
↑/↓, Ctrl-N/Ctrl-P |
Move the selection up or down |
Enter |
Type the selected skill into the pane you opened Iris from |
q, Esc |
Close Iris. Type nothing |
| Agent | Skill source | Status |
|---|---|---|
| Claude Code | SKILL.md frontmatter: personal, project, and enabled plugins |
Full support |
| Cursor | .cursor/rules/*.mdc frontmatter |
Best effort |
| Every other agent herdr recognizes (codex, gemini, opencode, copilot, cline, devin, droid, amp, grok, kimi, kiro, kilo, qoder, qodercli, pi, hermes) | None found | No confirmed skill file format yet |
To add a new agent: write a list_<agent> function in build-rows.sh. Add a matching case to collect_for.
Iris uses the MIT license.