![Dependency Status](https://img.shields.io/endpoint?url=https://samotech.github.io/skills-tree/badges/skills-01-perception-README.json)

# 👁️ Perception Skills

Perception skills enable agents to **sense, read, and interpret inputs** from their environment — text, images, files, screens, sensors, and more.

## Skills in This Category

| Skill | Level | Description |
|---|---|---|
| [Text Reading](text-reading.md) | Basic | Parse and understand plain text input |
| [PDF Parsing](pdf-parsing.md) | Basic | Extract text and structure from PDF documents |
| [Image Understanding](image-understanding.md) | Intermediate | Describe, classify, and analyze images |
| [OCR](ocr.md) | Intermediate | Extract text from images and scanned documents |
| [Screen Reading](screen-reading.md) | Intermediate | Capture and parse a desktop/browser screenshot |
| [Audio Transcription](audio-transcription.md) | Intermediate | Convert speech to text |
| [Video Understanding](video-understanding.md) | Advanced | Analyze and describe video content |
| [Document Parsing](document-parsing.md) | Intermediate | Parse DOCX, XLSX, PPTX, CSV, HTML |
| [Code Reading](code-reading.md) | Intermediate | Read and understand source code files |
| [Structured Data Reading](structured-data-reading.md) | Basic | Parse JSON, XML, YAML, TOML |
| [Email Parsing](email-parsing.md) | Intermediate | Parse and extract information from emails |
| [URL/DOM Inspection](url-dom-inspection.md) | Intermediate | Inspect live web page DOM structure |
| [File System Reading](file-system-reading.md) | Basic | List and read local/remote file systems |
| [Sensor Reading](sensor-reading.md) | Advanced | Read IoT sensor streams and telemetry |
| [Database Reading](database-reading.md) | Intermediate | Query SQL/NoSQL databases for context |
| [API Response Parsing](api-response-parsing.md) | Intermediate | Parse structured responses from external APIs |
| [Chart/Graph Reading](chart-reading.md) | Advanced | Interpret data from charts and graphs in images |
| [Handwriting Recognition](handwriting-recognition.md) | Advanced | Recognize handwritten text in images |
| [Binary File Reading](binary-file-reading.md) | Advanced | Extract metadata, magic bytes, and content from binary files |
| [Calendar Parsing](calendar-parsing.md) | Basic | Parse iCal files and calendar API responses into structured events |
| [Contract Reading](contract-reading.md) | Advanced | Extract clauses, parties, dates, and obligations from legal contracts |
| [Conversation History Reading](conversation-history-reading.md) | Basic | Load and structure multi-turn conversation histories for context injection |
| [Geospatial Reading](geospatial-reading.md) | Intermediate | Read GeoJSON, Shapefile, and KML into coordinate and feature objects |
| [Git Diff Reading](git-diff-reading.md) | Intermediate | Parse unified diff output into structured change objects |
| [HTML Reading](html-reading.md) | Basic | Extract clean text and structured data from HTML pages |
| [JSON Schema Validation](json-schema-validation.md) | Basic | Validate JSON payloads against a schema before processing |
| [Knowledge Graph Reading](knowledge-graph-reading.md) | Advanced | Query and traverse knowledge graphs to extract entity relationships |
| [Log Parsing](log-parsing.md) | Intermediate | Parse structured and unstructured log files into queryable event streams |
| [Markdown Parsing](markdown-parsing.md) | Basic | Parse Markdown into structured AST extracting headings, code blocks, and links |
| [Multimodal Document Reading](multimodal-document-reading.md) | Intermediate | Process documents containing mixed text, images, tables, and diagrams |
| [Network Traffic Reading](network-traffic-reading.md) | Advanced | Capture and parse PCAP/HTTP traffic for analysis and security auditing |
| [Social Media Reading](social-media-reading.md) | Basic | Fetch and parse posts, threads, and metadata from social media APIs |
| [Spreadsheet Reading](spreadsheet-reading.md) | Basic | Read XLSX, CSV, and ODS files into structured tabular data |
| [Table Extraction](table-extraction.md) | Intermediate | Extract structured tables from documents, images, and HTML |
| [Time Series Reading](time-series-reading.md) | Intermediate | Ingest and parse time-stamped data streams into structured sequences |
| [XML Parsing](xml-parsing.md) | Basic | Parse XML documents into structured trees or dicts |
