Communitygithub.com

YepAPI/skills – Befehlspalette

cmdk-Integration: Cmd+K-Auslöser, Fuzzy-Suche, gruppierte Aktionen, Tastaturnavigation und dynamische Aktionsregistrierung.

Was ist skills – Befehlspalette?

Die Fähigkeit 'YepAPI/skills' implementiert eine vollständige Befehlspalette (Command Palette) für Entwicklerwerkzeuge wie Claude Code, Cursor oder Codex. Sie nutzt die `cmdk`-Bibliothek, die eine zugängliche, performante Fuzzy-Suche mit integriertem Ranking und Hervorhebung von Treffern bietet. Der globale Tastaturkurzbefehl `Cmd+K` (Mac) / `Ctrl+K` (Windows/Linux) öffnet die Palette. Aktionen sind in logische Gruppen unterteilt: Navigation (Seiten), Befehle (Aktionen) und Zuletzt verwendet (die letzten 5–10 Auswahlen, gespeichert in `localStorage`). Die Tastaturnavigation (Pfeiltasten, Enter, Escape) wird vollständig von `cmdk` übernommen. Ein besonderes Merkmal ist die dynamische Aktionsregistrierung: Aktionen können je nach Seitenkontext hinzugefügt werden (z. B. „Diesen Beitrag bearbeiten“ erscheint nur auf Beitragsseiten). Die Implementierung folgt einem React/Next.js-Ansatz mit dem `useEffect`-Hook für den globalen Tastaturlistener und der `useRouter`-Hook für die Navigation. Die Fähigkeit ist plattformunabhängig und kann in jede moderne Webanwendung integriert werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/command-palette

In Ihrer bevorzugten KI fragen

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

Dokumentation

Befehlspalette

Regeln

  • Verwende die Bibliothek cmdk – zusammensetzbar, zugänglich, schnelle integrierte Fuzzy-Suche
  • Auslöser: Cmd+K (Mac) / Ctrl+K (Windows/Linux) – registriere einen globalen Tastaturlistener
  • Gruppiere Aktionen: Navigation (Seiten), Befehle (Aktionen), Zuletzt verwendet (letzte Auswahlen) – zeige Gruppenüberschriften
  • Tastaturnavigation: Pfeiltasten zum Bewegen, Enter zum Auswählen, Escape zum Schließen – alles von cmdk übernommen
  • Fuzzy-Suche: cmdk filtert automatisch – Trefferhervorhebung mit bewertungsbasiertem Ranking
  • Zuletzt verwendete Elemente: speichere die letzten 5–10 ausgewählten Elemente in localStorage – zeige sie oben an, wenn die Eingabe leer ist
  • Dynamische Aktionen: registriere Aktionen aus verschiedenen Teilen der App – kontextabhängig (zeige verschiedene Aktionen auf verschiedenen Seiten)
  • Ladezustand: asynchrone Suchergebnisse (z. B. API-Suche) – zeige Ladeindikator im Ergebnisbereich

Muster

import { Command } from "cmdk";
import { useEffect, useState } from "react";
import { useRouter } from "next/navigation";

function CommandPalette() {
  const [open, setOpen] = useState(false);
  const router = useRouter();

  // Globaler Tastaturkurzbefehl
  useEffect(() => {
    const handleKeyDown = (e: KeyboardEvent) => {
      if (e.key === "k" && (e.metaKey || e.ctrlKey)) {
        e.preventDefault();
        setOpen((prev) => !prev);
      }
    };
    document.addEventListener("keydown", handleKeyDown);
    return () => document.removeEventListener("keydown", handleKeyDown);
  }, []);

  return (
    <Command.Dialog open={open} onOpenChange={setOpen} label="Befehlspalette">
      <Command.Input placeholder="Suche oder gebe einen Befehl ein..." />
      <Command.List>
        <Command.Empty>Keine Ergebnisse gefunden.</Command.Empty>

        <Command.Group heading="Zuletzt verwendet">
          {recentItems.map((item) => (
            <Command.Item key={item.id} onSelect={() => { router.push(item.href); setOpen(false); }}>
              {item.label}
            </Command.Item>
          ))}
        </Command.Group>

        <Command.Group heading="Navigation">
          <Command.Item onSelect={() => { router.push("/dashboard"); setOpen(false); }}>
            Dashboard
          </Command.Item>
          <Command.Item onSelect={() => { router.push("/settings"); setOpen(false); }}>
            Einstellungen
          </Command.Item>
        </Command.Group>

        <Command.Group heading="Befehle">
          <Command.Item onSelect={() => { toggleTheme(); setOpen(false); }}>
            Dunkelmodus umschalten
          </Command.Item>
          <Command.Item onSelect={() => { logout(); setOpen(false); }}>
            Abmelden
          </Command.Item>
        </Command.Group>
      </Command.List>
    </Command.Dialog>
  );
}

Vermeide

  • Eine eigene Fuzzy-Suche zu bauen – cmdk übernimmt Filterung, Bewertung und Rangfolge sofort einsatzbereit
  • e.preventDefault() bei Cmd+K zu vergessen – ohne sie öffnet der Browser die Standardsuche/Adressleiste
  • Fehlende Behandlung der Escape-Taste – cmdk erledigt dies über onOpenChange, stelle aber sicher, dass der Fokus zum vorherigen Element zurückkehrt
  • Nur statische Aktionen – registriere Aktionen dynamisch aus dem Seitenkontext (z. B. „Diesen Beitrag bearbeiten“ nur auf Beitragsseiten)
  • Keinen leeren Zustand – zeige immer „Keine Ergebnisse gefunden“ an, wenn die Suche nichts findet

Individual skills in this repo

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

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Verwandte Skills