markdown-provenance - SKILL.md Agent Skill

name: markdown-provenance description: Internal skill for uploading markdown to Arweave. Invoked only via /markdown-provenance command.

Upload markdown content to Arweave's permanent, decentralized storage network with proper metadata tags. Returns a viewblock.io transaction URL and logs all uploads locally.

SECURITY: This skill should ONLY be invoked via the explicit /markdown-provenance slash command, never automatically based on conversation context.

1. Ensure MP_WALLET_PATH environment variable points to wallet.json 2. Run the upload script with the markdown file path

cd "${CLAUDE_PLUGIN_ROOT}"
npm run upload path/to/file.md

## Step 1: Confirm User Intent

Before uploading, confirm the user explicitly requested this via /markdown-provenance command. Never auto-trigger based on conversation about Arweave or permanent storage.

Step 2: Check Environment

Verify MP_WALLET_PATH is set:

echo $MP_WALLET_PATH

If not set, guide user through wallet setup:

# Generate wallet
npx -y arweave wallet generate > wallet.json

# Set environment variable (add to ~/.zshrc or ~/.bashrc)
export MP_WALLET_PATH="/path/to/wallet.json"
export MP_AUTHOR="Your Name"  # Optional

Step 3: Upload File

Execute the upload script:

cd "${CLAUDE_PLUGIN_ROOT}"
npm run upload <file-path>

Step 4: Report Results

Share with user:

ViewBlock URL for the transaction
Direct Arweave URL
IPFS CID of the content
Confirmation that transaction was logged to ~/.markdown-provenance/transactions.jsonl

The following tags are automatically added to each upload:

Tag	Value
Content-Type	text/markdown
App-Name	Markdown Provenance
App-Version	0.0.1
Type	Attestation
IPFS-CID	(calculated from content)
Author	(from MP_AUTHOR env var or --author flag, if set)
File-Name	(from --fileName flag, if set)
Source	(from --source flag, if set)

- Transaction ID returned from Arweave - viewblock.io URL displayed to user - Transaction logged to ~/.markdown-provenance/transactions.jsonl - All required tags applied (App-Name, App-Version, Content-Type, Type, IPFS-CID) If MP_WALLET_PATH not set: - Direct user to README.md wallet setup section - Provide quick setup commands shown above

If wallet file not found:

Verify path is correct
Check file permissions

If upload fails with network error:

Suggest retry
Check internet connection

If upload fails with insufficient funds (files >100KB):

Files under 100KB are FREE via Turbo
For larger files, direct user to fund wallet with AR tokens
Get wallet address: npx arweave wallet address wallet.json