Communitygithub.com

OneWave-AI/claude-skills

Construye y ejecuta un conjunto de evaluación etiquetado para un modelo System One (Jev, Von o cualquier configuración de decisión tipada), luego explora variaciones de redacción y umbrales. Útil cuando una clasificación de Jev/Von es incorrecta o poco fiable, al elegir entre la API alojada y un modelo local abierto, al ajustar umbrales noul o antes de lanzar cualquier funcionalidad de decisión tipada. Produce una matriz de precisión por redacción y un umbral calibrado.

¿Qué es claude-skills?

Esta habilidad para agentes de IA, como Claude Code o Cursor, permite construir y evaluar sistemáticamente configuraciones de decisión tipada (System One). Es esencial para desarrolladores e ingenieros de IA que trabajan con modelos de clasificación como Jev o Von, ya que aborda el problema crítico de que la precisión del modelo depende en gran medida de cómo se redactan las preguntas o criterios, y los conjuntos de evaluación pequeños pueden engañar. La habilidad automatiza el barrido de diferentes redacciones de criterios y umbrales, produciendo una matriz de precisión por redacción y umbrales calibrados. Soporta cualquier modelo que use configuraciones JSON con instrucciones y criterios, y se ejecuta mediante un script de Python. El flujo de trabajo incluye construir un conjunto etiquetado mínimo de 50 registros (reales, no sintéticos), ejecutar un barrido de redacciones y umbrales, y evaluar honestamente la puerta de confianza. Es particularmente útil antes de lanzar funciones de decisión tipada, cuando un modelo existente falla silenciosamente, o al comparar modelos alojados versus locales.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OneWave-AI/claude-skills/tree/HEAD/jev-eval

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Evaluación de una configuración de decisión tipada

El conjunto de evaluación es el producto. La precisión de un modelo System One está dominada por cómo se redactó la pregunta, y el modo de fallo es silencioso: devuelve una respuesta segura, con tipo válido, pero incorrecta. Sin etiquetas no se puede distinguir una mala pregunta de un mal modelo.

Medido: reescribir los criterios movió un modelo abierto de 4/15 a 14/15 en 15 registros. Sin cambio de modelo. Luego la misma comparación con 150 registros colocó ese modelo en 61% general contra el 97% de Jev — la lectura de 15 registros fue un artefacto de un conjunto pequeño y fácil. Ambos hechos son el punto: la redacción altera los resultados y los conjuntos pequeños mienten sobre la dirección.

Ejecútalo

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

labelled.json es [{"id","state","truth"}]. configs.json asigna un nombre de configuración a {"instructions", "criteria"}: un diccionario de opciones lo convierte en una elección, una lista de niveles lo convierte en una puntuación, omitirlo lo convierte en un noul. El script lee la clave Jev del Llavero (typesafe-api-key), imprime la precisión por configuración, etiqueta la dispersión como ROBUSTA o FRÁGIL, explora umbrales para nouls y puntúa la puerta de confianza.

Salida real, 50 registros de riesgo de comando shell del agente, solo cambió el backend:

config                         precisión   ms/registro
A una línea concisa              45/50       410      <- Jev
B criterios ricos                49/50       415
C ricos + exclusiones            46/50       418
D deliberadamente perezoso        44/50       411
dispersión: 44/50 a 49/50   (ROBUSTA - la redacción no es crítica)

A una línea concisa                9/50        66      <- Von, mismas configuraciones
B criterios ricos                 23/50       121
C ricos + exclusiones             15/50       129
D deliberadamente perezoso        22/50        53
dispersión: 9/50 a 23/50    (FRÁGIL - y el techo aún no es utilizable)

Lee el techo antes que la dispersión. Un modelo FRÁGIL cuya mejor configuración es 23/50 no es un problema de redacción que puedas resolver escribiendo más — es el modelo equivocado para esa pregunta.

1. Construye el conjunto

Mínimo 50 registros, 200+ antes de lanzar. Extrae del flujo real, no de datos sintéticos.

  • Incluye el término medio aburrido, no solo ejemplos limpios y casos extremos dramáticos
  • Incluye registros con metadatos rotos/faltantes — ahí es donde fallan los clasificadores
  • Etiqueta leyendo el registro, antes de ejecutar cualquier modelo. Nunca etiquetes a partir de la salida del modelo
  • Almacena como JSON con el registro bruto más un campo truth
[{"id":"D-1994","state":"...texto completo del registro...","truth":"inbound_prospect"}]

Si no puedes etiquetar un registro con confianza tú mismo, el modelo tampoco puede — o elimínalo o arregla la pregunta para que la respuesta sea determinista.

2. Explora redacciones, no solo modelos

El movimiento central. Escribe 3–4 configuraciones de criterios genuinamente diferentes y ejecútalas todas:

  • A — una línea concisa por opción (lo que todos escriben primero)
  • B — 3–4 oraciones por opción con ejemplos concretos
  • C — B más un valor predeterminado explícito y exclusiones explícitas ("SOLO cuando…")
  • D — deliberadamente perezoso, cuatro o cinco palabras, como prueba de piso

Reporta precisión por configuración por modelo:

config                    JEV       VON      LAYA     (triaje principal, n=50)
A una línea concisa     47/50     34/50     21/50
B criterios ricos       49/50     28/50     15/50
C ricos + exclusiones   48/50     24/50     19/50
D deliberadamente perezoso 48/50     22/50     24/50

Lee el piso primero, luego la dispersión. El piso es "¿puede este modelo hacer el trabajo en absoluto si lo redacto mal?"; la dispersión es "¿cuánto me costará mantenerlo?". Medido en la tarea de comando, cada modelo alojado tiene un piso del 82-92% (Haiku 46-48, GPT-4.1-mini 45-50, Jev 44-49, GPT-5-mini 41-49) mientras que Von tiene un piso de 9/50 y Laya de 18/50. Nota que Jev no es más robusto en redacción que un LLM pequeño — oscila los mismos diez puntos. Lo que compras es el piso, no inmunidad.

Nota lo que la columna de leads NO muestra: un gradiente limpio de "más rico es mejor". La mejor configuración de Von aquí es la concisa. Lo que mueve los números de un modelo abierto es sensibilidad a la forma superficial, no comprensión, así que no asumas que tu próxima reescritura de criterios lo mejora — vuelve a ejecutar el conjunto.

3. Explora umbrales para cada noul

Nunca implementes 0.5. Explora y lee la curva:

for t in [0.5,0.6,0.7,0.75,0.8,0.85,0.9,0.95]:
    tp = sum(p>=t and y     for p,y in z); fp = sum(p>=t and not y for p,y in z)
    fn = sum(p< t and y     for p,y in z); tn = sum(p< t and not y for p,y in z)
    print(f"{t}  P={tp/max(tp+fp,1):.2f}  R={tp/max(tp+fn,1):.2f}  prec={(tp+tn)/len(z):.2f}")

Diferentes modelos tienen diferentes pisos. El noul de Jev se situó en 0.2–0.5 en registros que eran claramente limpios, mientras que Claude llegaba a 0.0 — así que su corte real era ~0.85. Un umbral ajustado en un modelo no se transfiere a otro. Vuelve a explorar cuando cambies.

4. Puntúa la puerta de confianza honestamente

Dos números, siempre juntos:

errs   = [r for r in filas if r.pred != r.truth]
rights = [r for r in filas if r.pred == r.truth]
for g in [0.5,0.7,0.9]:
    atrapados    = sum(r.conf <  g for r in errs)      # errores que la puerta escala
    escalados = sum(r.conf <  g for r in filas)      # volumen total escalado
    print(f"puerta {g}: atrapa {atrapados}/{len(errs)} errores, escala {escalados/len(filas):.0%} del volumen")

Una puerta que atrapa 10/11 errores mientras escala el 93% del volumen no es una puerta que funcione — es un camino lento con pasos extra. Una buena calibración sin buena precisión no compra nada.

5. Informa

  • precisión por configuración por modelo, con la dispersión resaltada
  • umbral elegido por noul, con la exploración que lo justificó
  • puerta: errores atrapados y volumen escalado
  • latencia y costo proyectados por 1k a volumen de producción
  • declaración explícita del tamaño del conjunto de evaluación y lo que no cubre

Los conjuntos pequeños mienten. 15 registros donde dos modelos obtienen ambos 100% no distingue nada — dilo en lugar de implicar que el empate es significativo.

Relacionado

jev-integrate es el flujo de trabajo de conexión que alimenta esto. jev-audit encuentra candidatos que vale la pena evaluar.

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

Wire a System One model (Jev, or an open reproduction like Von) into a product feature — routing, guardrails, scoring, classification. Use when replacing an LLM call that returns a label rather than prose, when adding a typed decision to an agent loop, or when deciding between the hosted Jev API and a local open model. Covers question design, the eval-set-first workflow, threshold calibration, confidence gates, and the traps measured on real data.

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.

Skills relacionados