aiskillstore/marketplace / skills/89jobrien/file-converter
file-converter
VerifiedThis skill handles file format conversions across documents (PDF, DOCX, Markdown, HTML, TXT), data files (JSON, CSV, YAML, XML, TOML), and images (PNG, JPG, WebP, SVG, GIF). Use when the user requests converting, transforming, or exporting files between formats. Generates conversion code dynamically based on the specific request.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
| references/data-conversions.md | markdown | 3.2 KB |
| references/document-conversions.md | markdown | 2.7 KB |
| references/image-conversions.md | markdown | 4.0 KB |
| skill-report.json | config | 40.0 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T12:12:55.063Z",
"slug": "89jobrien-file-converter",
"source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/file-converter",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "99aa0878eb2c9db9383145fd9c0d6efd5b01dcaff73188abf96b7b6b302ca8bd",
"tree_hash": "2537e87b6b61a9239815dc7297d2581639e7eceb3a8b5a3d203e884e5a0106b0",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "file-converter",
"description": "Converts documents, data files, and images between common formats using Python libraries and reference guidance. It covers PDF, DOCX, Markdown, HTML, JSON, CSV, YAML, XML, TOML, PNG, JPG, WebP, SVG, and GIF workflows.",
"summary": "Convert documents, data files, and images with generated Python guidance.",
"icon": "📦",
"version": "1.0.2",
"author": "Joseph OBrien",
"license": "MIT",
"tags": [
"file conversion",
"documents",
"data formats",
"image conversion",
"python"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"filesystem",
"external_commands"
],
"category": "data"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Security review found no malicious intent, prompt injection, credential access, or network reconnaissance. The static findings are false positives caused by Markdown backticks, conversion examples, local output writes, and a dictionary keys call.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "filesystem",
"evidence": [
{
"file": "references/data-conversions.md",
"line_start": 33,
"line_end": 33
},
{
"file": "references/data-conversions.md",
"line_start": 67,
"line_end": 67
},
{
"file": "references/data-conversions.md",
"line_start": 100,
"line_end": 100
},
{
"file": "references/data-conversions.md",
"line_start": 135,
"line_end": 135
},
{
"file": "references/data-conversions.md",
"line_start": 155,
"line_end": 155
},
{
"file": "SKILL.md",
"line_start": 76,
"line_end": 76
},
{
"file": "SKILL.md",
"line_start": 90,
"line_end": 90
},
{
"file": "SKILL.md",
"line_start": 104,
"line_end": 104
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 28,
"line_end": 28
},
{
"file": "SKILL.md",
"line_start": 29,
"line_end": 29
},
{
"file": "SKILL.md",
"line_start": 30,
"line_end": 30
},
{
"file": "SKILL.md",
"line_start": 31,
"line_end": 31
},
{
"file": "SKILL.md",
"line_start": 32,
"line_end": 32
},
{
"file": "SKILL.md",
"line_start": 33,
"line_end": 33
},
{
"file": "SKILL.md",
"line_start": 40,
"line_end": 40
},
{
"file": "SKILL.md",
"line_start": 41,
"line_end": 41
},
{
"file": "SKILL.md",
"line_start": 42,
"line_end": 42
},
{
"file": "SKILL.md",
"line_start": 43,
"line_end": 43
},
{
"file": "SKILL.md",
"line_start": 44,
"line_end": 44
},
{
"file": "SKILL.md",
"line_start": 45,
"line_end": 45
},
{
"file": "SKILL.md",
"line_start": 46,
"line_end": 46
},
{
"file": "SKILL.md",
"line_start": 52,
"line_end": 52
},
{
"file": "SKILL.md",
"line_start": 53,
"line_end": 53
},
{
"file": "SKILL.md",
"line_start": 54,
"line_end": 54
},
{
"file": "SKILL.md",
"line_start": 60,
"line_end": 60
},
{
"file": "SKILL.md",
"line_start": 69,
"line_end": 78
},
{
"file": "SKILL.md",
"line_start": 78,
"line_end": 82
},
{
"file": "SKILL.md",
"line_start": 82,
"line_end": 92
},
{
"file": "SKILL.md",
"line_start": 92,
"line_end": 96
},
{
"file": "SKILL.md",
"line_start": 96,
"line_end": 106
},
{
"file": "SKILL.md",
"line_start": 106,
"line_end": 110
},
{
"file": "SKILL.md",
"line_start": 110,
"line_end": 115
},
{
"file": "SKILL.md",
"line_start": 115,
"line_end": 119
},
{
"file": "SKILL.md",
"line_start": 119,
"line_end": 123
},
{
"file": "SKILL.md",
"line_start": 123,
"line_end": 127
},
{
"file": "SKILL.md",
"line_start": 127,
"line_end": 129
},
{
"file": "SKILL.md",
"line_start": 129,
"line_end": 130
},
{
"file": "SKILL.md",
"line_start": 130,
"line_end": 131
}
]
}
],
"static_findings": [
{
"id": "filesystem:references/data-conversions.md:33:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "references/data-conversions.md",
"line_start": 33,
"line_end": 33,
"snippet": "with open(\"output.csv\", \"w\", newline=\"\") as f:"
},
{
"id": "filesystem:references/data-conversions.md:67:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "references/data-conversions.md",
"line_start": 67,
"line_end": 67,
"snippet": "with open(\"output.json\", \"w\") as f:"
},
{
"id": "filesystem:references/data-conversions.md:100:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "references/data-conversions.md",
"line_start": 100,
"line_end": 100,
"snippet": "with open(\"output.json\", \"w\") as f:"
},
{
"id": "filesystem:references/data-conversions.md:135:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "references/data-conversions.md",
"line_start": 135,
"line_end": 135,
"snippet": "with open(\"output.yaml\", \"w\") as f:"
},
{
"id": "filesystem:references/data-conversions.md:155:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "references/data-conversions.md",
"line_start": 155,
"line_end": 155,
"snippet": "with open(\"output.toml\", \"wb\") as f:"
},
{
"id": "sensitive:references/data-conversions.md:35:certificate-key-files",
"category": "sensitive",
"severity": "high",
"pattern": "Certificate/key files",
"file": "references/data-conversions.md",
"line_start": 35,
"line_end": 35,
"snippet": "writer = csv.DictWriter(f, fieldnames=flat_data[0].keys())"
},
{
"id": "blocker:references/document-conversions.md:124:network-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "Network reconnaissance",
"file": "references/document-conversions.md",
"line_start": 124,
"line_end": 124,
"snippet": "libreoffice --headless --convert-to pdf input.docx"
},
{
"id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 28,
"line_end": 28,
"snippet": "| Markdown | HTML | `markdown` or `mistune` |"
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 29,
"line_end": 29,
"snippet": "| HTML | Markdown | `markdownify` or `html2text` |"
},
{
"id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 30,
"line_end": 30,
"snippet": "| HTML | PDF | `weasyprint` or `pdfkit` (requires wkhtmltopdf) |"
},
{
"id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 31,
"line_end": 31,
"snippet": "| PDF | Text | `pypdf` or `pdfplumber` |"
},
{
"id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 32,
"line_end": 32,
"snippet": "| DOCX | Markdown | `mammoth` |"
},
{
"id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 33,
"line_end": 33,
"snippet": "| DOCX | PDF | `docx2pdf` (Windows/macOS) or LibreOffice CLI |"
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 40,
"line_end": 40,
"snippet": "| JSON | YAML | `pyyaml` |"
},
{
"id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 41,
"line_end": 41,
"snippet": "| YAML | JSON | `pyyaml` |"
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 42,
"line_end": 42,
"snippet": "| JSON | CSV | `pandas` or stdlib `csv` + `json` |"
},
{
"id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 43,
"line_end": 43,
"snippet": "| CSV | JSON | `pandas` or stdlib `csv` + `json` |"
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 44,
"line_end": 44,
"snippet": "| JSON | TOML | `tomli`/`tomllib` (read) + `tomli-w` (write) |"
},
{
"id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 45,
"line_end": 45,
"snippet": "| XML | JSON | `xmltodict` |"
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 46,
"line_end": 46,
"snippet": "| JSON | XML | `dicttoxml` or `xmltodict.unparse` |"
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 52,
"line_end": 52,
"snippet": "| PNG/JPG/WebP/GIF | Any raster | `Pillow` (PIL) |"
},
{
"id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 53,
"line_end": 53,
"snippet": "| SVG | PNG/JPG | `cairosvg` or `svglib` + `reportlab` |"
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 54,
"line_end": 54,
"snippet": "| PNG | SVG | `potrace` (CLI) for tracing, limited fidelity |"
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 60,
"line_end": 60,
"snippet": "3. Check `references/` for format-specific guidance"
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 69,
"line_end": 78,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 78,
"line_end": 82,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 82,
"line_end": 92,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 92,
"line_end": 96,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 96,
"line_end": 106,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 106,
"line_end": 110,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 110,
"line_end": 115,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 115,
"line_end": 119,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 119,
"line_end": 123,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 123,
"line_end": 127,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:127:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 127,
"line_end": 129,
"snippet": "Detailed guidance for complex conversions is in `references/`:"
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 129,
"line_end": 130,
"snippet": "- `references/document-conversions.md` - PDF handling, encoding issues, styling preservation"
},
{
"id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 130,
"line_end": 131,
"snippet": "- `references/data-conversions.md` - Schema handling, type coercion, nested structures"
},
{
"id": "filesystem:SKILL.md:76:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "SKILL.md",
"line_start": 76,
"line_end": 76,
"snippet": "with open(\"output.yaml\", \"w\") as f:"
},
{
"id": "filesystem:SKILL.md:90:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "SKILL.md",
"line_start": 90,
"line_end": 90,
"snippet": "with open(\"output.json\", \"w\") as f:"
},
{
"id": "filesystem:SKILL.md:104:python-file-write-append",
"category": "filesystem",
"severity": "medium",
"pattern": "Python file write/append",
"file": "SKILL.md",
"line_start": 104,
"line_end": 104,
"snippet": "with open(\"output.html\", \"w\") as f:"
}
],
"finding_verdicts": [
{
"id": "filesystem:references/data-conversions.md:33:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
},
{
"id": "filesystem:references/data-conversions.md:67:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
},
{
"id": "filesystem:references/data-conversions.md:100:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
},
{
"id": "filesystem:references/data-conversions.md:135:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
},
{
"id": "filesystem:references/data-conversions.md:155:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
},
{
"id": "sensitive:references/data-conversions.md:35:certificate-key-files",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The word keys refers to dictionary field names for CSV headers, not certificate or private key files. No credential material or key file access appears at this location."
},
{
"id": "blocker:references/document-conversions.md:124:network-reconnaissance",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The command is LibreOffice converting a local DOCX file to PDF. It does not scan networks or perform reconnaissance."
},
{
"id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks mark library or tool names in a Markdown table. No command string, shell execution, or user-controlled interpolation appears at this line."
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks quote local reference paths in Markdown prose. They are documentation formatting and do not execute commands."
},
{
"id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:78:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:96:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The detected backticks are Markdown code fence markers around conversion examples. They are not Ruby backtick execution or shell interpolation."
},
{
"id": "external_commands:SKILL.md:127:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks quote local reference paths in Markdown prose. They are documentation formatting and do not execute commands."
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks quote local reference paths in Markdown prose. They are documentation formatting and do not execute commands."
},
{
"id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks quote local reference paths in Markdown prose. They are documentation formatting and do not execute commands."
},
{
"id": "filesystem:SKILL.md:76:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
},
{
"id": "filesystem:SKILL.md:90:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
},
{
"id": "filesystem:SKILL.md:104:python-file-write-append",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet writes an explicit output file as part of a conversion example. This is expected converter behavior and does not show arbitrary path control or secret access."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 4,
"total_lines": 658,
"audit_model": "codex",
"audited_at": "2026-07-05T12:12:55.063Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Convert Files Between Common Formats",
"value_statement": "Manual file conversion is slow and easy to get wrong. This skill provides focused conversion guidance for documents, data files, and images.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"file converter skill",
"document conversion",
"data format conversion",
"image conversion",
"PDF conversion",
"JSON CSV YAML",
"Python conversion tools"
],
"actual_capabilities": [
"Converts document formats such as PDF, DOCX, Markdown, HTML, and TXT.",
"Converts data formats such as JSON, CSV, YAML, XML, and TOML.",
"Converts image formats such as PNG, JPG, WebP, SVG, and GIF.",
"Selects recommended Python libraries for each source and target format.",
"Provides guidance for encoding, nested data, transparency, and styling issues."
],
"limitations": [
"Some conversions require optional libraries or system tools to be installed.",
"PDF and DOCX styling may not be preserved exactly across formats.",
"Raster to SVG tracing has limited fidelity for photos and complex images.",
"Users should review generated paths before writing converted output files."
],
"use_cases": [
{
"title": "Prepare Client Documents",
"description": "Convert Markdown, DOCX, or HTML into deliverable formats while preserving basic structure.",
"target_user": "Consultants and document authors"
},
{
"title": "Normalize Data Exports",
"description": "Transform JSON, CSV, YAML, XML, or TOML files for analysis, imports, or configuration workflows.",
"target_user": "Data analysts and developers"
},
{
"title": "Adapt Image Assets",
"description": "Convert image files for web delivery, thumbnails, transparency needs, or format compatibility.",
"target_user": "Designers and web teams"
}
],
"prompt_templates": [
{
"title": "Convert One File",
"scenario": "Beginner request for a single file conversion.",
"prompt": "Convert input.md to output.html. Preserve headings, tables, and fenced code blocks where possible."
},
{
"title": "Convert With Format Rules",
"scenario": "Intermediate request with preservation requirements.",
"prompt": "Convert report.docx to Markdown. Preserve headings, lists, bold text, and tables when the source supports them."
},
{
"title": "Normalize Structured Data",
"scenario": "Intermediate data workflow with type handling.",
"prompt": "Convert data.csv to JSON. Infer numbers and booleans, keep empty cells as null values, and report any ambiguous columns."
},
{
"title": "Plan A Batch Conversion",
"scenario": "Advanced workflow for many files and quality constraints.",
"prompt": "Create a safe batch plan to convert all PNG files in input_images to WebP. Use quality 80, preserve transparency, and write outputs to output_images."
}
],
"output_examples": [
{
"input": "Convert a Markdown report to HTML.",
"output": "Created an HTML file with headings, tables, lists, and code blocks preserved where the Markdown parser supports them."
},
{
"input": "Convert a CSV export to JSON.",
"output": "Produced a structured data file, converted numeric values, preserved empty cells, and noted columns that may need review."
},
{
"input": "Convert PNG product images to WebP.",
"output": "Generated WebP images using balanced quality settings and kept transparent areas for compatible source images."
}
],
"best_practices": [
"Confirm the source and target formats before running a conversion.",
"Use a separate output folder when converting many files.",
"Check a small sample before processing large or important files."
],
"anti_patterns": [
"Do not overwrite original files without a backup.",
"Do not assume PDF or DOCX layout will convert perfectly.",
"Do not run generated conversion commands without checking input and output paths."
],
"faq": [
{
"question": "Which file types does this skill cover?",
"answer": "It covers common document, data, and image formats, including PDF, DOCX, Markdown, HTML, JSON, CSV, YAML, XML, TOML, PNG, JPG, WebP, SVG, and GIF."
},
{
"question": "Does it install conversion libraries automatically?",
"answer": "No. It recommends libraries and tools, but the user or agent must install missing dependencies when needed."
},
{
"question": "Can it preserve formatting perfectly?",
"answer": "No. Formatting depends on the formats and libraries used. PDF and DOCX conversions often lose some layout details."
},
{
"question": "Can it handle nested JSON for CSV output?",
"answer": "Yes. The reference guidance explains flattening nested objects and handling arrays before writing CSV output."
},
{
"question": "Can it convert images with transparency?",
"answer": "Yes. It includes guidance for preserving transparency in PNG and WebP, and for handling JPEG backgrounds."
},
{
"question": "Is it safe to use on important files?",
"answer": "Use copies or a separate output directory. Review generated paths before writing output files."
}
]
},
"file_structure": [
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "data-conversions.md",
"type": "file",
"path": "references/data-conversions.md",
"lines": 170
},
{
"name": "document-conversions.md",
"type": "file",
"path": "references/document-conversions.md",
"lines": 140
},
{
"name": "image-conversions.md",
"type": "file",
"path": "references/image-conversions.md",
"lines": 214
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 134
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |