Skip to content

tryflask/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Flask plugin for Claude Code

Flask is the feedback layer for video, built for the agentic loop: your agent uploads a render and shares the link instantly. The reviewer doesn't type - they hit record and talk through the video (voice, camera, screen, drawing on frames), and Flask turns the recording into structured, timestamped comments with transcripts. The agent reads that feedback and iterates, pushing each revision as a new version of the same asset. Typed comments work too - recordings are the advantage, not a requirement.

This plugin connects the Flask MCP server and teaches the agent the full review loop.

Install

One command connects the Flask MCP server (Claude Code, Cursor) and installs the review-loop skill for any agent that reads skills:

npx flask-feedback

Prefer to wire things yourself? Per-client instructions below.

Claude Code

/plugin marketplace add tryflask/skills
/plugin install flask@flask

Then authenticate once: /mcp -> flask -> complete the browser sign-in.

No plugin manager? Connect the MCP server directly:

claude mcp add --transport http flask https://api.flask.do/api/mcp/mcp

Cursor, Codex, and other agents

Install the review-loop skill (works across skills-compatible clients):

npx skills add tryflask/skills

Then connect the MCP server:

  • Cursor: Install MCP Server
  • claude.ai / Claude Desktop: Settings -> Connectors -> add https://api.flask.do/api/mcp/mcp
  • Any MCP client: Streamable HTTP at https://api.flask.do/api/mcp/mcp (OAuth sign-in opens in the browser on first use)

What the agent can do

Tool What it does
contents, search, recent_activity Browse folders/assets, search, latest team feedback
feedback_list, feedback_get Read feedback with tags, timestamps, recording transcripts (transcript: "full" for whole recording)
wait_for_feedback Long-poll - returns new feedback the moment it's left
get_annotated_frames Returns the video frames a recording pointed at / drew on, as images with the drawing rendered in, plus the transcript marked [FRAME N] - resolves "this"/"here"/drawn-circle references to actual pixels
upload_file_start / upload_file_complete Upload a local video (5GB max) via presigned URL; share link available the instant the upload starts
upload_video Import from a public URL or Google Drive link
version_of (param on uploads) Upload as a new version of an existing asset - one stable link for the whole iteration
asset_status, tags, permission_get Processing status, tag distribution, folder access

The server is read-only except for uploads - it can never edit or delete anything.

The loop in practice

agent renders video -> upload_file_start -> user gets flask.do link instantly
user records feedback on the video -> wait_for_feedback returns it (transcribed)
agent implements changes -> uploads v2 with version_of -> same link shows v2

Docs and support

This repo is kept in sync with the MCP server. Tool list and behavior described here mirror https://flask.do/mcp, which is the source of truth.

About

Claude Code plugin for Flask (flask.do) - the feedback layer for agentic video. Upload renders for human review, read transcribed feedback, iterate with versions.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors