Skip to content

About

View and manage your AI agent skills in a beautiful Terminal UI. Available as a GitHub CLI extension.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

gh-skillview

gh-skillview helps you find, preview, install, update, and safely remove agent skills. Use its full-screen terminal app or scriptable CLI.

Website · Documentation

CI Release License: MIT

SkillView 1.1.1 restores simpler terminal browsing and updates the supported .NET 10 dependencies. See the release notes for highlights and upgrade instructions. Check skillview --version and skillview --help for your installed version.

Install

You need GitHub CLI 2.102.0 or newer. Sign in with gh auth login to search and install skills.

GitHub CLI extension (recommended)

gh extension install harder/gh-skillview
gh skillview

Update later with gh extension upgrade harder/gh-skillview.

Homebrew (macOS Apple Silicon and Linux x64)

brew install harder/tap/skillview
skillview

This installs the standalone app and its gh dependency. Run brew upgrade harder/tap/skillview for future releases.

Standalone app

Download the binary for your platform from the latest release:

Platform Asset
Windows x64 skillview-windows-amd64.exe
Windows ARM64 skillview-windows-arm64.exe
Linux x64 skillview-linux-amd64
macOS ARM64 skillview-darwin-arm64

Put the binary on your PATH. On macOS and Linux, make it executable first (chmod +x <downloaded-file>). Release binaries are self-contained; no separate .NET runtime is needed.

Use SkillView

Start with gh skillview (extension) or skillview (standalone):

  1. Discover (1): search, preview a skill and press i to review its placement before installing.
  2. Installed (2): inspect an exact physical copy and every recorded consumer. Press C to check updates explicitly; u prepares that copy's saved update review.
  3. Issues (3): inspect local problems and review suggestions. Expand a family, select an exact child and compare it. A suggestion never applies a change by itself.
  4. Review the exact target, source changes and affected consumers. Source acknowledgement and permission to retain the original are separate approvals. Undo and recovery have their own fresh reviews.

Local browsing does not require a remote authentication check. F5 / Locations chooses known scan roots, workspaces and profiles; incomplete coverage stays unknown. F4 / History inspects saved replacements and eligible retirement actions. Press ? / F1 for the current screen's keys, F2 for technical evidence, and Ctrl+Q to quit.

Read the usage guide for keyboard controls and configuration, the supported actions matrix for what each selection can do, saved updates for review/apply/Undo, and quarantine and undo for standalone relocation. Unmatched gh registry records provide inspection guidance; they are not automatic cleanup targets.

For the full range of discovery and repair options, see Find, diagnose and fix skills: add workspaces and profiles, inspect coverage and owner conflicts, check package references, compare copies, review updates or recorded restoration, and use purpose-specific local-source, unpin, removal and Move aside workflows. Guided review handles eligible items one at a time; retained-operation History supports fresh Undo/recovery and explicit retirement.

Installed view with clear column headings, physical copies and contextual actions

The current source build with the simpler browse layout and warm terminal palette, using isolated sample skills. See media provenance; review screens do not imply completed repairs.

Watch the Installed walkthrough

Browse installed skills, check a package and return to the list

More walkthroughs: GIFs, videos and step-by-step descriptions.

The CLI offers the same core workflows:

skillview doctor
skillview search terraform
skillview preview OWNER/REPO SKILL
skillview install OWNER/REPO SKILL
skillview list --json
skillview update --dry-run
skillview cleanup

Use gh skillview in place of skillview when installed as an extension. Run skillview --help for commands and options. For the full keyboard reference, CLI flags, exit codes, configuration, and troubleshooting, see the usage guide.

Contributing

See CONTRIBUTING.md for development setup, architecture, tests, and contribution guidance. For native CI coverage, queued proof jobs and failure diagnosis, see the CI guide.

Built with

Terminal.Gui, GitHub CLI, and .NET 10.

License

MIT. See LICENSE.

About

View and manage your AI agent skills in a beautiful Terminal UI. Available as a GitHub CLI extension.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages