tsa-findlisted

# tsa-find — File / text search, sized for agents > The "I just want to find X" skill. Wraps `fd` + `rg` + sized partial reads > with consistent output formatting. ## Tool routing | Question | Tool | |-------------------------------------------|-------------------------| | Filename pattern only | `list_files` | | Content pattern only (regex / literal) | `search_content` | | Filename pattern AND content | `find_and_grep` | | Read specific lines of one file | `extract_code_section` | | "Is this file too big to read fully?" | `check_code_scale` | ## Procedure ### Single search ```yaml search_content(pattern: "TODO", path: "tree_sitter_analyzer/", file_pattern: "*.py") ``` Returns: `matches: [{file, line, content}]` with sized previews. Always includes file:line so the agent can cite without reading the file. ### Sized partial read (the killer feature) Before reading a large file blind, use: ```yaml check_code_scale(file_path: "tree_sitter_analyzer/ast_cache.py") # returns {lines: 2144, size_bytes: 79809, is_large: true, recommendation: "use extract_code_section"} ``` Then extract only what you need: ```yaml extract_code_section(file_path: "...", start_line: 800, end_line: 870) ``` Avoids reading 80KB when you need 2KB. ### Combined find+grep ```yaml find_and_grep(file_pattern: "test_*.py", content_pattern: "def test_synapse") # retu