bbulman/findability

Encontrabilidad

"La gente no lo encuentra" es un síntoma con cuatro causas habituales, y cada una requiere una solución diferente. Este skill sirve para decidir qué cambiar primero: separa la causa de la queja, elige la solución más barata que la aborda y establece una medida que muestre si funcionó.

Antes de empezar

Necesitas	Si falta
Qué no pueden encontrar las personas, quiénes son y dónde buscaron	Pregunta. Si sigue siendo vago, enumera los candidatos y trata como hipótesis.
El sitio, la app o al menos su navegación	Pregunta. Sin ello solo puedes redactar el plan de diagnóstico.
Un registro de búsqueda en CSV: query,count,results, y clicks si está disponible	Di qué exportar y para qué período. Entrega el plan de diagnóstico, las medidas y las tablas vacías. Nunca estimes lo que habría dicho el registro.
Analíticas, preguntas de soporte, un inventario	Di qué conclusiones cambiarían y márcalas como no confirmadas.

Método

1. Escribe la falla como una tarea. "Un [quién] que intenta [objetivo] busca en [dónde] [cosa], y [qué sucede]." Una línea por queja, con sus palabras.

2. Lee el registro y usa sus números.

   node "${CLAUDE_SKILL_DIR}/scripts/search-log.mjs" searches.csv
   

   Si dice que el registro es demasiado pequeño para clasificar, úsalo como lista de las palabras que la gente escribió y declara que no hay tasas. Di qué período cubre la exportación; el script no puede saberlo.

3. Diagnostica antes de recetar. Trabaja las causas en este orden, porque cada una se apoya en la anterior. Varias pueden aplicarse a la vez. Marca cada conclusión como confirmada o inferida.

   Causa	Cómo confirmarla	Solución habitual	Skill
   Falta: no existe	Busca bajo cada nombre que usen las personas. Consultas sin resultados y sin contenido coincidente en ningún lado	Créalo, o di claramente que no se ofrece	content-inventory
   Mal etiquetado: existe bajo otro nombre	Su palabra da cero resultados o ningún clic mientras el contenido está bajo el tuyo; pogo-sticking	Renombra, agrega sinónimos	labeling
   Enterrado: bien nombrado, sin ruta hasta él	Cuenta los pasos desde inicio y centros; busca huérfanos, callejones sin salida, paginación profunda como único camino, búsquedas iniciadas en la página de sección que debería haberlo ofrecido	Enlázalo donde la gente ya mira, o muévelo	navigation, sitemaps
   La búsqueda falla: existe, la consulta coincide, los resultados son incorrectos	Ejecuta tú mismo las consultas principales y lee los resultados; resultados sin clics, reformulaciones, salidas de la página de resultados	Best bets, sinónimos, alcance del índice, ranking	Paso 5

   Muchos problemas de encontrabilidad son más baratos de arreglar en etiquetas y agrupación que en el motor de búsqueda, así que no empieces por el motor. La profundidad por sí sola no es un defecto: la regla de los tres clics es un mito, y la gente hace clic más allá cuando cada paso huele claramente a su objetivo.

4. Decide qué ruta debería funcionar. Apoya la navegación y la búsqueda, porque las personas alternan entre ellas. Las consultas principales deberían ser alcanzables en uno o dos pasos desde el inicio.

   La persona	Ruta a reforzar
   Sabe el nombre exacto	Búsqueda, o una lista A-Z
   Sabe la necesidad pero no el nombre	Navegación con etiquetas claras, luego facetas
   Está explorando o comparando	Navegación, filtros, enlaces relacionados
   Vuelve a algo	Elementos recientes, vistas guardadas, atajos
   Está en medio de una tarea	Un enlace o señal contextual en el lugar donde trabaja

5. Arregla la búsqueda si la causa es la búsqueda. Pon best bets seleccionados en la parte superior de los resultados para las consultas principales. Construye conjuntos de sinónimos a partir de los grupos de variantes del script, empezando por los marcados como SYNONYM WOULD ANSWER, luego añade lo que solo una persona detecta, como acrónimos y jerga. Nunca dejes que una página sin resultados sea un callejón sin salida. references/search-tuning.md cubre los tres aspectos y qué exportar.

6. Pon señales donde ocurre la decisión. Una buena señal responde a una pregunta que la persona ya tiene, en el momento en que toma la decisión, en el lugar donde ya está mirando, de forma silenciosa y barata. La flecha junto al indicador de combustible de un coche que muestra de qué lado está la tapa es el modelo. Lee references/routes-and-cues.md antes de añadir una señal, o un punto de entrada personalizado.

7. Si alguien propone un chat de IA como solución, pruébalo primero. Los botones y menús permiten a las personas actuar y muestran lo que el sistema puede hacer. Una caja de chat abierta hace lo primero lentamente y lo segundo en absoluto.

   Situación	Mejor respuesta
   Un conjunto limitado y conocible de opciones	Botones, menús o filtros
   Las personas no saben lo que el sistema puede hacer	Estructura visible; una caja vacía no enseña nada
   Una tarea repetida con pasos conocidos	Una ruta directa
   El contenido falta o está mal etiquetado	Arréglalo primero; el chat no puede recuperar lo que no está
   Verdaderamente abierto, formulado de forma diferente cada vez	El chat puede ganarse su lugar, con estructura a su alrededor

8. Establece medidas que realmente puedas recopilar. Toma una línea de base antes de cambiar nada, una medida por problema. Si no hay línea de base, dilo.

   Medida	De dónde viene	Objetivo
   Tiempo para encontrar un elemento simple	Una prueba de tarea cronometrada con personas	Menos de 30 segundos
   Éxito de tarea	Una prueba de tarea o test de árbol	Al menos 70%, y 80% para tareas principales
   Proporción de resultados cero en búsquedas	Registro de búsqueda	Por debajo de su propia línea de base
   Salidas de búsqueda, reformulaciones	Analíticas, si la página de resultados se rastrea	Por debajo de su propia línea de base
   Volumen de soporte sobre este tema	Mesa de ayuda, si está etiquetado	Por debajo de su propia línea de base

   references/measures.md dice qué puede y qué no puede mostrar cada una.

Entregable

Escribe findability-diagnosis.md a menos que el usuario nombre otro archivo, en este orden: Recomendación (dos o tres frases); Las fallas, como tareas; Evidencia (fuente, período, números del script); Diagnóstico (cosa, causa, evidencia, confirmado o inferido); Opciones (dos o tres, con lo que cuesta cada una y qué deja sin arreglar); Lista de arreglos en orden, con el skill que se encarga de cada uno; Best bets y sinónimos (query, action, target); Página sin resultados, si corresponde; Medidas (nombre, línea de base, objetivo, fuente, fecha de revisión); Suposiciones y qué no estaba disponible.

Trabajo	Devuelve
Una cosa que nadie encuentra	Falla, causa, evidencia, arreglo y una medida, en la respuesta
Un registro de búsqueda para leer	Evidencia, best bets y sinónimos, y los vacíos de resultados cero
"La encontrabilidad es mala en todo el sitio"	El documento completo

Pon las tablas largas al final. Un documento más largo no es más exhaustivo.

Verifícalo

• Cada número proviene de una ejecución del script o de una fuente que el usuario te dio. Vuelve a ejecutar el script si el registro cambió.
• Cada arreglo nombra la causa que aborda, y cada causa tiene evidencia o está marcada como inferida.
• Ejecutaste las consultas principales manualmente si tenías acceso, porque el registro no puede decir si los resultados fueron buenos.
• Verificaste que cada sinónimo propuesto significa lo mismo. El script agrupa por ortografía, por lo que puede emparejar palabras que difieren en significado.
• Los registros de búsqueda pueden contener nombres y correos electrónicos escritos en la caja. El script oculta las direcciones de correo electrónico; no copies otros datos personales en el informe.

Lo que Claude no puede hacer aquí

No puedes observar a personas reales buscando, cronometrarlas ni conocer la estrategia de la organización a menos que te lo digan. Nunca inventes números de uso, volúmenes de búsqueda, tasas de éxito ni citas; una medida sin datos se muestra como aún no recopilada. Propón alternativas con sus compensaciones, recomienda una y di por qué; la decisión es humana. Lo que un producto de búsqueda puede hacer (sinónimos, resultados fijados, registro de consultas) varía, así que di lo que esperarías y pide al usuario que lo confirme.

Dónde se entrega esto

Siguiente necesidad	Skill
Descubrir qué existe	content-inventory
El nombre es incorrecto	labeling
Los términos y filtros necesitan trabajo	taxonomies
Los grupos no coinciden con cómo piensa la gente	card-sort
Falta la ruta hacia ello	navigation, sitemaps
Probar una jerarquía cambiada	tree-tests
Campos necesarios para facetas o vistas previas	content-models
Una página se mueve	url-structure, redirect-maps
Una reestructuración completa del sitio, o no estás seguro por dónde empezar	information-architecture