🐷 snoutcheck

A lazygit-style TUI for exploring and exporting Claude Code skills. Scans global (~/.claude/skills/) and project-level (.claude/skills/) SKILL.md files across your codebase.

Install

npm install -g snoutcheck

Usage

snoutcheck          Launch interactive skill explorer
snoutcheck -e       Export all skills as JSON to stdout
snoutcheck -ec      Export all skills as JSON to clipboard (pbcopy)
snoutcheck -h       Show this help

Interactive mode

Two-panel TUI with a navigable directory tree on the left and a contextual preview pane on the right. The layout adapts live when you resize your terminal.

┌─────────────────────────────────────────────────────────┐
│ 🐷 Snoutcheck                                          │
│ 22 skills (134K) — 13 global, 9 project                │
├───────────────────┬─────────────────────────────────────┤
│ 🐽 Tree           │ Preview Pane                        │
│                   │                                     │
│ ▸ 🐽 .claude (13) │ [dir hovered]  → skill list         │
│ ▸ 🐽 Code (9)     │ [file hovered] → full skill detail  │
├───────────────────┴─────────────────────────────────────┤
│ h/l collapse/expand · j/k navigate · q quit            │
└─────────────────────────────────────────────────────────┘

Keybindings

| Key | Context | Action | |-----|---------|--------| | j / k | Any | Navigate up/down through visible items | | l | Collapsed dir | Expand directory | | h | Expanded dir | Collapse directory | | h | File / collapsed dir | Jump to parent directory | | space | Dir | Toggle expand/collapse | | enter | Dir | Toggle expand/collapse | | enter | File | Open in $EDITOR (defaults to nvim) | | e | Any | Expand all directories | | c | Any | Collapse all directories | | q | Any | Quit |

Preview pane

• Directory hovered: Lists all skills recursively under that subtree with scope badges, names, and description snippets.
• File hovered: Full skill detail — name, scope badge, project, description, stats (size, lines, sections, tools), and heading tree.

Responsive layout

The TUI listens for terminal resize events and re-renders automatically. Both panes maintain a 1/3 (tree) to 2/3 (preview) ratio at any terminal width, and the content area grows/shrinks with terminal height.

Export format

snoutcheck -e outputs a JSON array of skill objects:

[
  {
    "name": "my-skill",
    "description": "What this skill does",
    "scope": "global",
    "path": "~/.claude/skills/my-skill/SKILL.md",
    "headings": ["Section One", "Section Two"]
  }
]

Optional fields (displayName, project, tools) are included only when present.

Development

npm run dev    # watch mode with tsx
npm run build  # compile with tsc