skilld
All skills
oaustegard avatar

/searching-codebases

@04bfd5b
by Oskar Austegardoaustegard/claude-skills150 stars
6

Binding-resolved Python symbol queries via pyright — every true caller (--refs), the real definition (--def), or an inferred signature (--hover) of a .py symbol, excluding the same-named false positives text search cannot tell apart. Use when a task needs ALL callers or users of a named Python symbol and grep would over-match. Python only, and only for the caller/definition question: measured 2026-07-04 on real issue-localization tasks, plain ripgrep tied or beat the semantic and indexed-regex tiers at 4-60x less wall-clock, so those tiers survive below without being a default.

Ask your Agent

Use this Skill: https://skilld.dev/gh/oaustegard/claude-skills/searching-codebases

This session only. Nothing lands on disk.

CHANGELOG.md

≈914 tokens on demand. Your agent reads this file only when SKILL.md points to it.

searching-codebases - Changelog

All notable changes to the searching-codebases skill are documented in this file. The format is based on Keep a Changelog.

[2.5.0] - 2026-08-25

Other

  • top skills: separate by omission, and correct the guidance that said otherwise (#777)
  • Deprecate mapping-codebases; adopt ruff 0.16.0 baseline (#747)

[2.2.0] - 2026-07-04

Other

  • searching-codebases 2.2.0: narrow to binding-resolved edge case (#722)

[2.2.0] - 2026-07-04

Changed

  • Repositioned the skill as edge-case: the binding-resolved Python tier (--refs/--def/--hover) is the one recommended use. Frontmatter description and When-to-Use rewritten accordingly.
  • Empirical basis: head-to-head localization eval on 7 scikit-learn issues with merged fix-PRs (replicating the file-discovery metric of arXiv:2602.11988). Indexed-regex and TF-IDF semantic tiers tied or lost vs naive rg on every instance at 4-60x wall-clock; semantic never won, including on identifier-poor issues (~0.3% of merged-PR traffic).
  • Tiers remain functional; they carry the burden of proof.

[2.1.1] - 2026-06-15

Fixed

  • open all symbol-bearing files for the binding-resolved tier (#698)
  • auto-install tree-sitter for the binding-resolved tier

[2.1.0] - 2026-06-15

Added

  • add treesit.py CLI, fix cross-process cache loss, fix Symbol dict bug (#536)

Other

  • searching-codebases: binding-resolved Python tier via python-lsp (#695) (#697)
  • Remove _MAP.md files, direct agents to tree-sitting for code navigation (#545)
  • Add missing READMEs for searching-codebases, featuring, tree-sitting (#521)

[2.1.0] - 2026-06-15

Added

  • Binding-resolved reference/definition tier for Python via the python-lsp skill (pyright): --refs, --def, --hover (#695)
    • --refs SYMBOL excludes same-named-but-unrelated symbols and follows imports — the precision the regex cross-reference tier lacks
    • Engaged lazily (pyright index cost paid only on these flags); Python-only with a mandatory soft fallback to the regex text path (non-.py, or pyright/node absent) that emits a one-line degradation note
    • scripts/lsp_refs.py: tree-sitting symbol→position resolution, 1-based↔0-based conversion at the LSP boundary, lifecycle-safe queries (index-wait + subprocess reaping)
    • tests/test_lsp_refs.py: binding-resolution, import-following, indexing-wait determinism, no orphaned subprocess, and soft-fallback coverage

[2.0.0] - 2026-03-31

Other

  • exploring v1.0.0, searching v2.0.0: tree-sitting replaces mapping-codebases
  • Regenerate _MAP.md files after @lat: backlink insertion (#504)
  • Lattice v2: bidirectional source-anchored knowledge graph (#503)

[1.0.0] - 2026-03-25

Added

  • add mapping-features skill for behavioral web app documentation (#432)

Other

  • Remove searching-codebases/scripts/_MAP.md (absorbed into search.py)
  • Remove searching-codebases/scripts/flowing.py (absorbed into search.py)
  • Remove searching-codebases/scripts/pipeline.py (absorbed into search.py)
  • searching-codebases/scripts/sparse_ngrams.py
  • searching-codebases/scripts/ngram_index.py
  • searching-codebases/scripts/context.py
  • searching-codebases/scripts/resolve.py
  • searching-codebases/scripts/search.py
  • searching-codebases/SKILL.md
  • Implement #414, #415, #416: perch findings digests, boot flight awareness, inline links
  • Add searching-codebases skill

2.3.0 — 2026-07-26

  • Dropped _MAP.md as a corpus source (_extract_map_entries removed). Code and markdown extractors are unaffected; _MAP.md files no longer exist to index.

Source: SKILL.md on GitHub

Third-party checks

3 warnings9d3 checks · Risk MEDIUM
  • Gen Agent Trust Hub9d

    This skill provides advanced code search capabilities but contains a security vulnerability in how it handles archive files (path traversal) and performs automated package installations at runtime.

  • Socket9d

    1 alert: gptSecurity

  • Snyk9d

    Risk: MEDIUM · 1 issue

Provenance

Signed by skilld at 04bfd5b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month

Capability

metadata
{
  "version": "2.5.0"
}

README badge

README badge for oaustegard/claude-skills/searching-codebases