Agent skill

Repo Navigation

by fossasia in fossasia/eventyay-interpretation

A skill your agent uses to find files, understand module ownership, and locate code in VoxBento.

Apache-2.0Auto-check passedBackend & APIs

Install Repo Navigation

skills CLI
$ npx skills add fossasia/eventyay-interpretation --skill repo-navigation -a claude-code

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

GitHub CLI
$ gh skill install fossasia/eventyay-interpretation repo-navigation --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/repo-navigation .claude/skills/repo-navigation && 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
repo-navigation
GitHub stars
1.6k
Token cost
~1k tokens
SKILL.md length
331 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses to find files, understand module ownership, and locate code in VoxBento.

  • Works in 5 steps: **Routes are split into sub-modules in… → Admin routes all start with /admin/ and… → WebSocket handlers are _handle_join,… → …
  • Understand module ownership
  • SKILL.md covers Module Map (Quick Reference), Test File Map, Searching Effectively and File Size Guide, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Repo Navigation is an agent skill from fossasia/eventyay-interpretation. Use this skill to find files, understand module ownership, and locate code in VoxBento.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. The repository describes itself as: A plugin for live interpretation of video streams. The licence is Apache-2.0.

When your agent uses it

  • Understand module ownership
  • Locate code in VoxBento

Example prompts

  • “/repo-navigation”

Requirements

  • Docker

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. **Routes are split into sub-modules in portal/routers/.
  2. Admin routes all start with /admin/ and use dependencies=[Depends(require_admin)].
  3. WebSocket handlers are _handle_join, _handle_leave, _handle_chat, _handle_set_active, _handle_update_state — all in…
  4. The in-memory booths variable is a module-level BoothRegistry() instance in portal/booth_state.py — the only source of live booth state.
  5. Templates inherit from templates/base.html (user pages) or templates/admin/base.html (admin pages).

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    No URLs in SKILL.md.

    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

Repo Navigation loads about 1k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 331 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
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 passed

The automated check found no risky patterns in SKILL.md.

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). 331 words, ~1,045 tokens.

Download SKILL.mdSave it as .claude/skills/repo-navigation/SKILL.md (or your agent's skills folder).
name
repo-navigation
description
Use this skill to find files, understand module ownership, and locate code in VoxBento.

Skill: Repo Navigation

Use this skill to find files, understand module ownership, and locate code in VoxBento.


Module Map (Quick Reference)

What you're looking forWhere to look
Route definition for any URLportal/routers/ — search for @router.get, @app.post, @app.websocket
Auth logic (JWT, cookies, role)portal/auth.py
Booth state / participant logicportal/booth_state.py
Database models (table schema)portal/models.py
Database CRUD helpersportal/database.py
Booth ID / MediaMTX path mathportal/booth_identity.py
Role permissionsportal/roles.py
App settings / env varsportal/config.py
API key encryption / decryptionportal/crypto.py
Transcription provider logicportal/transcription/providers/{provider}.py
Worker lifecycle (start/stop)portal/transcription/worker.py
Caption aggregationportal/transcription/aggregator.py
Interpreter UI (JS)static/js/interpreter-booth.js
Listener WHEP client (JS)static/js/whep-listener.js
Admin JSstatic/js/admin.js
HTML templatestemplates/ (base, booth, listener, auth) + templates/admin/
DB migrationsalembic/versions/001_*.py through 008_*.py
MediaMTX configurationmediamtx.yml
Docker servicesdocker-compose.yml
Teststests/ — see test file map below

Test File Map

Test fileWhat it covers
tests/conftest.pyanyio fixture, sys.path setup
tests/test_fastapi_app.pyHTTP routes, auth flows, page renders
tests/test_booth_state.pyBoothRegistry in-memory logic
tests/test_booth_identity.pymake_booth_id, make_mediamtx_path, validation
tests/test_database.pyCRUD helpers with in-memory SQLite
tests/test_database_e2e.pyEnd-to-end database flows
tests/test_admin_panel.pyAdmin route auth and operations
tests/test_roles.pyPermission enum, ROLE_PERMISSIONS
tests/test_crypto.pyencrypt_val / decrypt_val
tests/test_user_auth.pyRegistration, login, user token
tests/test_join_flow.pyInvite token redemption → JWT cookie
tests/test_memberships_tokens.pyMembership and token CRUD
tests/test_transcription_concurrency.pyWorker start/stop, concurrency limits
tests/docker_e2e_test.pyFull Docker stack smoke tests
tests/verify_persistence.pyDB persistence checks

Searching Effectively

Find all routes
bash
grep -rn "@router\." portal/routers/
Find where a WS message type is handled
bash
grep -rn "booth:join\|booth:chat\|booth:set-active" portal/websockets/
Find all settings
bash
grep -rn "settings\." portal/ | head -40
bash
grep -rn "session_token\|user_token\|admin_token" portal/routers/
Find where a DB model is used
bash
grep -rn "DBBooth\|InviteToken\|BoothMembership" portal/

File Size Guide

File~LinesComplexity
portal/routers/VariousHigh
portal/database.py~400Medium
portal/models.py~250Medium
portal/booth_state.py~300Medium
portal/auth.py~230Medium
static/js/interpreter-booth.js~900High — use search
portal/transcription/worker.py~130Low
portal/transcription/aggregator.py~120Low

Navigation Tips

  1. **Routes are split into sub-modules in portal/routers/.
  2. Admin routes all start with /admin/ and use dependencies=[Depends(require_admin)].
  3. WebSocket handlers are _handle_join, _handle_leave, _handle_chat, _handle_set_active, _handle_update_state — all in portal/websockets/handlers.py.
  4. The in-memory booths variable is a module-level BoothRegistry() instance in portal/booth_state.py — the only source of live booth state.
  5. Templates inherit from templates/base.html (user pages) or templates/admin/base.html (admin pages).

© 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/repo-navigation 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

Repo Navigation 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.

Repo Navigation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repo Navigation this skillfossasia/eventyay-interpretation1.6k—~1kAutomated safety check: PassApache-2.0
Gemini Live API Devgoogle-gemini/gemini-skills4.3k—~4.6kAutomated safety check: PassApache-2.0
Media over QUICmoq-dev/moq1.6k—~460Automated safety check: PassApache-2.0
Deepgram Python Speech-to-Textdeepgram/deepgram-python-sdk469—~2.9kAutomated safety check: PassMIT
Grok Imaginenikships/droidproxy122—~2.2kAutomated safety check: PassMIT
Accountsonilo-ai/skills115—~1.4kAutomated safety check: NotesMIT

Similar skills

  • Gemini Live API Dev

    google-gemini/gemini-skills

    Official

    A skill your agent uses when building real-time, bidirectional streaming applications with the Gemini Live API, or migrating legacy Live models (2.0/2.5/3.1) to Gemini 3.8 Live.

    4.3k GitHub stars~4.6k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Media over QUIC

    moq-dev/moq

    Build live video, audio, and real-time data apps with Media over QUIC (MoQ). Use when adding live streaming, conferencing, voice AI, or real-time pub/sub to…

    1.6k GitHub stars~460 tokensUpdated today
    Backend & APIsAuto-check passed
  • Deepgram Python Speech-to-Text

    deepgram/deepgram-python-sdk

    Covers basic transcription with the Deepgram Python SDK's listen.v1 endpoint, for one-shot REST transcription of a file or URL and live WebSocket streaming with interim results.

    469 GitHub stars~2.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Grok Imagine

    nikships/droidproxy

    Generate or edit images via Grok Imagine Image 2.0 through DroidProxy (no XAIAPIKEY).

    122 GitHub stars~2.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Account

    sonilo-ai/skills

    Check the Sonilo account's available services, rate limits, free-trial allowance, and usage/billing history.

    115 GitHub stars~1.4k tokensUpdated 2 days ago
    Backend & APIsAuto-check: notes
  • Runpod

    digitalsamba/claude-code-video-toolkit

    Cloud GPU processing via RunPod serverless. An agent skill from digitalsamba/claude-code-video-toolkit.

    2.2k GitHub stars~2.1k tokensUpdated yesterday
    Backend & APIsAuto-check: notes

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 30 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

Questions about Repo Navigation

What does Repo Navigation do?

A skill your agent uses to find files, understand module ownership, and locate code in VoxBento. Repo Navigation is an agent skill from fossasia/eventyay-interpretation. Use this skill to find files, understand module ownership, and locate code in VoxBento.

When should I use Repo Navigation?

Repo Navigation fits situations like: understand module ownership; locate code in VoxBento.

How do I install Repo Navigation in Claude Code?

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

How do I install Repo Navigation in Codex?

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

Can I use Repo Navigation 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 repo-navigation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repo-navigation, .gemini/skills/repo-navigation, .github/skills/repo-navigation and .opencode/skills/repo-navigation in your project.

What does Repo Navigation need to run?

SKILL.md names no scripts, command-line tools or credentials: Repo Navigation is instructions for the agent only. Our summary lists: Docker.

Does Repo Navigation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Repo Navigation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Repo Navigation use?

Repo Navigation 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 Repo Navigation use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Repo Navigation?

Skills that share tags, products or a category with Repo Navigation: Gemini Live API Dev (google-gemini/gemini-skills, 4.3k stars), Media over QUIC (moq-dev/moq, 1.6k stars), Deepgram Python Speech-to-Text (deepgram/deepgram-python-sdk, 469 stars) and Grok Imagine (nikships/droidproxy, 122 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repo Navigation?

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.