alexei-led/searching-code
plugins/dev-workflow/skills-pi/searching-code/SKILL.md
Intelligent codebase search and zoom-out mapping using Pi tools. Use when the user asks how code works, to trace a flow, find implementations, zoom out, or map an area of a large repo.
$ install --global
skillsauthnpx skillsauth add alexei-led/claude-code-config searching-codeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 11, 2026, 4:36 AM116.7s1 file scanned
SKILL.md
- description:
- Intelligent codebase search and zoom-out mapping using Pi tools. Use
- name:
- searching-code
<!-- generated by scripts/build/generate-skills.py — edits to this file will be overwritten by `make build`. Edit the canonical SKILL.md (or add a SKILL.codex.md / SKILL.pi.md sidecar to diverge). -->
<!-- Pi platform guidance -->
<!-- Use Pi tool names exactly: read, bash, edit, write, ask_user_question, structured_output, todo, Agent, get_subagent_result, steer_subagent, web_search, web_answer, web_research. -->
<!-- Use Agent, get_subagent_result, and steer_subagent for delegated work. -->
<!-- Use ctx7 or npx ctx7@latest through bash when Context7 documentation lookup is required. -->
Codebase Search in Pi
Map code with verified file references. Do not read the whole repo because the user sounds curious. Curiosity is not a query plan.
Workflow
- Clarify scope if the request is vague.
- Check for domain docs first when present:
CONTEXT.mdCONTEXT-MAP.md- nearest
*/CONTEXT.md docs/adr/*.md
- Use
fdto find likely files andrgto find symbols, routes, handlers, tests, config keys, and shared types. - Read only the files or line ranges needed to verify the map.
- For large searches, launch one bounded
Agentwithscoutto gather compressed context. Keep the main loop in control. - Separate verified facts from guesses and unknowns.
Useful Commands
fd 'auth|login|session|user'
rg -n 'login|authenticate|AuthService|Session|UserRepository'
rg -n 'func .*Handler|class .*Controller|router\.|app\.'
Zoom-Out Mode
Use when the user says "zoom out", "map this area", "go up a layer", or sounds lost in local details.
Return:
- Flow with
file:linereferences. - Key modules and responsibilities.
- Callers, callees, shared types, and messages.
- Unknowns or unverified assumptions.
- Read-next list, top 3 files only.
Output Contract
## Code Map
### Scope
<what was mapped>
### Flow
1. `path:line` — fact
2. `path:line` — fact
### Modules
| Module | Files | Responsibility |
| --- | --- | --- |
### Unknowns
- <gap and how to verify>
### Read Next
1. `path` — why
Related Skills
alexei-led/spec-flow
tools
VerifiedTrustedCommunity
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. NOT for generic implementation planning that does not read or write `.spec/` files.
35SKILL.mdUpdated Jul 18, 2026
alexei-led/writing-web
development
VerifiedTrustedCommunity
Simple web development with HTML, CSS, JS, and HTMX. Use when working with .html, .css, or .htmx files, web templates, stylesheets, or vanilla JS scripts. NOT for React/Vue/Angular (use writing-typescript) or Node.js backends.
35SKILL.mdUpdated Jul 18, 2026
alexei-led/writing-typescript
tools
VerifiedTrustedCommunity
Idiomatic TypeScript development. Use when writing TypeScript code, Node.js services, React apps, or TypeScript design advice. Emphasizes strict typing, boundary validation, composition, fast feedback, behavior tests, and project-configured tooling. NOT for Go, Python, Rust, plain HTML/CSS/JS, or server-rendered templates (use writing-web).
35SKILL.mdUpdated Jul 18, 2026
alexei-led/writing-shell
tools
VerifiedTrustedCommunity
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, CI `run:` shell bodies, or command-runner recipes. Emphasizes portability, quoting, safe filesystem/process handling, non-TUI CLI tools, ShellCheck, shfmt, Bats, and ShellSpec. NOT for Python, Rust, TypeScript, Go, web code, or GitHub Actions workflow/job/permissions semantics; use operating-infra.
35SKILL.mdUpdated Jul 18, 2026