read-craft

Return the Markdown for a public Craft share link. This skill is transport only: it never writes, appends, or edits files. Deciding where the Markdown should live is a separate concern (see the craft-to-agents skill for one such destination).

Workflow

Run scripts/fetch.py beside this file:

python3 "<skill-dir>/scripts/fetch.py" "https://example.craft.me/SHARE_ID"   # Markdown to stdout
python3 "<skill-dir>/scripts/fetch.py" "CRAFT_URL" --json                    # Markdown + metadata
python3 "<skill-dir>/scripts/fetch.py" "CRAFT_URL" --raw                     # raw Craft share JSON

--json prints {"url", "host", "share_id", "markdown"} so callers can record the canonical source link and derive a stable block name without re-parsing the URL. On failure it exits nonzero and prints nothing to stdout.