Agent integration

Choose a skill or a standalone tool.

The installable skill teaches an agent to use the HTTP API directly. The standalone Python tool is a separate CLI for scripts and structured tool integrations. Neither package depends on the other.

Download skill package Download tool package View tool schema Read API docs

Package

agent-artifact-converter-skill.zip

Includes SKILL.md, Codex metadata, direct HTTP workflows, error guidance, and API examples. It does not call or require the CLI tool.

Tool

aetherlab_convert.py

A separate Python CLI and JSON schema. It validates inputs and responses, reports actionable failures, downloads outputs, and handles PDF Markdown images.

Supported routes

One API for five conversion services.

html_pdf

HTML to PDF

1-30 public HTML URLs return a single PDF.

html_pptx

HTML to PPTX

1-30 public HTML URLs return a PowerPoint deck.

md_docx

Markdown to DOCX

One Markdown, MD, TXT, or text URL returns a Word document.

pdf_md

PDF to Markdown

One text-based PDF returns Markdown and extracted image URLs, with an agent preference for online image URLs or same-directory local files.

spreadsheet_json

Spreadsheet to JSON

One XLSX, XLS, CSV, or TSV URL returns normalized JSON.

Inputs

Tool arguments

feature: One of the five supported feature ids.
files: Public HTTP(S) source URLs.
api_key: Optional when AETHERLAB_API_KEY is set.
pdf_md_image_preference: For PDF to Markdown: online_urls, local_files, or raw.

Output

Response contract

jobId: Unique conversion job id.
feature: The executed conversion feature.
urls: Array of converted file URLs.

Quick start

Install the skill or run the tool independently.

# Codex skill
unzip agent-artifact-converter-skill.zip -d ~/.codex/skills/

# Standalone tool
unzip aetherlab-agent-kit-tool.zip
cd aetherlab-agent-kit-tool
export AETHERLAB_API_KEY="sk_live_xxxxxxxxxxxx"
python aetherlab_convert.py spreadsheet_json https://example.com/model.xlsx

Do not submit confidential, sensitive, regulated, or personal data unless you are authorized to do so and understand that source URLs must be publicly accessible.