Agent skill

Floor Bot Analysis

by fossasia in fossasia/eventyay-interpretation

“Use this skill for floor bot analysis.”

— description from SKILL.md by fossasia
Apache-2.0Auto-check: notesMedia & Creative

Install Floor Bot Analysis

skills CLI
$ npx skills add fossasia/eventyay-interpretation --skill floor-bot-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fossasia/eventyay-interpretation floor-bot-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fossasia/eventyay-interpretation.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/floor-bot-analysis .claude/skills/floor-bot-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
floor-bot-analysis
GitHub stars
1.6k
Token cost
~1k tokens
SKILL.md length
485 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Works in 7 steps: Jitsi Internal URL (JITSI_INTERNAL_BASE) → MediaMTX RTSP Base (MEDIAMTX_RTSP_BASE) → Floor Bot API (FLOOR_BOT_BASE) → …
  • SKILL.md covers Overview of Floor Bot, Local Development vs. Production, Common Debugging Steps and Debugging Commands
  • Calls docker; reaches jitsi.eventyay.com

About this skill

Floor Bot Analysis is a skill in fossasia/eventyay-interpretation (1.6k stars). Its SKILL.md is about 1k tokens. Licence: Apache-2.0.

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Jitsi Internal URL (JITSI_INTERNAL_BASE)
  2. MediaMTX RTSP Base (MEDIAMTX_RTSP_BASE)
  3. Floor Bot API (FLOOR_BOT_BASE)
  4. Bot is Silent / No Audio
  5. Name is "Fellow Jitster"
  6. Connection Refused to Pulse Socket
  7. FFmpeg Demuxing/DTS Loops

What it can do on your machine

Read from SKILL.md and the folder at commit 1ca0139. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • jitsi.eventyay.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Floor Bot Analysis loads about 1k tokens when it runs. Until then it costs about 14 tokens; SKILL.md has 485 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~14
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:28
    , `https://jitsi.eventyay.com`) in your `.env`.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fossasia/eventyay-interpretation at commit 1ca0139, republished under its Apache-2.0 licence (© fossasia). 485 words, ~1,007 tokens.

Download SKILL.mdSave it as .claude/skills/floor-bot-analysis/SKILL.md (or your agent's skills folder).
name
floor-bot-analysis
description
Use this skill for floor bot analysis.

Skill: Floor Bot Analysis

This skill explains how to debug and analyze the Floor Bot feature in VoxBento, which bridges the Jitsi WebRTC audio floor track to the RTSP/MediaMTX infrastructure for transcription.

Overview of Floor Bot

The floor-bot is a headless Playwright/Chromium container that joins the main Jitsi conference room (monitoring the floor channel). It captures the audio and sends it over a PulseAudio socket directly to FFmpeg. FFmpeg then pushes this audio via RTSP to MediaMTX, where the transcription worker pulls it and generates captions.

Key Components
  • floor-bot container: Runs bot.py via an HTTP server. It listens on port 8080 for /start and /stop commands.
  • PulseAudio Socket: /tmp/pulse-{event_slug}.sock acts as the bridge. Chromium outputs to this socket, and FFmpeg reads from it.
  • MediaMTX RTSP Path: Audio is pushed to rtsp://mediamtx:8554/{event_slug}/floor.
  • FastAPI Backend: Admin routes /api/rooms/{room_id}/floor-transcription/start trigger the bot to join the Jitsi room and immediately spawn the transcription worker pointing to the floor channel.

Local Development vs. Production

When deploying this architecture, understanding the network topology is critical.

1. Jitsi Internal URL (JITSI_INTERNAL_BASE)
  • Local: In Docker Compose, the Jitsi service is named jitsi-web. To bypass WebRTC HTTP origin blocking for getUserMedia, the backend automatically replaces localhost or jitsi.voxbento.com with the Docker-internal HTTPS URL: https://jitsi-web. The bot explicitly uses --ignore-certificate-errors and --unsafely-treat-insecure-origin-as-secure=https://jitsi-web.
  • Production: If Jitsi is deployed outside of the docker-compose network (e.g., a standalone public Jitsi cluster), the internal https://jitsi-web hostname will fail. You must set JITSI_INTERNAL_BASE to the public Jitsi URL (e.g., https://jitsi.eventyay.com) in your .env.
2. MediaMTX RTSP Base (MEDIAMTX_RTSP_BASE)
  • Local: Defaults to rtsp://mediamtx:8554 (the container name inside Docker Compose).
  • Production: If MediaMTX is hosted elsewhere, override this via the MEDIAMTX_RTSP_BASE environment variable. Both the floor-bot FFmpeg ingest and the backend transcription worker use this URL.
Show full SKILL.md (196 more words)Show less
3. Floor Bot API (FLOOR_BOT_BASE)
  • Local: Defaults to http://floor-bot:8080.
  • Production: If deployed on a different orchestration layer (like Kubernetes), override FLOOR_BOT_BASE to point to the correct pod/service DNS.

Common Debugging Steps

1. Bot is Silent / No Audio

Check if Playwright is muting the browser. Ensure --ignore_default_args=["--mute-audio"] is being passed. Also verify if the Jitsi UI is trying to acquire mic permissions and failing: Ensure --use-fake-device-for-media-stream is used.

2. Name is "Fellow Jitster"

Jitsi expects URL parameters (like userInfo.displayName) to be valid JSON strings. Ensure the display name is properly quote-wrapped and URL encoded: urllib.parse.quote('"VoxBento FloorBot"') -> %22VoxBento%20FloorBot%22.

3. Connection Refused to Pulse Socket

Ensure PULSE_SERVER="unix:/tmp/pulse-{event_slug}.sock" is properly passed to the Playwright chromium browser using the env= dictionary.

4. FFmpeg Demuxing/DTS Loops

If FFmpeg reports loop/sync errors (Non-monotonous DTS), check the sample rate constraints in Jitsi vs Chromium vs FFmpeg.

Debugging Commands

Tail the Floor Bot Logs: docker compose logs -f floor-bot

Check PulseAudio Connections inside Floor Bot: docker compose exec floor-bot sh -c 'PULSE_SERVER="unix:/tmp/pulse-{event_slug}.sock" pactl list sink-inputs' (If the browser is outputting audio correctly, you will see 'Chromium' listed as a client).

Check FFmpeg/MediaMTX Streaming: docker compose logs -f mediamtx (Look for: [path {event_slug}/floor] stream is online)

© fossasia, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/floor-bot-analysis of fossasia/eventyay-interpretation.

Open the folder on GitHubat commit 1ca0139

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in fossasia/eventyay-interpretation, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Floor Bot Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Floor Bot Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Floor Bot Analysis this skillfossasia/eventyay-interpretation1.6k—~1kAutomated safety check: NotesApache-2.0
Setup Mulmoclaudereceptron/mulmoclaude368—~1kAutomated safety check: NotesMIT
Video Clip Repurposingpawbytes/skill-suites113—~1.2kAutomated safety check: PassMIT
Vhs Demobabarot/gh-infra136—~1.2kAutomated safety check: PassMIT
Remotion Best Practiceslyonjs/shortvid.io14733 repos~1kAutomated safety check: PassMIT
HyperFrames Video Entry Pointheygen-com/hyperframes59k3 repos~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Setup Mulmoclaude

    receptron/mulmoclaude

    Interactively guide MulmoClaude setup following README instructions.

    368 GitHub stars~1k tokensUpdated today
    Media & CreativeAuto-check: notes
  • Video Clip Repurposing

    pawbytes/skill-suites

    Cuts long-form video into short platform-ready clips: finds strong moments, reframes for vertical, adds subtitles and brand overlays, and writes a clip manifest.

    113 GitHub stars~1.2k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Vhs Demo

    babarot/gh-infra

    A skill your agent uses when running demo recordings, diagnosing recording failures, or regenerating GIFs from existing MP4s.

    136 GitHub stars~1.2k tokensUpdated 10 days ago
    DevOps & CloudAuto-check passed
  • Remotion Best Practices

    lyonjs/shortvid.io

    Best practices for Remotion - Video creation in React. An agent skill from lyonjs/shortvid.io.

    147 GitHub starsUsed in 33 repos~1k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    59k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Vox Director

    Alisa0808/vox-director

    Turn ONE topic into a finished Vox-style paper-collage explainer / ad video, end to end on the Atlas Cloud API + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all…

    2.2k GitHub stars~5.6k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed

More from fossasia/eventyay-interpretation

All 38 skills in this repo
  • Git Guardrails Claude Code

    fossasia/eventyay-interpretation

    Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute.

    1.6k GitHub starsUsed in 12 repos~578 tokens
    Auto-check passed
  • Diagnosing Bugs

    fossasia/eventyay-interpretation

    Diagnosis loop for hard bugs and performance regressions. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 32 repos~2.1k tokens
    Auto-check passed
  • Domain Modeling

    fossasia/eventyay-interpretation

    Build and sharpen a project's domain model. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 31 repos~821 tokens
    Auto-check passed
  • Improve

    fossasia/eventyay-interpretation

    Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute.

    1.6k GitHub starsUsed in 10 repos~3.7k tokens
    Auto-check: warnings
  • Migrate To Shoehorn

    fossasia/eventyay-interpretation

    Migrate test files from as type assertions to @total-typescript/shoehorn.

    1.6k GitHub starsUsed in 12 repos~698 tokens
    Auto-check passed
  • Setup Pre Commit

    fossasia/eventyay-interpretation

    Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo.

    1.6k GitHub starsUsed in 12 repos~565 tokens
    Auto-check passed

Works with

Questions about Floor Bot Analysis

How do I install Floor Bot Analysis in Claude Code?

Run `npx skills add fossasia/eventyay-interpretation --skill floor-bot-analysis -a claude-code`. Or copy the skill folder (.agents/skills/floor-bot-analysis in fossasia/eventyay-interpretation) into .claude/skills/floor-bot-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Floor Bot Analysis in Codex?

Run `npx skills add fossasia/eventyay-interpretation --skill floor-bot-analysis -a codex`. Or copy the skill folder (.agents/skills/floor-bot-analysis in fossasia/eventyay-interpretation) into .agents/skills/floor-bot-analysis in your project. Codex loads it when a task matches its description.

Can I use Floor Bot Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fossasia/eventyay-interpretation --skill floor-bot-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/floor-bot-analysis, .gemini/skills/floor-bot-analysis, .github/skills/floor-bot-analysis and .opencode/skills/floor-bot-analysis in your project.

What does Floor Bot Analysis need to run?

Going by SKILL.md and its folder, Floor Bot Analysis needs the command-line tools its instructions call (docker).

Does Floor Bot Analysis access the network?

SKILL.md names 1 domain. In commands or code: jitsi.eventyay.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Floor Bot Analysis safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Floor Bot Analysis use?

Floor Bot Analysis is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Floor Bot Analysis use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Floor Bot Analysis?

Skills that share tags, products or a category with Floor Bot Analysis: Setup Mulmoclaude (receptron/mulmoclaude, 368 stars), Video Clip Repurposing (pawbytes/skill-suites, 113 stars), Vhs Demo (babarot/gh-infra, 136 stars) and Remotion Best Practices (lyonjs/shortvid.io, 147 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Floor Bot Analysis?

fossasia (a GitHub organization) maintains it in fossasia/eventyay-interpretation, which has 1,551 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on October 5, 2026.

Source: fossasia/eventyay-interpretation on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.