Initial commit

skills/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: csv-url-parser
+description: Parse URLs in CSV files and extract query parameters as new columns. Use when working with CSV files containing URLs that need parameter extraction and analysis.
+allowed-tools: Read, Write, Bash, Glob
+---
+
+# CSV URL Parser
+
+This skill extracts query parameters from URLs in CSV files and adds them as new columns.
+
+## Instructions
+
+1. **Identify CSV files**: Look for CSV files in the current directory or specified path
+2. **Analyze URL column**: Find the column containing URLs (looks for 'url' or 'URL' headers)
+3. **Extract parameters**: Parse all query parameters from URLs
+4. **Create new columns**: Add parameter names as new column headers
+5. **Process data**: Fill new columns with parameter values (multiple values joined with '|')
+6. **Save results**: Update the CSV file with new columns
+
+## Implementation
+
+The skill uses Ruby to process CSV files. Run the processing script:
+
+```bash
+ruby scripts/process_csv.rb [file1.csv file2.csv ...]
+```
+
+If no files are specified, it processes all CSV files in the current directory.
+
+The script will:
+
+- Read CSV files with headers
+- Extract query parameters from URLs using URI parsing
+- Handle multiple values for the same parameter (joined with '|')
+- Preserve original data while adding new parameter columns
+- Handle malformed URLs gracefully
+
+For detailed examples, see [EXAMPLES.md](EXAMPLES.md).
+
+## Usage Examples
+
+**Process all CSV files in current directory:**
+```
+Parse URLs in my CSV files
+```
+
+**Process specific CSV file:**
+```
+Extract URL parameters from data.csv
+```
+
+**Analyze URL parameters:**
+```
+Show me what parameters are in the URLs from this CSV
+```
+
+## Requirements
+
+- Ruby with standard libraries (CSV, URI, CGI)
+- CSV files must have headers
+- URL column should be named 'url' or 'URL'
+
+## Output
+
+- Original CSV file updated with new parameter columns
+- Multiple parameter values separated by '|'
+- Preserves all original data
+- Handles empty/missing parameters gracefully