Skillget

flow-state

skill
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This project is a plugin marketplace offering two main tools: a skill that converts YouTube videos into structured Markdown notes, and a lightweight IMAP MCP server that allows AI assistants to read, search, and draft replies to emails.

Security Assessment
Overall Risk: Medium. The repository passes light code scans without any dangerous patterns or hardcoded secrets. However, the IMAP server inherently requires access to highly sensitive data (email credentials and inbox contents). The tool mitigates this well by using the OS keychain for credentials and encapsulating email content to prevent context poisoning. The YouTube tool makes external network requests to fetch video data and transcripts.

Quality Assessment
The project is actively maintained, with its most recent push happening today. It is properly licensed under the permissive MIT license and includes comprehensive documentation. The main drawback is its extremely low visibility; having only 7 GitHub stars means the codebase has undergone minimal community scrutiny. Because of this low engagement, latent vulnerabilities or edge-case bugs might be present despite passing the automated checks.

Verdict
Use with caution—the architecture appears secure and well-documented, but the lack of community adoption means you should thoroughly inspect the code before connecting it to your email accounts.
SUMMARY

Flow State - a Claude Plugin Marketplace

README.md

Flow State - a Claude Plugin Marketplace

Youtube to Markdown Skill

Skip the Video - Extract the Knowledge.
Transform streaming content into storagable knowledge as Markdown.
Drop into Obsidian, Notion, or any note-taking system.

  • ✨ TL;DR + structured summary: Core insights with four content specific summarization formats
  • 💎 Hidden Gems: Collects insights that normal summarization loses
  • 🎛️ Modular: Choose output from Everything to Summary only, Transcript only, or Comments only.
  • 🧹 Cleaned transcript: Broken into chapters and paragraphs with topic headings into own file
  • 🏷️ Timestamp links: Jump back to specific moments in the original video from the transcript
  • 💬 Comment analysis: Curates and cross-analyzes comments against the summary

IMAP Stream MCP Server

Your Inbox, Minimal Context.
Lightweight IMAP email client. No destructive operations.

  • 🪶 ~500 tokens vs typical 15,000+ MCP servers - single tool with action dispatcher
  • 📧 Read & search: List, read, and search IMAP folders
  • ✍️ Draft replies: Markdown converted to HTML + plain text alternatives
  • 📎 Attachments: Download for further processing
  • 🔐 Secure: Credentials in OS keychain (or env variables for Docker/CI)
  • 🛡️ Content Safety: Encapsulates email content to avoid context poisoning
  • 🏢 Multi-account: Multiple account support with named switching

Latest Release Highlights

  • youtube-to-markdown v2.7.1
    • Subagent Task prompts now enforce one-line final status output to reduce coordinator context growth
    • No pipeline/script changes; summary/transcript/comments file generation behavior remains unchanged
    • Update flow and existing tests remain valid

Quick Start

Installation

Add the marketplace and install:

/plugin marketplace add vre/flow-state

/plugin install youtube-to-markdown@flow-state
/plugin install imap-stream-mcp@flow-state

Usage

Youtube-to-Markdown:
In your Claude Code:

extract https://www.youtube.com/watch?v=dQw4w9WgXcQ

('get', 'fetch', 'transcript', 'subtitles', 'captions', etc. works too)

IMAP-Stream-MCP:
In your Claude Code:

what email accounts I have?

As you don't have any configured yet, it will show you how to set up.

Documentation

Plugins

Design Guides (deep rationale, references)

Writing Guides (LLM-optimized, condensed)

Examples of Youtube to Markdown Output

All examples are CC-licensed videos with full summary and comment analysis.

Type Summary Links
Tutorial Faro Shuffle Tutorial! transcript · video
Educational Brain: Parts & functions transcript · video
Educational Happiness is all in your mind transcript · video
Tips How to Become a Great Software Developer transcript · video
Tips Sourdough vs Normal Bread transcript · video
Interview Chris Rock on starting standup transcript · video
Interview Interview with Senior JS Developer transcript · comments · video

The Backstory

I have been thinking a while to extract YouTube transcripts into Markdown format for my Obsidian vault. I knew of yt-dlp, but I wanted something more that would clean, format, summarize, analyze etc. LocalLlama was one option but never got the time.. Finally as checking out Claude Code skills in wild I thought that maybe there would be something already Done for Me. Well there was not, but I found one youtube skill to build upon. Four months later I added IMAP email access as well, as I wanted to have email reading and drafting capabilities in Claude Code in lightweight manner.

Many ideas for the future - maybe knowledge work, context management, and productivity tools for Claude Code and beyond. Let's see where this goes and is there time for it..

Development

See DEVELOPMENT.md.

License

MIT, See LICENSE for more information.

Reviews (0)

No results found