file-system

Traverse codebase directories and read JSON and Markdown files with ignore patterns.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/aaronmaturen/rumpleskill --skill file-system-aaronmaturen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-system
Source: https://github.com/aaronmaturen/rumpleskill/tree/main/.claude/skills/file-system
Command: npx skills add https://github.com/aaronmaturen/rumpleskill --skill file-system-aaronmaturen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides robust tooling to recursively scan directories, read files with explicit utf-8 encoding, and parse common formats like JSON and Markdown, while ignoring noisy paths such as node_modules, hidden files, and build artifacts.

Core Features & Use Cases

  • Recursive Directory Scanning: Traverse directories with configurable ignore patterns to enumerate files.
  • Safe File Reading & Parsing: Read content with utf-8 encoding and gracefully handle errors, plus parse JSON and Markdown content.
  • Contextual Data Gathering: Build structured summaries of a codebase for tooling or AI-assisted analysis.

Quick Start

Prompt the AI to scan a project directory and safely read JSON and Markdown files while applying ignore rules.

Frequently Asked Questions about file-system

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

FAQPage Schema
How do I recursively scan a project directory while skipping node_modules and build artifacts?

To recursively scan a project directory and skip node_modules, configure ignore patterns to filter out noisy paths like hidden files and build artifacts, which yields a clean file enumeration for safe codebase analysis.

What is the best way to safely read and parse JSON and Markdown files in a Node.js codebase?

The best way to safely read and parse JSON and Markdown files in a Node.js codebase is using a tool that applies explicit utf-8 encoding and robust error handling, which ensures content is parsed gracefully without crashing batch processing.

Does safe file system traversal handle utf-8 encoding errors during batch processing?

Yes, safe file system traversal handles utf-8 encoding errors during batch processing by implementing robust parsing and graceful error handling, which ensures that malformed files do not interrupt the directory scanning workflow.

Can I build a structured summary of a codebase by parsing Markdown and JSON files?

Yes, you can build a structured summary of a codebase by recursively gathering contextual data and parsing Markdown and JSON files, which provides reliable structured input for tooling or AI-assisted analysis without including ignored directories.

Why does recursive file reading fail when encountering malformed JSON in a directory scan?

Recursive file reading fails on malformed JSON when lacking robust error handling, but safe traversal techniques apply graceful parsing logic to prevent unhandled exceptions and maintain stable batch processing across the codebase.