Communitygithub.com

Jo5i4swastaken/Skills-Locker

Agent Media OS – löse jede Medienanforderung (Hintergrundmusik, Soundeffekte, Bilder, Symbole) in eine lokale Datei und einen Ledger-Eintrag auf. Ein Befehl (`resolve`) deckt die gesamte Kaskade ab – Projekt-Cache, globaler Cache, HeyGen-Katalogdurchsuchung, Einfrieren, Registrieren. Hält Suchrauschen auf der Platte und gibt dem Agenten einen Pfad zurück. Verwende dies, wenn eine Komposition Hintergrundmusik, Soundeffekte, Bilder oder Symbole benötigt.

Was ist Skills-Locker?

media-use ist ein Skill, der es KI-Agenten (z. B. Claude Code) ermöglicht, Medienanforderungen wie Hintergrundmusik, Soundeffekte, Bilder oder Symbole automatisiert aufzulösen. Der Agent ruft einfach den Befehl `resolve` auf, und der Skill durchsucht den HeyGen-Katalog, lädt den besten Treffer herunter, speichert ihn lokal und registriert ihn in einem Manifest. Unterstützte Plattformen sind alle, die das Ausführen von Node.js-Skripten erlauben, insbesondere aber CLI-basierte Agenten wie Claude Code oder Codex. Der Skill nutzt einen mehrstufigen Cache (Projekt-Cache, globaler Cache) und die HeyGen-CLI zur Katalogabfrage. Ergebnis ist eine einzige Zeile mit Pfad und Metadaten – das gesamte Suchrauschen bleibt auf der Festplatte. Damit eignet sich der Skill perfekt für die Erstellung von Multimedia-Präsentationen, Videos oder interaktiven Inhalten, bei denen schnell und ohne manuelle Suche passende Medien eingebunden werden müssen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jo5i4swastaken/Skills-Locker/tree/HEAD/skills/media-use

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

media-use

Löse Medienanforderungen in lokale Dateien auf. Ein Befehl, vier Typen, null Kontextrauschen.

Wann verwenden

Rufe resolve immer dann auf, wenn eine Komposition Medien benötigt – Hintergrundmusik, Soundeffekte, Bilder oder Symbole. media-use durchsucht den HeyGen-Katalog, lädt den besten Treffer herunter, friert ihn lokal ein und registriert ihn in einem Manifest. Der Agent bekommt eine Zeile zurück; das gesamte Suchrauschen bleibt auf der Platte.

Resolve

node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>

Gibt eine Zeile zurück: resolved <id> → <path> (<type>, <metadata>)

Typen

TypFindetAnbieter
bgmHintergrundmusikHeyGen-Audiokatalog (10.000+ Titel)
sfxSoundeffekteGebündelte 19-Datei-Bibliothek + HeyGen-Katalog
imageFotos, HintergründeHeyGen-Assetsuche (75.000+ Vektoren)
iconSymbole, LogosHeyGen-Assetsuche (Typ=icon)

Beispiele

# Hintergrundmusik
node <SKILL_DIR>/scripts/resolve.mjs --type bgm --intent "upbeat tech launch" --project .
# → resolved bgm_001 → .media/audio/bgm/bgm_001.mp3 (bgm, 25s)

# Soundeffekt
node <SKILL_DIR>/scripts/resolve.mjs --type sfx --intent "whoosh" --project .
# → resolved sfx_001 → .media/audio/sfx/sfx_001.mp3 (sfx, 0.57s)

# Bild
node <SKILL_DIR>/scripts/resolve.mjs --type image --intent "gradient tech background" --project .
# → resolved image_001 → .media/images/image_001.jpg (image)

# Symbol
node <SKILL_DIR>/scripts/resolve.mjs --type icon --intent "rocket" --project .
# → resolved icon_001 → .media/images/icon_001.png (icon, transparent)

Flags

FlagBeschreibung
--type, -tMedientyp: bgm, sfx, image, icon
--intent, -iWas du brauchst (natürliche Sprache)
--entity, -eEntitätsname für Cache-Abgleich (optional)
--project, -pProjektverzeichnis (Standard: .)
--adoptBulk-Import vorhandener Assets/ in Manifest
--jsonJSON-Ausgabe statt einzeiligem Ergebnis

Funktionsweise

  1. Prüfe Projekt .media/manifest.jsonl auf exakte Prompt-Übereinstimmung
  2. Durchsuche vorhandenes assets/-Verzeichnis nach nicht registrierten Dateien, die zur Anforderung passen
  3. Prüfe globalen Cache ~/.media/ auf wiederverwendbares Asset
  4. Suche über Anbieter (HeyGen-Audiokatalog, HeyGen-Assetsuche)
  5. Friere Datei nach .media/<type>/ ein, registriere im Manifest, generiere index.md neu

Der Agent bekommt eine Zeile zurück. Kandidaten, Bewertungen, Herkunft bleiben auf der Platte.

Vorhandene Projekte übernehmen

Die meisten HyperFrames-Projekte haben bereits Assets in assets/. media-use übernimmt sie:

node <SKILL_DIR>/scripts/resolve.mjs --adopt --project .
# → adopted 9 assets from assets/
#   bgm_001 → assets/bgm/mango-fizz.mp3 (bgm, 146.6s)
#   image_001 → assets/images/avatar.jpg (image, 400×400)

ffprobe extrahiert echte Dauer und Abmessungen. Während resolve werden nicht registrierte Dateien in assets/, die zur Absicht passen, spontan übernommen.

Bestand einsehen

Nach resolve oder adopt lies .media/index.md für den vollständigen Bestand:

# .media · 4 assets

id         type   dur   dims       path                          description
bgm_001    bgm    25s   —          .media/audio/bgm/bgm_001.mp3  upbeat tech launch
sfx_001    sfx    0.6s  —          .media/audio/sfx/sfx_001.mp3  whoosh
image_001  image  —     1920×1080  .media/images/image_001.jpg   gradient tech background
icon_001   icon   —     200×200    .media/images/icon_001.png    rocket

Projektübergreifende Wiederverwendung

Assets werden beim Auflösen automatisch zwischengespeichert. Nachfolgende Auflösungen für denselben Prompt treffen den globalen Cache unter ~/.media/ – kein erneuter Download, kein Provider-Aufruf. Werbe ein Asset explizit mit organize --promote <id>, um es projektübergreifend wiederverwendbar zu machen.

Dateien

  • .media/manifest.jsonl – maschinelle Single Source of Truth, ein JSON-Eintrag pro Zeile
  • .media/index.md – agentenlesbare Tabelle (id, type, dur, dims, path, description)
  • ~/.media/ – globaler Cache für projektübergreifende Wiederverwendung (content-addressed, SHA-256)

Verwendete CLI-Werkzeuge

WerkzeugZweckErforderlich?
ffprobeDauer, Abmessungen, Codec beim Übernehmen ermittelnJa
heygenAudiokatalog, AssetsucheFür Anbieter

Installiere die heygen-CLI (einzelne statische Binärdatei, keine Laufzeit) und authentifiziere dich:

curl -fsSL https://static.heygen.ai/cli/install.sh | bash   # installiert neueste Version nach ~/.local/bin
heygen update                                               # falls bereits installiert: benötigt >= v0.1.6
export HEYGEN_API_KEY=<your-key>                            # oder: heygen auth login --key <key>

Erfordert heygen >= v0.1.6 – die Anbieter versehen Anfragen mit dem zugelassenen Flag --headers 'X-HeyGen-Client-Source: media-use', das in v0.1.6 hinzugefügt wurde. asset search ist ein Vorab-Befehl, der in heygen --help versteckt ist, aber läuft. Ohne heygen im PATH (oder einen gültigen Schlüssel) geben die Anbieter eine einzeilige Diagnose an stderr aus und die Auflösung fällt auf „kein Anbieter konnte auflösen" zurück.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Jo5i4swastaken/Skills-Locker

Implements the "100% Retrieval Strategy" by Vercel. Injects a compressed docs index into AGENTS.md/CLAUDE.md to guarantee the agent always uses your global skills and best practices.

Jo5i4swastaken/Skills-Locker

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Jo5i4swastaken/Skills-Locker

Rewrite text to make ideas and sentences clearer and easier to understand. Use when the user wants to simplify prose, untangle a tangled sentence, reduce jargon, sharpen vague claims, or make writing accessible to a wider audience. Works on any text: docs, emails, blog posts, reports, marketing copy, slide bullets, academic prose. TRIGGER on phrases like: "make this clearer", "clarify this", "simplify this", "rewrite for clarity", "plain language", "reduce jargon", "make it easier to understand", "untangle this", "explain this simply", "tighten this up", "make this readable". Returns the rewritten text only — no diff, no commentary.

Jo5i4swastaken/Skills-Locker

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Jo5i4swastaken/Skills-Locker

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

Jo5i4swastaken/Skills-Locker

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Jo5i4swastaken/Skills-Locker

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.

Jo5i4swastaken/Skills-Locker

Author a HyperFrames slideshow composition — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching sequences, and hotspot navigation. Use as an intent check when the user asks for a presentation, pitch deck, slide deck, interactive deck, or page-to-deck conversion that might be a slideshow; if the user did not explicitly ask for a slideshow / slide show, confirm before authoring.

Jo5i4swastaken/Skills-Locker

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' 'find people asking for,' 'carousel,' 'slide-by-slide,' or 'document post.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see content-strategy. For paid ads, see ad-creative. For earned media, see public-relations.

Jo5i4swastaken/Skills-Locker

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

Jo5i4swastaken/Skills-Locker

Watch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.

Verwandte Skills