lsp-explore✓ Pass

First contact with unfamiliar code via strict LSP symbols, definition, and hover before reading files.

0
★ stars
0
↓ downloads
2
◉ views

// Install Skill

Install Skill

Skills are third-party code from public GitHub repositories. SkillHub scans for known malicious patterns but cannot guarantee safety. Review the source code before installing.

Install globally (user-level):

npx skillhub install rhinos0608/Pi-SmartRead/lsp-explore

Install in current project:

npx skillhub install rhinos0608/Pi-SmartRead/lsp-explore --project

Use this for Hermes or another runtime. The skill is written to <directory>/<skill-name>/.

npx skillhub install rhinos0608/Pi-SmartRead/lsp-explore --target-dir /path/to/skills

Suggested path: ~/.claude/skills/lsp-explore/

SKILL.md Content

---
name: lsp-explore
description: First contact with unfamiliar code via strict LSP symbols, definition, and hover before reading files.
---

# lsp-explore

Resolve what a symbol is before reading around it.

## WHEN

- You need a definition, type/docs, or workspace symbol candidates.
- You want semantic navigation before broader grep/read exploration.

## WHEN NOT

- You already know the file and lines. Use `read`.
- You need all usages. Use `lsp-impact`.
- You only need a file outline. Use `lsp-local-symbols`.

## Workflow

1. `LSP { operation: "workspaceSymbols", query }` to locate candidates.
2. `LSP { operation: "goToDefinition", path, position }` for the jump target.
3. `LSP { operation: "hover", path, position }` for type/docs.
4. `read` the exact target when source text is needed.

## Guardrails

- The model-facing tool name is `LSP`.
- `position` is 0-based in the returned server's negotiated encoding.
- Check the strict envelope `status`; `unavailable` is not a guessed fallback.
- TypeScript sessions are semantic-only: cold starts may be slow or time
  out rather than return fast partial answers. `meta.readiness` is advisory
  progress evidence, never a completeness gate.
- Read-only. No edit/write/patch calls.

## EXAMPLE

```json
{"operation":"goToDefinition","path":"src/auth.ts","position":{"line":41,"character":9}}
```

## Budgets

Use 2-4 LSP calls, then read only the exact source you need.

License

Declared license: MIT

MIT License

Copyright (c) 2026 rhinos0608

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

View the license in the source repository — the version published there is authoritative.