# Fs Head

> Read the first N lines of a text file under scenarios/<world_name>/fs.

- Skill: `bdambrosio/fs-head` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bdambrosio/fs-head`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bdambrosio/fs-head/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bdambrosio (https://skillmd.com/u/bdambrosio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bdambrosio/fs-head

---


# fs-head

Return the first N lines of a text file from the filesystem sandbox.

## Input

- `path`: Relative path under `scenarios/<world_name>/fs` (required)
- `lines`: Number of lines to return (default: 20)

## Output

Success returns:
- `resource_id`: Note ID containing text content.
- Note content format:
  - metadata Note linked by meta Relation (path/line range/truncation metadata)
  - body text with the first N lines

## Examples

```json
{"type":"fs-head","path":"logs/app.log","lines":50,"out":"$log_head"}
```