file-parser

file-parser is a skill for Claude Code from hamzaPixl/pixl-ai. It costs 69 tokens per session (1,008 once invoked), scanned A, original, MIT.

A command-line tool for extracting readable content from PDF, text, and JSON files, including scanned PDFs through OCR. It lets a coding agent consume file contents for analysis.

In plain words
What is it for?
Reading PDFs, Markdown, CSV, logs, configuration files, JSON, JSONL, and GeoJSON files for further processing.
Why use it?
It removes the need to open files manually or write a separate parser for each file type. It can also focus on selected PDF pages or recover text from scans.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the pixl-crew plugin — 93 skills, 14 agents, 6 hooks shipped together

Good fit Reading PDFs, Markdown, CSV, logs, configuration files, JSON, JSONL, and GeoJSON files for further processing.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hamzapixl/pixl-ai/file-parser
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add hamzaPixl/pixl-ai --skill file-parser
Clone the repo
git clone --depth 1 https://github.com/hamzaPixl/pixl-ai

Made for: Claude Code.

Or install pixl-crew, the plugin that ships this one along with the rest of its 93 skills, 14 agents, 6 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for file-parser

README.md
[![agentmods](https://agentmods.dev/badge/skills/hamzapixl/pixl-ai/file-parser/github.svg)](https://agentmods.dev/skills/hamzapixl/pixl-ai/file-parser)
Your own site
<a href="https://agentmods.dev/skills/hamzapixl/pixl-ai/file-parser"><img src="https://agentmods.dev/badge/skills/hamzapixl/pixl-ai/file-parser/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for file-parser

Your own site · 80×15
<a href="https://agentmods.dev/skills/hamzapixl/pixl-ai/file-parser"><img src="https://agentmods.dev/badge/skills/hamzapixl/pixl-ai/file-parser.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 69 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,008 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00069 $0.01008
Opus 5.5 $0.00028 $0.00403
Sonnet 5.5 $0.00014 $0.00202
Haiku 4.5 $0.00007 $0.00101

Measured 1mo ago against content hash 3ef44cadabc1, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

file-parser scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packages/crew/skills/file-parser/SKILL.md · 102 lines

How it starts

The opening of the file, as written. The whole thing — 102 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Overview

Wrapper around the file-parser CLI (hamzaPixl/file-parser-cli). Extracts content from PDF, text, and JSON files so agents can consume and process the data. Automatically detects file type from extension and routes to the correct parser.

Prerequisites

The CLI must be installed. Check with:

command -v file-parser || (cd ~/code/pixl/file-parser-cli && uv sync)

If not on PATH, use the full invocation: cd ~/code/pixl/file-parser-cli && uv run file-parser ...

Step 1: Detect File Type

  1. Receive the file path from the user or agent
  2. Check the file exists: ls -la <path>
  3. Determine the parser from extension:
    • .pdf → pdf command
    • .txt, .md, .csv, .log, .env, .yml, .yaml, .toml, .ini, .cfg → text command
    • .json, .jsonl, .geojson → json command
  4. If extension is ambiguous, check file content with file <path>

Step 2: Extract Content

PDF Files

cd ~/code/pixl/file-parser-cli && uv run file-parser pdf "<file_path>"

Options:

  • Page selection: --pages 1-3,5,8-10 (1-indexed, comma-separated ranges)
  • OCR mode: --ocr auto (OCR only when text extraction returns nothing)
  • OCR always: --ocr always (force OCR on all pages, useful for scanned docs)
  • OCR DPI: --ocr-dpi 300 (higher = better quality, slower)

Strategy:

  1. First try without OCR: uv run file-parser pdf "<path>"
  2. If output is empty or garbled, retry with: uv run file-parser pdf "<path>" --ocr auto
  3. For large PDFs (50+ pages), extract in chunks: --pages 1-20, then --pages 21-40, etc.

Text Files

cd ~/code/pixl/file-parser-cli && uv run file-parser text "<file_path>"

Options:

  • Encoding: --encoding utf-8 (default), --encoding latin-1, etc.

JSON Files

cd ~/code/pixl/file-parser-cli && uv run file-parser json "<file_path>"

Options:

  • Compact output: --compact (no whitespace, useful for large files)
  • Encoding: --encoding utf-8

Read the full file on GitHub · 102 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 102 lines · 69 tokens per session scan A 3ef44cadabc1

Subscribe to this mod's changes

file-parser is a skill published in the GitHub repository hamzaPixl/pixl-ai (2 stars, last pushed 6mo ago), licensed MIT. It adds 69 tokens to every session and 1,008 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

apify-youtube-transcript-scraper

Get YouTube captions, timestamped quotations, SRT/VTT and translated transcripts for videos, channels and playlists through the harshmaur/youtube-transcript-scraper Apify Actor.

sickn33/agentic-awesome-skills · 48 tokens

foundry-hosted-agent-validation

Step-by-step process for validating a Python Foundry hosted agent sample (under python/samples/04-hosting/foundry-hosted-agents/) end to end — running it locally (native runtime and azd ai agent run) and after deploying it to an Azure AI Foundry project with azd. Use this when asked to validate a hosted agent sample.

microsoft/agent-framework · 82 tokens

skill-doc-delivery

Convert markdown to DOCX, PPTX, XLSX, PDF office documents — use when you need exportable deliverables.

nyldn/claude-octopus · 29 tokens

meta-web-to-pdf-briefing

Render a topic into a distributable PDF briefing in three steps: web search → bullet summary → styled PDF. Trigger when the user asks for a PDF briefing on a single topic.

opensquilla/opensquilla · 45 tokens

chat-complex-documents

Chat with and search your complex documents — ask questions, extract tables and fields, and get answers grounded in the source. Connects the hosted Unstructured Transform MCP server to parse, structure, and enrich PDFs, Word/Excel/PowerPoint, images, scanned files, emails, and 60+ other formats into clean, AI-ready…

vellum-ai/vellum-assistant · 90 tokens

pkf-writing

Author, update, convert, validate, persist, and render PKF (.pkf) content through message-inline, Library Asset, or Memory Page carriers. Use for structured reports, knowledge pages, delivery cards, or any .pkf body. NOT for recall, memory-graph placement, or curation decisions — those belong to the memory skill.

Prismer-AI/PrismerCloud · 78 tokens