skills.rest
paulnsorensen
paulnsorensenCOMMUNITY
Explore all skills by this author →
GitHub

cheez-read

Read repository files with AST-aware structure via tilth MCP.

15|1|Updated May 4, 2026
Search Tags:#token budgeting#code reading#edit mode#hash anchors#ast-aware#mcp tilth#repository browsing
One-click install
npx skills add https://github.com/paulnsorensen/easy-cheese --skill cheez-read
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cheez-read
Source: https://github.com/paulnsorensen/easy-cheese/tree/main/skills/cheez-read
Command: npx skills add https://github.com/paulnsorensen/easy-cheese --skill cheez-read

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

cheez-read lets you view and inspect repository files safely and efficiently, especially source code, without wasting tokens or losing edit-ready anchors.

Core Features & Use Cases

  • AST-aware reading: Uses tilth MCP to read files with structural understanding rather than generic text viewing.
  • Outline vs full content: Automatically returns full content for small files and outlines for large files to control token usage.
  • Edit-mode hash anchors: When needed, read specific line ranges in edit mode to capture hash anchors for follow-up edits.
  • Scope guardrails: Enforces a hard tilth-only contract for code paths and refuses to fall back to host tools when tilth isn’t available.
  • Directory listing with token estimates: Supports listing code files via tilth_files instead of ls/find-style browsing.

Quick Start

Ask to view the relevant code by saying: read src/auth.ts and return the important sections with line numbers.

Frequently Asked Questions about cheez-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read large source code files without wasting tokens?▼

AST-aware code reading inspects source files structurally rather than as generic text, automatically returning outlines for large files to control token usage while preserving full content for smaller ones.

What is AST-aware file reading for repository browsing?▼

AST-aware file reading uses structural understanding to inspect repository source code safely, returning full content for small files and outlines for large files to control token usage during repository browsing.

How do I get edit-ready hash anchors for specific line ranges in code?▼

To get edit-ready hash anchors, read specific line ranges in edit mode using the tilth MCP server, which captures the necessary anchors for follow-up code edits without falling back to host tools.

Does AST-aware code reading work without the tilth MCP server available?▼

No, AST-aware code reading enforces a hard tilth-only contract and will hard-stop if the tilth MCP server is unavailable or unhealthy, refusing to fall back to standard host viewers or list tools.

How do I list code files in a repository with token estimates?▼

List code files with token estimates using tilth_files instead of standard ls or find-style browsing, providing directory listing capabilities that help estimate token usage before reading source code.

Related Skills

Explore More Software Engineering Skills→
paulnsorensenpaulnsorensen
15

cheez-search

Search repository code for symbol definitions, callers, and imports via tilth MCP.

Community
Intermediate
paulnsorensenpaulnsorensen
15

cheez-write

Replace or delete code blocks safely using hash anchors and tilth edit mode.

Community
Advanced
tsuna44tsuna44

xddp.codemap

Generate module catalogs with symbol indices and dependency graphs for software repositories.

Community
Intermediate
mvandermeulenmvandermeulen
2

ast-grep

Perform AST-aware code search and structural refactoring across 25 programming languages.

Community
Intermediate