markdown-provenance

📁 rickmanelius/markdown-provenance 📅 14 days ago
1
总安装量
1
周安装量
#47180
全站排名
安装命令
npx skills add https://github.com/rickmanelius/markdown-provenance --skill markdown-provenance

Skill 文档

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>

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>