documentation-asset-manager

Upload documentation images to Cloudflare R2 and generate AI captions.

1|1|Updated Jan 6, 2025
One-click install
npx skills add https://github.com/tallyfy/documentation --skill documentation-asset-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-asset-manager
Source: https://github.com/tallyfy/documentation/tree/main/.claude/skills/documentation-asset-manager
Command: npx skills add https://github.com/tallyfy/documentation --skill documentation-asset-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pillow, requests, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the management of Tallyfy documentation assets on Cloudflare R2, including image uploads, AI caption generation, and a CSV inventory.

Core Features & Use Cases

  • Upload assets to Cloudflare R2 bucket (screenshots) and return public URLs for embedding in docs.
  • Generate AI captions (alt text, descriptive, seo) using Claude Code native vision to improve accessibility and searchability.
  • Maintain a master inventory CSV at $GITHUB_ROOT/documentation/documentation_assets.csv.
  • Build-time integration: auto-injects alt text during Starlight documentation builds.
  • Track asset usage across documentation files and enable batch operations for large asset collections.

Quick Start

Prerequisites: ensure Cloudflare credentials exist at $GITHUB_ROOT/cloudflare_credentials.json and Python dependencies are installed (pillow, requests). Then run the orchestrator to upload an asset and generate captions: python3 ~/.claude/skills/documentation-asset-manager/scripts/orchestrator.py
--file /path/to/screenshot.png
--key "tallyfy/pro/desktop-light-new-feature.png"
--article-ids "pro-tasks-assign"
--credentials $GITHUB_ROOT/cloudflare_credentials.json

Frequently Asked Questions about documentation-asset-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate image uploads to Cloudflare R2 for documentation assets?

You can automate image uploads to Cloudflare R2 by running a Python orchestrator script with your credentials and file paths. It uploads screenshots to your bucket and returns public URLs for embedding in your documentation.

How do I generate AI alt text for documentation screenshots?

You can generate AI alt text for documentation screenshots using Claude Code native vision. The skill processes your images to produce accessible, descriptive, and SEO-optimized captions automatically.

How does this skill maintain a CSV inventory of documentation assets?

It maintains a CSV inventory by tracking asset usage across documentation files in a master CSV file. It records your uploaded images and their generated metadata to enable batch operations and consistent cataloging.

Does this skill support build-time integration for injecting alt text?

Yes, it supports build-time integration for auto-injecting alt text during Starlight documentation builds. This ensures your generated captions are automatically populated in your documentation output.

What dependencies do I need to run the documentation asset manager?

You need the Python libraries Pillow and Requests installed to run the asset manager. You also need a JSON file containing your Cloudflare credentials at your project's GitHub root directory.

Can I use this to track asset usage across multiple documentation files?

Yes, you can track asset usage across multiple documentation files. The skill maintains a master inventory CSV and supports batch operations to manage large collections of assets effectively.