Initial commit
This commit is contained in:
82
skills/data.transform/README.md
Normal file
82
skills/data.transform/README.md
Normal file
@@ -0,0 +1,82 @@
|
||||
# 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*
|
||||
Reference in New Issue
Block a user