# Read

> Read file contents with line numbers. Use when viewing source code, reading configuration files, examining documentation, or inspecting any text file.

- Skill: `knoopx/read` (Agent Skill)
- Install (CLI): `npx skillmds@latest add knoopx/read`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knoopx/read/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knoopx (https://skillmd.com/u/knoopx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/knoopx/read

---


## Read Tool

Read a file's contents with line numbers.

REQUIRED: path (absolute path)
OPTIONAL: limit (max lines), offset (start line, 0-indexed)

RULES:

- Always use absolute paths, never relative
- Use limit+offset for large files (read in chunks of 100-200 lines)
- Returns format: "N\tline_content" (tab-separated line number + content)

EXAMPLE:

```tool
{"name": "Read", "input": {"path": "/absolute/path/to/file.py"}}
```

EXAMPLE with range:

```tool
{"name": "Read", "input": {"path": "/absolute/path/to/file.py", "limit": 50, "offset": 100}}
```

## Workflow

1. **Use absolute paths**: Always provide the full absolute path to the file
2. **Read in chunks**: For large files, use `limit` and `offset` to read 100-200 lines at a time
3. **Check line numbers**: Output includes line numbers to reference specific locations
4. **Combine with edit**: Read a file before editing to get exact content for `oldText`