CtrlK
BlogDocsLog inGet started
Tessl Logo

scout

File system watcher and AST parser. Detects changes in the watched repository, extracts AST structure using tree-sitter, and emits structured ChangeEvents for the Architect to process.

57

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./workspace/skills/scout/SKILL.md
SKILL.md
Quality
Evals
Security

Scout

The Scout watches a configured directory for file system events and parses changed files into structured AST representations. It is deterministic and cheap to run — it makes zero LLM calls.

Capabilities

  • Watch a directory for file create, modify, and delete events using watchdog
  • Filter events by file extension (.py, .js, .ts) and ignore patterns
  • Debounce rapid saves (500ms per-file window)
  • Parse Python files into AST nodes using tree-sitter
  • Emit structured ChangeEvents to the MessageBus

Scripts

  • watcher.py — RepoWatcher class using watchdog
  • parser.py — ASTParser class using tree-sitter
  • events.py — Event creation helpers
Repository
tombrewsviews/repository-os-mvp
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.