Communitygithub.com

OneWave-AI/claude-skills

Ein System One Modell (Jev oder eine offene Reproduktion wie Von) in ein Produktmerkmal integrieren – Routing, Guardrails, Bewertung, Klassifikation. Verwenden Sie dies, wenn Sie einen LLM-Aufruf ersetzen, der ein Label statt Text zurückgibt, wenn Sie eine typisierte Entscheidung zu einer Agentenschleife hinzufügen oder wenn Sie zwischen der gehosteten Jev-API und einem lokalen offenen Modell wählen. Behandelt die Fragestellung, den Workflow „Evaluierungs-Set zuerst“, die Kalibrierung von Schwellenwerten, Konfidenz-Gates und die Fallstricke, die an realen Daten gemessen wurden.

Was ist claude-skills?

Dieser Skill beschreibt die Integration eines System One Modells (z.B. Jev oder Von) in Produktfeatures, bei dem es um einfache, sich wiederholende Klassifikationen oder Bewertungen geht, die typisiert und effizient sind. System One Modelle beantworten typisierte Fragen in einem einzigen Vorwärtsdurchlauf ohne Textgenerierung – sie dienen als lesbare If-Anweisungen und eignen sich für Hochvolumen-, Latzenz- oder Kostenoptimierung. Der Skill umfasst das Design von Fragen (Choice, Noul, Score), die Kalibrierung von Konfidenzschwellen, den Aufbau eines Confidence-Gates mit Fallback zu Claude sowie den Vergleich zwischen gehosteten Diensten (Jev) und lokalen Modellen (Von, Laya). Er betont strenge Evaluierungs-Workflows: mindestens 50 handgelabelte Datensätze vor dem Schreiben von Kriterien, Messung gegen reale Daten, Kalibrierung von Schwellenwerten und Auswertung von Konfidenz-Gates anhand von Fehler- und Volumenstatistiken. Die Technik wird über verschiedene Zugangspfade bereitgestellt: TypeSafe direkt, Cloudflare Workers AI und lokales Von-SDK. Neben den Vorteilen zeigt der Skill auch Fallstricke auf, insbesondere bei offenen Modellen, die in der Praxis signifikante Einbußen aufweisen, z.B. 61% Genauigkeit bei Von im Vergleich zu 97% bei Jev.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OneWave-AI/claude-skills/tree/HEAD/jev-integrate

In Ihrer bevorzugten KI fragen

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

Dokumentation

Ein System One Modell in ein Feature einbinden

Ein System One Modell beantwortet typisierte Fragen in einem einzigen Vorwärtsdurchlauf. Es generiert keinen Text. Status rein, typisierte Antworten mit kalibrierten Wahrscheinlichkeiten raus. Es ist eine If-Anweisung, die lesen kann.

Verwenden Sie es, wenn die Entscheidung eng, vorspezifiziert und wiederholt ist. Verwenden Sie es nicht für irgendetwas, das eine schriftliche Erklärung benötigt – das ist immer noch eine Aufgabe für Claude.

Bevor Sie irgendetwas tun: Ist das wirklich das richtige Werkzeug

Beantworten Sie diese drei. Wenn eines „nein“ ist, stoppen Sie und behalten Sie den LLM-Aufruf.

  1. Sind die möglichen Antworten im Voraus bekannt? Die Anzahl der Optionen ist auf 255 begrenzt.
  2. Benötigt der Aufrufer nur das Label, nicht die Begründung? Wenn ein Mensch nachgelagert eine Begründung liest, brauchen Sie Text und das ist das falsche Werkzeug.
  3. Ist es ein hohes Volumen, oder wartet eine Person? Das ist eine Latenz- und Kostenoptimierung, kein Fähigkeitsgewinn. Es weiß nichts, was Claude nicht weiß. Bei einem nächtlichen Cron-Job über fünfzig Datensätze bringt es Ihnen eine Abhängigkeit und sonst nichts.

Gemessen an 150 handgelabelten Datensätzen bei drei Aufgaben (unser Lauf vom 20. September 2026): Jev liegt gleichauf mit GPT-5.2 bei 145/150 und kostet 46x weniger (0,036 $ vs. 1,64 $ pro 1.000 Datensätze), aber Ende-zu-Ende ist es nur 1,7x schneller als GPT-4.1-mini – die veröffentlichten 40x-200x beziehen sich auf einen mehrstufigen Frontier-Workflow mit 3-329 s, nicht auf einen Aufruf.

Die offenen Reproduktionen sind kein Drop-In. Gleicher Lauf: Von 1.0.1 (395M) 92/150 (61%), Laya (421M) 62/150 (41%). Sie brechen auf eine Klasse zusammen, anstatt zu degradieren – Von sagte exfiltration 25 Mal bei einem 50-Befehls-Set, das fünf enthielt. Ein Konfidenz-Gate rettet das nicht: Um Von's Fehler zu fangen, mussten 92% des Volumens hochgestuft werden, bei Laya 100% gegenüber 8% bei Jev. Verwenden Sie sie nur, wenn Sie sie an Ihrem eigenen gelabelten Set gemessen haben.

Die drei Fragetypen

"lead_type":  {"type":"choice", "instructions": "...", "criteria": {"opt_a":"desc","opt_b":"desc"}}
"is_urgent":  {"type":"noul",   "instructions": "..."}                       # -> 0.0–1.0
"priority":   {"type":"score",  "instructions": "...", "criteria":["ignore","low","high"]}

Stellen Sie alle Fragen, die Sie brauchen, in einem Aufruf – sie werden alle im selben Vorwärtsdurchlauf aufgelöst, daher kosten vier Fragen ungefähr so viel wie eine.

Antwortformat (sowohl Jev als auch Von):

r["answers"]["lead_type"]["choice"]         # das Label
r["answers"]["lead_type"]["probabilities"]  # vollständige Verteilung
r["answers"]["lead_type"]["confidence"]     # dies für das Gating verwenden
r["answers"]["is_urgent"]["noul"]           # 0.0–1.0
r["answers"]["priority"]["score"]           # Position auf der Skala, z. B. 2.41

Workflow

1. Das gelabelte Set ZUERST erstellen – mindestens 50 Datensätze

Nicht verhandelbar und der mit Abstand wertvollste Schritt. Beschriften Sie reale Datensätze aus dem Stream, auf den Sie dies anwenden möchten, bevor Sie Kriterien schreiben. Ohne diese können Sie keine schlechte Frage von einem schlechten Modell unterscheiden, und der Fehler ist still – siehe jev-eval.

2. Die Kriterien so schreiben, als würden Sie es einem neuen Mitarbeiter erklären

Schlechtester-bester Spread über vier Formulierungen derselben Fragen, 50 Datensätze pro Aufgabe (unser Lauf vom 20. September 2026):

AufgabeJevVon (395M)Laya (421M)
Agenten-Befehlsrisiko44-49 (10 Pkt.)9-23 (28 Pkt.)18-28 (20 Pkt.)
Lead-Triage47-49 (4 Pkt.)22-34 (24 Pkt.)15-24 (18 Pkt.)
Ticket-Routing41-47 (12 Pkt.)23-41 (36 Pkt.)22-36 (28 Pkt.)

Gleicher Durchlauf bei der Befehlsaufgabe mit den LLMs: Haiku 4.5 46-48 (4 Pkt.), GPT-4.1-mini 45-50 (10 Pkt.), Jev 44-49 (10 Pkt.), GPT-5-mini 41-49 (16 Pkt.).

Jev ist NICHT formulierungsrobuster als ein kleines LLM – es schwankt um dieselben zehn Punkte, und Haiku war das stabilste Modell im Test. Lesen Sie das MINIMUM, nicht den Spread: Jedes gehostete Modell hat ein Minimum von 82-92% und bleibt auslieferbar, während Von bei 18% und Laya bei 36% liegt. Lesen Sie das NICHT als „bessere Kriterien schreiben und das offene Modell holt auf“ – ein früherer 15-Datensatz-Test kam genau zu diesem Schluss und er war falsch. Umfangreichere Kriterien halfen nicht zuverlässig: Bei Lead-Triage bewertete Von 34/50 mit der knappen Formulierung und 28/50 mit der sorgfältig geschriebenen. Was diese Zahlen bewegt, ist die Empfindlichkeit gegenüber der Oberflächenform, nicht das Verständnis, daher ist jede zukünftige Kriterienbearbeitung ein unangekündigtes Regressionsrisiko.

Schreiben Sie jede Option mit: was sie ist, was sie nicht ist, und dem Grenzfall, der zu einer falschen Antwort verleitet. Benennen Sie die Standardeinstellung explizit, wenn eine Option dominieren soll.

3. Schwellenwerte gegen das gelabelte Set kalibrieren – niemals 0,5 annehmen

Ein Noul ist eine Wahrscheinlichkeit, kein boolescher Wert. Jevs Noul hat einen Mindestwert: Bei Datensätzen, die eindeutig sauber waren, gab es immer noch 0.2–0.5 zurück, wo Claude 0.0 zurückgab. Bei den gemessenen Daten lag der sinnvolle Cut bei ~0,85, nicht bei 0,5. Schwellenwerte lassen sich nicht zwischen Modellen übertragen – führen Sie den Sweep erneut durch, wenn Sie wechseln.

Schreiben Sie den Sweep nicht von Hand. jev-eval besitzt die Kalibrierung und liefert das Werkzeug:

python ~/.claude/skills/jev-eval/scripts/sweep.py labelled.json configs.json \
    --backend jev --question <name>

4. Das Konfidenz-Gate entwerfen

Gate-Antworten mit niedriger Konfidenz an Claude weiterleiten. Dasselbe Skript berichtet beide relevanten Hälften – welchen Anteil der Fehler das Gate abfängt und welchen Anteil des Volumens es hochstuft – und bewertet das Ergebnis. Ein Gate, das jeden Fehler abfängt, aber 73% des Datenverkehrs hochstuft, wird mit saves nothing bewertet, da es ein langsamer Pfad mit extra Schritten ist. Wenn Sie das sehen, liegt die Lösung in besseren Kriterien oder dem gehosteten Modell, nicht in einem anderen Schwellenwert.

a = r["answers"]["lead_type"]
if a["confidence"] < GATE:
    return escalate_to_claude(state)   # langsamer Pfad
return a["choice"]                      # schneller Pfad

5. Hinter einem Feature-Flag ausliefern, beide Pfade eine Woche lang protokollieren

Protokollieren Sie die System One Antwort und was der alte Pfad gesagt hätte. Vergleichen Sie sie unter echtem Datenverkehr, bevor Sie umschalten. Niemals nur auf Basis von Evaluierungs-Set-Zahlen umschalten.

Zugangspfade

# 1. TypeSafe direkt – Schlüssel in macOS Keychain, Dienst `typesafe-api-key`
export TYPESAFE_API_KEY="$(security find-generic-password -s typesafe-api-key -w)"
curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"jev-latest","state":"...","questions":{...}}'
// 2. Cloudflare Workers AI – keine Warteliste
await env.AI.run('typesafe/jev', { state, questions })
# 3. Von – lokal, kostenlos, Apache-2.0, 395M ModernBERT
# pip install von-sdk
import von
r = von.system_one(state="...", questions={"x": von.Noul(instructions="...")})
r.answers["x"].noul

Fallstricke

  • Von's Choice nimmt criteria=, nicht choices=. Pydantic-Fehler, wenn Sie es falsch raten.
  • Von gibt .answers[k] zurück, nicht .nouls[k] / .choices[k]. Der LangChain-Wrapper unterscheidet sich hier vom rohen SDK.
  • Von's 34 s Kalstart lädt die Gewichte. Wärmen Sie es beim Boot; messen Sie es niemals in der Latenz.
  • Setzen Sie einen Noul nicht bei 0,5 als Schwellenwert. Siehe Schritt 3.
  • Jev ist früh im Zugang, Single-Vendor, ohne SLA. Setzen Sie keinen kritischen kundenorientierten Pfad darauf, ohne Fallback zu Claude.
  • Kleine Evaluierungs-Sets lügen. 15 Datensätze, bei denen beide gehosteten Modelle 100% erzielten, beweisen fast nichts. Verwenden Sie hunderte.

Verwandte Themen

jev-eval erstellt und führt das gelabelte Set aus. jev-audit findet heraus, welche vorhandenen LLM-Aufrufe in einer Codebasis eine Konvertierung wert sind.

Individual skills in this repo

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

OneWave-AI/claude-skills

Deploy a 2-layer parallel agent hierarchy for large, parallelizable work — big refactors, multi-file migrations, codebase-wide audits, bulk generation. A top-tier commander (Fable or Opus) orchestrates the swarms; the user picks a power level (Max Power / Heavy / Balanced / Economy) that sets the Opus/Sonnet/Haiku model mix per layer. Layer 1 is 3-50+ specialist agents, each with its own full context window; Layer 2 is 2+ sub-agents per member. Includes git safety, tiered sizing, a pre-deploy gate, phantom-completion checks, and multi-wave follow-up.

OneWave-AI/claude-skills

Generate animated videos and motion graphics from natural language descriptions. Creates a standalone Vite + React project with Framer Motion scenes that auto-play in the browser. Use when the user wants to create animations, motion graphics, video intros, animated presentations, or product demos.

OneWave-AI/claude-skills

Use before starting a product, feature, MVP, agent, automation, or integration build to identify the main pre-build risk and choose the smallest validation step. Trigger when the user asks whether to build, scope, validate, prioritize, or sanity-check an idea before implementation.

OneWave-AI/claude-skills

Post-mortem analysis when a client churns. Takes client history, engagement data, support tickets, usage logs, and exit feedback to produce a comprehensive churn autopsy with root cause classification, timeline of decline, and preventive measures.

OneWave-AI/claude-skills

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

OneWave-AI/claude-skills

Assemble 2-3 complementary experts to collaboratively analyze anything. Experts work together to explore topics from multiple expert angles.

OneWave-AI/claude-skills

Convert any topic into playable browser games. Types: trivia, matching, word puzzles, adventure games. Uses Phaser.js or Kaboom.js.

OneWave-AI/claude-skills

Turn a marketing brief or product offer into a finished short-form video ad built in HyperFrames — hook, script, shot-by-shot storyboard, scene-by-scene HTML composition, captions, and voiceover. Outputs platform cuts (vertical 9:16, square, 16:9). Use when you need a launch ad, product promo, social video, or paid-creative concept ready to render.

OneWave-AI/claude-skills

Turn a website URL, product docs, or a founder's rambling description into a tight 60-90 second explainer video built in HyperFrames -- problem/solution narrative, animated product walkthrough scenes, captions, and voiceover, ready for the homepage hero, sales emails, and onboarding.

OneWave-AI/claude-skills

Build promo videos for local businesses in HyperFrames -- the new-menu drop, the seasonal offer, the event announcement, the "we're hiring" post, the Google Business Profile clip. Restaurant, salon, gym, trades: 15-30 seconds, brand-clean, captioned, sized for Instagram, Facebook, and the profile.

OneWave-AI/claude-skills

Build a personalized product-demo or sales-walkthrough video in HyperFrames for a specific prospect or account — narrated screen-by-screen, branded to them, ending in a clear next step. Turns a generic demo into a "this was made for me" asset for outbound, follow-up, or deal acceleration. Use when you want to send a tailored video instead of booking another live call.

OneWave-AI/claude-skills

Turn real customer reviews, quotes, and case-study results into polished social-proof videos built in HyperFrames -- single-testimonial spotlights, review-wall montages, and stat-driven proof reels with captions and voiceover, cut for vertical, square, and wide. The highest-converting content most businesses never make.

OneWave-AI/claude-skills

Audit a codebase for LLM calls that are really classifications in disguise, then produce a costed swap plan for a System One model. Use when asked to cut AI inference cost or latency, when scoping a performance engagement for a client, when reviewing an agent loop that feels slow, or when asked "where could we use Jev here". Produces a ranked table of candidates with measured latency and dollar deltas.

OneWave-AI/claude-skills

Build and run a labelled eval set for a System One model (Jev, Von, or any typed-decision config), then sweep criteria wordings and thresholds against it. Use when a Jev/Von classification is wrong or unreliable, when choosing between the hosted API and a local open model, when tuning noul thresholds, or before shipping any typed-decision feature. Produces an accuracy-by-wording matrix and a calibrated threshold.

OneWave-AI/claude-skills

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

OneWave-AI/claude-skills

TAM/SAM/SOM calculator with deep market research. Produces comprehensive market-sizing.md with top-down and bottom-up estimates, methodology, data sources, assumptions, sensitivity ranges, growth projections, competitive landscape, and Mermaid visualizations. Use when user needs market size estimates, addressable market analysis, go-to-market sizing, investor-ready market analysis, or business plan market validation.

OneWave-AI/claude-skills

Generate unique personalized first lines for hundreds of prospects using company news, LinkedIn activity, and mutual connections. Saves 10+ hours of manual research per campaign. Use when you need personalized outreach at volume.

OneWave-AI/claude-skills

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

OneWave-AI/claude-skills

Create multiple choice, true/false, fill-in-blank, matching quizzes. Auto-generate plausible distractors. Instant grading with explanations.

OneWave-AI/claude-skills

Enhanced skill navigator that maps conversation history, recommends multi-skill chains, identifies patterns from past usage, and learns from session outcomes. Goes beyond basic scout with deep context analysis and workflow orchestration.

Verwandte Skills