markdown-provenance

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.

<quick_start>

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

</quick_start>

## 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

<tags_applied> 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)
</tags_applied>

<success_criteria>

• 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) </success_criteria>

<error_handling> 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 </error_handling>