skillhelp
gndps/skillhelp
A utility that helps to list and describe all the skills in the current repo/dir without claude
Instalação
npx convez-ai gndps/skillhelp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
skillhelp
AI-powered skill browser for coding assistants. Generates concise summaries of skills and rules using OpenAI or Gemini — works with Claude, Codex, Cursor, Windsurf, Copilot, and Cline.
Install
curl -fsSL https://raw.githubusercontent.com/gndps/skillhelp/main/install.sh | bash
Then add the alias to your shell:
# bash
echo 'alias skh="$HOME/.skillhelp/skillhelp.sh"' >> ~/.bashrc && source ~/.bashrc
# or
echo 'alias skh="$HOME/.skillhelp/skillhelp.sh"' >> ~/.bash_profile && source ~/.bash_profile
# zsh
echo 'alias skh="$HOME/.skillhelp/skillhelp.sh"' >> ~/.zshrc && source ~/.zshrc
# fish
echo 'alias skh "$HOME/.skillhelp/skillhelp.sh"' >> ~/.config/fish/config.fish && source ~/.config/fish/config.fish
Set your API key (choose one):
OpenAI (recommended):
# Option 1: Set in .env file
echo 'OPENAI_API_KEY=your_key_here' > ~/.skillhelp/.env
# Option 2: Export as environment variable
export OPENAI_API_KEY=your_key_here
Get key at platform.openai.com/api-keys
Gemini (free alternative):
# Option 1: Set in .env file
echo 'GEMINI_API_KEY=your_key_here' > ~/.skillhelp/.env
# Option 2: Export as environment variable
export GEMINI_API_KEY=your_key_here
Get key at aistudio.google.com/apikey
Uninstall
curl -fsSL https://raw.githubusercontent.com/gndps/skillhelp/main/uninstall.sh | bash
Then remove the alias skh=... line from your shell config.
Usage
Run from any directory inside a project:
skh # One-liner descriptions (default)
skh list # Short descriptions (1-2 sentences)
skh --long # Detailed descriptions (3-5 sentences)
skh --help # Show help
All command aliases: list/l/-l/--list, long/--long, help/h/-h/--help
Supported Frameworks
| Framework | Path | Type |
|---|---|---|
| Claude | .claude/skills/ | Directory-based skills |
| Codex | .agents/skills/ | Directory-based skills |
| Cursor | .cursor/rules/ | File-based rules |
| Windsurf | .windsurf/rules/ | File-based rules |
| Windsurf Workflows | .windsurf/workflows/ | File-based workflows |
| Copilot | .github/instructions/ | File-based instructions |
| Cline | .cline/rules/ | File-based rules |
How It Works
- Walks up from your current directory looking for skill/rule paths
- Stops at the first directory level containing any definitions (monorepo-friendly)
- Generates one-liner, short, and medium descriptions via OpenAI or Gemini (all in parallel)
- Caches results in
~/.skill-help/with SHA-256 file hashes - Auto-invalidates — only regenerates when files actually change
- Deduplicates cache across git worktrees of the same repo
Default models: gpt-5.4 (OpenAI), gemini-3.5-flash (Gemini). Override with OPENAI_MODEL or GEMINI_MODEL in .env or as environment variables.