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/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, 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.
33SKILL.mdUpdated Jun 5, 2026
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.
33SKILL.mdUpdated Jun 5, 2026
alexei-led/operating-infra
testing
VerifiedTrustedCommunity
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).
33SKILL.mdUpdated Jun 5, 2026
alexei-led/configuring-git-hygiene
development
VerifiedTrustedCommunity
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).
33SKILL.mdUpdated Jun 5, 2026