# data.transform

Transform data between different formats (JSON, YAML, XML, CSV) with validation and error handling

## Overview

**Purpose:** Transform data between different formats (JSON, YAML, XML, CSV) with validation and error handling

**Command:** `/data/transform`

## Usage

### Basic Usage

```bash
python3 skills/data/transform/data_transform.py
```

### With Arguments

```bash
python3 skills/data/transform/data_transform.py \
  --input_file_path "value" \
  --source_format "value" \
  --target_format "value" \
  --schema_path_(optional) "value" \
  --output-format json
```

## Inputs

- **input_file_path**
- **source_format**
- **target_format**
- **schema_path (optional)**

## Outputs

- **transformed_file**
- **transformation_report.json**

## Artifact Metadata

### Produces

- `transformed-data`
- `transformation-report`

## Permissions

- `filesystem:read`
- `filesystem:write`

## Implementation Notes

Support transformations between: - JSON ↔ YAML - JSON ↔ XML - JSON ↔ CSV - YAML ↔ XML - XML ↔ CSV Features: - Validate input against schema before transformation - Preserve data types during conversion - Handle nested structures appropriately - Report data loss warnings (e.g., CSV can't represent nesting) - Support custom transformation rules - Provide detailed error messages Output report should include: - Transformation success status - Source and target formats - Data validation results - Warnings about potential data loss - Transformation time and file sizes

## Integration

This skill can be used in agents by including it in `skills_available`:

```yaml
name: my.agent
skills_available:
  - data.transform
```

## Testing

Run tests with:

```bash
pytest skills/data/transform/test_data_transform.py -v
```

## Created By

This skill was generated by **meta.skill**, the skill creator meta-agent.

---

*Part of the Betty Framework*