Hamel Tools

hamel-tools Plugin

CLI tools for processing YouTube videos, Zoom recordings, and newsletters.

Installation

Claude Code

# Add the marketplace
/plugin marketplace add hamelsmu/hamel

# Install the plugin
/plugin install hamel-tools@hamel

Amp

amp skill add hamelsmu/hamel

Or use the command palette: /skill-add hamelsmu/hamel

Prerequisites

Install the CLI tools:

pip install hamel

Required environment variables:

Variable	Required for
GEMINI_API_KEY	youtube (chapters), annotate-talk, gem
KIT_API_KEY	kit
JINA_READER_KEY	annotate-talk
ZOOM_CLIENT_ID, ZOOM_CLIENT_SECRET, ZOOM_ACCOUNT_ID	zoom
X_BEARER_TOKEN	xapi (resolve, fetch, diff, latest-post, likes, bookmarks)
X_ACCESS_TOKEN	xapi (likes, bookmarks — OAuth 2.0 user access token)
X_REFRESH_TOKEN	xapi (optional — for future token refresh support)
X_DEFAULT_USERNAME	xapi (optional — override default username for likes/bookmarks, default: HamelHusain)

Available Skills

Skill	Description
youtube	YouTube channel management: upload, list, edit, schedule, download, transcribe, chapters
annotate-talk	Create annotated blog posts from technical talks
gem	Multimodal Gemini API for PDFs, images, videos, and image generation
kit	Manage Kit/ConvertKit newsletter broadcasts
zoom	Process Zoom transcripts and office hours Q&A
x	Unified X (Twitter) CLI (xapi) — follows, likes, bookmarks, screenshots (Bearer Token auth)

Local Development

Test without publishing:

# Claude Code
claude --plugin-dir /path/to/plugins/hamel-tools

# Amp
amp --skill-dir /path/to/plugins/hamel-tools/skills

Validate the plugin:

claude plugin validate ./plugins/hamel-tools