skilld
All skills
oaustegard avatar

/tree-sitting

@9741035
by Oskar Austegardoaustegard/claude-skills150 stars
6

Symbol-level navigation of a local checkout using tree-sitter ASTs. Answers where a symbol is defined, what lines it spans, which symbols a file exposes, what a directory holds, and where a name is referenced — every answer carries exact line ranges to feed straight into a scoped read. Use for "where is X defined", "who calls X", "find the function/class named", "what's in this file", "give me the line range for", "show me the source of", "list the symbols in", or before editing a file you have not read. Each invocation auto-scans and is self-contained. Not for first-encounter repo orientation (use exploring-codebases), for what a codebase DOES rather than what it contains (featuring), for binding-resolved Python caller sets (searching-codebases), or for literal text and regex matching (plain ripgrep).

Ask your Agent

Use this Skill: https://skilld.dev/gh/oaustegard/claude-skills/tree-sitting

This session only. Nothing lands on disk.

README.md

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

tree-sitting

AST-powered code navigation using tree-sitter. Parses all source files in a codebase into in-memory syntax trees, then provides fast query tools for symbol search, file/directory overview, source retrieval, and reference finding.

Features

  • Fast scanning — parses ~250 files in ~700ms, then all queries are sub-millisecond from cache
  • Symbol search — find by exact name, substring, or glob pattern across the entire codebase
  • Directory and file overview — structural summaries with symbol counts, signatures, and doc comments
  • Source retrieval — fetch implementation of any symbol, preferring definitions over declarations
  • Reference finding — locate all textual references to a symbol via fast grep against cached source
  • 12 grammars — Python, JavaScript, TypeScript, TSX, Go, Rust, Ruby, Java, C, HTML, Markdown, Mojo. Bundled for Linux x86_64 (.so) and macOS (.dylib); scripts/build_grammars.py compiles them anywhere else.
  • Three-tier extraction — custom extractors (richest), community tags.scm queries, and generic heuristic fallback
  • Dual deployment — direct Python calls in Claude.ai, or long-lived MCP server in Claude Code

Dependencies

  • tree-sitter — bare parser runtime
  • Python 3.10+ — the grammars are ABI 15, which needs the tree-sitter >= 0.25 binding
  • fastmcp — required only for MCP server mode (Claude Code)

Source: SKILL.md on GitHub

Third-party checks

1 warning1mo3 checks · Risk MEDIUM
  • Gen Agent Trust Hub1mo

    The skill provides AST-based code navigation by bundling pre-compiled binary grammars (.so files) which are loaded at runtime using ctypes. While this is necessary for the tool's performance and offline capability, the inclusion and execution of bundled binaries represent a medium security risk. Additionally, the skill's function of parsing untrusted codebases creates a surface for indirect prompt injection.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Provenance

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

Last checked against GitHub yesterday.

Activeupdated yesterday

Capability

metadata
{
  "version": "0.10.1"
}

README badge

README badge for oaustegard/claude-skills/tree-sitting