read-avro-files

Extract and deserialize JSON data from Apache Avro files.

1|Updated Sep 6, 2025
One-click install
npx skills add https://github.com/ranjanpoudel1234/ai-tools --skill read-avro-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read-avro-files
Source: https://github.com/ranjanpoudel1234/ai-tools/tree/main/ClaudeCode/configuration/skills/read-avro-files
Command: npx skills add https://github.com/ranjanpoudel1234/ai-tools --skill read-avro-files

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires avro-python3, and includes scripts (resource) components.

What problem does it solve?

This skill reads Apache Avro files and presents their contents as readable JSON, including automatic deserialization of nested Body fields to improve data visibility during debugging and validation.

Core Features & Use Cases

  • Extract and display JSON data from Avro files, making records human-readable
  • Deserialize nested Body fields into proper JSON objects for easier inspection
  • Save all records to a JSON file in the same directory for downstream processing or auditing

Quick Start

Use the bundled Python script to process a specific Avro file: python scripts/read_avro.py "<path_to_avro_file>" Example: python scripts/read_avro.py "data/events/sample.avro"

Frequently Asked Questions about read-avro-files

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

FAQPage Schema
How do I convert Avro files to JSON for data inspection?

To convert Avro files to JSON, this Skill uses a Python script with the avro-python3 package to deserialize records and save them as readable JSON output. It extracts nested data and writes a JSON file to the same directory for downstream auditing.

Why does my Avro deserialization output nested Body fields as unreadable strings?

Avro deserialization may leave nested Body fields as strings if not automatically parsed. This Skill's script specifically deserializes nested Body fields into proper JSON objects, improving data visibility during pipeline debugging and validation.

Do I need Python 3 and avro-python3 to read Avro event streams?

Yes, you need Python 3 and the avro-python3 dependency to read Avro event streams. The Skill relies on this specific package and bundled scripts to extract and print records from Avro-encoded data.

What is the best way to validate Avro-encoded data in a data pipeline?

The best way to validate Avro-encoded data in a pipeline is to deserialize it into human-readable JSON. This Skill extracts records from Avro storage or event streams, automatically parsing nested fields to provide clear outputs for inspection.

Can I save extracted Avro records to a JSON file for downstream processing?

Yes, you can save extracted Avro records to a JSON file for downstream processing. The Skill reads the Avro input, deserializes the contents, and automatically saves all records as a JSON file in the same directory as the original data.