<< All versions
Skill v1.0.0
currentAutomated scan100/100eclaire-labs/eclaire/media-guide
──Details
PublishedApril 28, 2026 at 12:21 PM
Content Hashsha256:1972b92737e8794c...
Git SHA1c14911265da
──Files
Files (1 file, 3.2 KB)
SKILL.md3.2 KBactive
SKILL.md · 68 lines · 3.2 KB
version: "1.0.0" name: media-guide description: Help users understand media capabilities including audio/video import, processing, transcription, and organization. alwaysInclude: false tags: [media, audio, video, help]
Media Guide
What is Media in Eclaire?
Media items are audio and video files stored in Eclaire. They can be uploaded directly or imported from URLs (YouTube, Vimeo, SoundCloud, and many other platforms).
How Media Gets Into Eclaire
There are two ways to add media:
- File Upload — Users upload audio/video files through the UI. Supported formats include MP3, MP4, WAV, FLAC, OGG, WebM, M4A, AAC, and more.
- URL Import — Provide a URL and Eclaire downloads the media automatically. This works with:
- YouTube videos
- Vimeo videos
- SoundCloud tracks
- Direct file URLs (e.g., podcast RSS links, hosted MP3/MP4 files)
- Many other platforms supported by yt-dlp
Processing Pipeline
After media is added, a background worker processes it:
- Download (for URL imports) — The file is downloaded and stored
- Metadata Extraction — Duration, codec, bitrate, sample rate, resolution (video), etc.
- Thumbnail Generation — A visual thumbnail for video, waveform image for audio
- Transcription — Speech-to-text extraction of spoken content (3-tier: platform captions, embedded subtitles, then Whisper STT)
- AI Tagging — Automatic description, tags, and category based on transcript content
Processing happens in the background and may take a few minutes depending on file size and duration.
What You Can Do With Media
As an assistant, you can:
- Search media — Find audio/video by text (searches titles, descriptions, and transcripts), tags, media type, and date range
- View details — Get full metadata, transcript, processing status, and tags for any media item
- Count media — Check how many audio or video items match criteria
- Update metadata — Change title, description, tags, due date, review status, flag color, or pin status
- Delete media — Remove media items and their stored files (requires user confirmation)
- Import from URL — Import new media from a URL (requires user confirmation)
- Preview URLs — Check what a URL contains (title, duration, uploader, type) before importing
Organization Features
Media items support the same organization features as other content types:
- Tags — Apply multiple tags for categorization
- Review Status — pending, accepted, or rejected (for inbox triage)
- Flags — Color-coded flags (red, yellow, orange, green, blue)
- Pins — Pin important items
- Due Dates — Set deadlines for time-sensitive media
Tips for Helping Users
- Use
getMediaInfobeforeimportMediaUrlto preview what a URL contains — this helps avoid importing unwanted content - After importing, tell users that processing happens in the background
- Use
findContentwithtypes: ["media"]andmediaType: "audio"ormediaType: "video"to narrow searches - The transcript text is searchable via the
textparameter infindContent - If a user asks about a specific media item's transcript, use
getMediato retrieve it — theextractedTextfield contains the transcript