plugins/dev-tools/skills-pi/smart-explore/SKILL.md
Token-efficient code navigation using local Pi tools. Use when you need a fast outline of files, symbols, imports, or call sites without loading whole files.
npx skillsauth add alexei-led/claude-code-config smart-exploreInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use cheap local structure before reading large files. The goal is orientation, not pageantry.
fd to find candidate files.rg for symbols, imports, routes, handlers, config keys, and tests.python -m ast, ruff, pyrightgo list, go test, go doc, gofmt -w only when editingtsc --noEmit, bun test, `rg 'export |function |class 'fd '\.(go|py|ts|tsx|js|jsx)$'
rg -n 'class |def |func |export |interface |type '
rg -n 'TODO|FIXME|panic\(|throw new|console\.log'
## Smart Explore
### Files
- `path` — why it matters
### Symbols
- `path:line` — symbol and role
### Edges
- caller -> callee or import relationship
### Read Next
1. `path:line-range` — reason
tools
Idiomatic shell development for POSIX sh, Bash, Zsh, Fish, hooks, CI shell steps, and scriptable CLI glue. Use when writing or changing `.sh`, `.bash`, `.zsh`, `.fish`, `.bats`, shell functions, shell pipelines, or command-runner recipes. Emphasizes portability, quoting, safe filesystem/process handling, non-TUI CLI tools, ShellCheck, shfmt, Bats, and ShellSpec. NOT for Python, TypeScript, Go, web code, or infrastructure operations.
tools
Use when planning, executing, checkpointing, finishing, or inspecting lightweight spec-driven work. Runs one task at a time using `.spec/` markdown files and the bundled `specctl` helper. NOT for broad product discovery beyond a short requirement interview.
testing
Author, inspect, troubleshoot, and review infrastructure across IaC, Kubernetes, cloud resources, containers, CI/CD, and Linux hosts. Use when changing Terraform/OpenTofu, Kubernetes, Helm, Kustomize, Dockerfiles, GitHub Actions, AWS, GCP, Cloud Run, BigQuery, IAM, logs, instances, or service health. NOT for deploy/apply/rollback workflows (see deploying-infra). NOT for shell scripts or generic command pipelines (see writing-shell).
development
Configure safe git workflow hygiene: pre-commit/pre-push hooks, Gitleaks secret scanning, .gitignore rules, local git config, and guardrails. Use when setting up git hooks, gitleaks/git leaks, staged pre-commit checks, pre-push validation, core.hooksPath, .gitignore, or git config best practices. NOT for creating commits (use committing-code), cleaning branches/worktrees (use cleanup-git), or creating worktrees (use using-git-worktrees).