# File Read

> Read a file from an allowed path on the local filesystem

- Skill: `keyargo/file-read` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add keyargo/file-read`
- Raw SKILL.md: https://api.skillmd.com/api/skills/keyargo/file-read/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: KeyArgo (https://skillmd.com/u/keyargo)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/keyargo/file-read

---


# File Read

Read a file from an allowed path on the local filesystem

## Authority band

This tool runs under **L0** authority in the Custodian kernel. Read-only; no real-world effects — always autonomous.

## Inputs

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| (see execute.py for full schema) | | | |

## Configuration

No additional configuration required — uses credentials already wired to Custodian.

## Usage

```bash
custodian tools run file-read --param value
```

## Custodian governance

Every call to this tool passes through the Custodian kernel authority check
before executing. The kernel verifies the current authority band, checks
spending caps where applicable, logs the action to the OCSF audit trail,
and escalates to a human operator if the action exceeds the declared band.

Adding this tool to any Hermes agent session requires no code changes —
declare `custodian-band: L0` in the SKILL.md frontmatter and the kernel
wraps it automatically.