on-page-fundamentals
Skill6 starsChanged 15 days agoMITView on GitHub
Title, meta description y H1: longitudes, duplicados, ausencias, canibalización, reglas por tipo de página, sitios multilingües, bugs por CMS (Yoast, Rank Math, WooCommerce, PrestaShop) e impacto en CTR. Usar en auditorías de contenido u optimización de CTR.
In this repository40 other files it gives its agents.
- accesibilidad-wcagSkill
- cache-headersSkill
- canonicalSkill
- ccpaSkill
- core-web-vitalsSkill
- ga4-ai-trafficSkill
- ga4-analysisSkill
- geo-ai-discoverabilitySkill
- google-tag-managerSkill
- hreflangSkill
- image-optimizationSkill
- javascript-seoSkill
- ley-25326Skill
- ley-datos-chileSkill
- lfpdpppSkill
- lgpdSkill
- mineria-de-impresionesSkill
- nfadpSkill
- prestashop-seoSkill
- privacidadSkill
- redirectsSkill
- rgpdSkill
- robots-txtSkill
- schema-markupSkill
- screaming-frogSkill
- semrushSkill
- seo-educacionSkill
- seo-gsc-diagnosticsSkill
- seo-interlinkingSkill
- seo-negativoSkill
- seo-quoteSkill
- se-rankingSkill
- sitemapSkill
- ssl-httpsSkill
- third-party-scriptsSkill
- uk-gdprSkill
- ux-heuristicaSkill
- wordpress-diviSkill
- wordpress-elementorSkill
- wordpress-hidden-errorsSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 69
No controlable directamente — mejorar alineación entre title y contenido
- Distinctive: line 170
Relación H1 — title tag: no deben ser idénticos pero sí coherentes.
- Distinctive: line 182
H1 ≠ H2: no saltar niveles. La estructura de headings debe ser jerárquica: H1 > H2 > H3.
- Distinctive: line 299
No confundir CTR bajo con posición baja: una página en posición 8-10 puede tener CTR bajo simplemente por la posición, no por el title.
- Distinctive: line 344
No existe excepción por "es estándar del sector" o "es obvio que lo tienen".
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
On-Page Fundamentals — Title, Meta Description, H1
Title tag
Qué hace
El title tag es el texto del enlace azul en SERP. Es el factor on-page de mayor peso directo en el ranking para la keyword objetivo. Google puede reescribir el title mostrado en SERP si considera que el declarado no representa bien el contenido de la página.
Longitud
Google no tiene límite de caracteres — trunca visualmente en ~600px de ancho. En desktop, esto equivale aproximadamente a 55-60 caracteres. En mobile, algo menos.
Recomendación práctica:
- Objetivo: 50-60 caracteres
- Máximo antes de truncación garantizada: 60 caracteres
- Herramienta de verificación: Portent SERP Preview, Screaming Frog
Title demasiado corto (<30 caracteres): señal de que la keyword y el contexto no están suficientemente representados. Oportunidad de añadir modificadores.
Title demasiado largo (>70 caracteres): truncado en SERP. El texto que queda fuera del truncado no aporta al CTR pero sí al ranking semántico.
Estructura recomendada por tipo de página
| Tipo de página | Estructura | Ejemplo |
| Homepage | Marca + propuesta de valor + keyword principal | Clínica Ejemplo — Fisioterapia en Madrid |
| Categoría | Keyword + modificador + marca | Sillas ergonómicas — Tienda Ejemplo |
| Producto | Nombre producto + atributo diferenciador + marca | Silla Ergonómica X200 con reposabrazos — Tienda Ejemplo |
| Artículo blog | Keyword en primeras palabras + beneficio/contexto | Cómo elegir silla ergonómica: guía completa 2025 |
| Página local | Servicio + ciudad + marca | Fisioterapia en Salamanca — Clínica Ejemplo |
| Página de servicio | Servicio + diferenciador + ciudad/marca | Fisioterapia deportiva en Madrid — Clínica Ejemplo |
Errores frecuentes
Title duplicado: múltiples páginas con el mismo title.
- Causa: CMS usando el mismo template sin campo de title personalizado
- Impacto: canibalización de señal, Google confunde qué página mostrar
- Detección: Screaming Frog > Page Titles > Duplicate
Title ausente: la página devuelve title vacío o solo <title></title>.
- Causa: template defectuoso, plugin SEO no aplicado a ese tipo de contenido
- Impacto: Google genera un title propio — habitualmente el H1 o el nombre del sitio
- Detección: Screaming Frog > Page Titles > Missing
Title = nombre del sitio solamente: Tienda Ejemplo sin keyword.
- Causa: homepage sin title personalizado, configuración por defecto del plugin
- Fix: personalizar en Yoast / Rank Math / PrestaShop backoffice
Title reescrito por Google: Google decide mostrar en SERP un texto diferente al declarado.
- Causa: el title declarado no coincide con el contenido real de la página, es demasiado largo, es genérico, o contiene keyword stuffing
- No controlable directamente — mejorar alineación entre title y contenido
Keyword stuffing en title: Fisioterapia Madrid | Fisioterapeuta Madrid | Clínica Fisioterapia Madrid
- Google puede penalizar o reescribir automáticamente
- Fix: un solo uso de la keyword principal, en primeras palabras
WordPress — implementación
Yoast: Post/página editor > Yoast SEO > SEO title
Template disponible: %%title%% %%sep%% %%sitename%%
Rank Math: Post editor > Rank Math > Title (Edit Snippet)
Variables: %title% %sep% %sitename%
Configuración de separador:
- Yoast: SEO > Search Appearance > General > Title separator →
|,-,·,«» - Rank Math: General Settings > Titles & Meta > Separator
Issue — WooCommerce productos sin title personalizado:
Si el title de producto se genera solo desde el nombre del producto, todos los productos
de la tienda usan Nombre Producto - Nombre Tienda sin keyword de compra.
Añadir template en Yoast: SEO > Search Appearance > WooCommerce > Product title:
%%wc_shortdesc%% %%sep%% %%sitename%% o personalizar manualmente para productos clave.
PrestaShop — implementación
Backoffice > Catálogo > Productos > SEO > Meta title (campo directo por producto/categoría)
Template global: Parámetros de la tienda > SEO & URLs > Meta title — afecta a páginas sin title individual definido.
Issue — título de categoría = nombre de categoría: PrestaShop usa el nombre de la categoría como title por defecto. Para categorías competitivas, editar el campo Meta title individualmente.
Meta description
Qué hace
La meta description no afecta directamente al ranking. Sí afecta al CTR desde SERP: una meta description bien redactada aumenta el porcentaje de clics.
Google puede ignorar la meta description declarada y extraer un fragmento del contenido de la página que considera más relevante para la query del usuario. Esto ocurre con más frecuencia en páginas con contenido rico y variedad de queries.
Longitud
Aproximadamente 155-160 caracteres para desktop. Google trunca con ... al superar
el límite visual (~920px en desktop).
Recomendación práctica:
- Objetivo: 140-155 caracteres
- Incluir la keyword principal de forma natural (Google la muestra en negrita si coincide con la query)
- Terminar con un CTA implícito o diferenciador claro
Estructura recomendada
| Tipo de página | Contenido de la meta description |
| Homepage | Qué ofrece el negocio + diferenciador + localización si es local |
| Categoría | Qué incluye la categoría + número de productos/posts si es relevante + CTA |
| Producto | Beneficio principal + atributo diferenciador + CTA de compra |
| Artículo blog | De qué trata el artículo + qué aprende el lector |
| Página local | Servicio + ciudad + disponibilidad / contacto |
Errores frecuentes
Meta description duplicada:
- Causa: template global sin personalización por página
- Impacto: bajo CTR — Google genera un snippet propio (habitualmente mejor que una genérica)
- Detección: Screaming Frog > Meta Description > Duplicate
Meta description ausente:
- Consecuencia esperada: Google extrae un fragmento de la página. No siempre es malo — si el contenido es rico, Google puede elegir bien. En páginas de conversión (producto, servicio), la ausencia sí es un problema porque Google puede mostrar un fragmento irrelevante para la intent del usuario
- Detección: Screaming Frog > Meta Description > Missing
Meta description demasiado larga (>160 caracteres):
- Truncada en SERP. El texto que queda fuera no genera impacto en CTR
- Fix: condensar el mensaje clave en los primeros 155 caracteres
Meta description como campo de keyword stuffing:
Fisioterapia Madrid. Fisioterapeuta en Madrid. Clínica de fisioterapia Madrid.
- Google ignora esta meta description y genera su propio fragmento
- Fix: texto natural orientado al usuario, no a los bots
H1
Qué hace
El H1 es el título principal visible de la página. Señala a Google el tema central del contenido. No debe confundirse con el title tag — el H1 es visible en la página; el title tag aparece en la pestaña del navegador y en SERP.
Relación H1 — title tag: no deben ser idénticos pero sí coherentes. El title tag incluye la marca; el H1 normalmente no. El H1 puede ser más largo y conversacional; el title tag es más corto y orientado al click.
Reglas
- Una sola etiqueta H1 por página. Múltiples H1 no penalizan directamente pero diluyen la señal de tema principal.
- Incluir la keyword principal, idealmente en las primeras palabras.
- No usar H1 como decoración: si el theme usa H1 para el nombre del sitio en el header de todas las páginas, cada página tiene efectivamente dos H1 — el del header y el del contenido.
- H1 ≠ H2: no saltar niveles. La estructura de headings debe ser jerárquica: H1 > H2 > H3.
Errores frecuentes
H1 ausente:
- Causa: template del theme que no genera H1, o el contenido usa H2 directamente
- Detección: Screaming Frog > H1 > Missing
Múltiples H1:
- Causa: theme con H1 en header + H1 en el contenido, o page builder añadiendo H1 en varios bloques
- Detección: Screaming Frog > H1 > Multiple H1s
- Fix en WordPress: cambiar el heading del header del theme a un elemento no semántico
(
<div>,<p>) o a H2
H1 = título de categoría genérico:
/categoria-productos/ con H1 "Productos" sin keyword.
El H1 debe contener la keyword de la categoría, no solo el nombre interno.
H1 duplicado entre páginas: Ocurre en e-commerce cuando varios productos de la misma familia usan el mismo H1.
- Detección: Screaming Frog > H1 > Duplicate
WordPress — issues con page builders
Elementor: Elementor puede generar H1 en el Heading widget mientras el post title también genera un H1 desde el template del theme. Resultado: dos H1.
Verificar en Elementor: si el template usa {{Post Title}} en un Heading widget
configurado como H1, y el theme también muestra el post title como H1 fuera del
Elementor canvas, hay duplicación.
Fix: convertir uno de los dos a H2 o configurar el template para no mostrar el post title del theme cuando Elementor toma el control del template.
Divi: Similar — el módulo de título de la página de Divi y el heading del theme pueden generar dos H1. Verificar con View Source en páginas que usan Divi Builder.
Sitios multilingües — title y meta de las portadas de cada idioma
Con WPML + Rank Math, el title de la portada suele ser %sitename% %page% %sep% %sitedesc%.
%sitedesc% sale del Tagline de WordPress y la meta description de la opción de portada
de Rank Math. Ambos son strings de WPML String Translation: si no tienen traducción,
/en/, /pt-br/ y /fr/ muestran title y meta en el idioma por defecto aunque hreflang,
canonical, html lang y og:locale estén bien. No lo detecta un crawler que solo mire
duplicados por URL.
Corrección: traducir en String Translation el Tagline (context WP), la meta description
y la description de Facebook/Open Graph de la portada (las tres strings de Rank Math). El
nombre del sitio no se traduce si es marca. Adaptar los claims: una frase como "la mayor
comunidad de lectores en español" no vale para la versión inglesa. Verificar en vivo cada
portada.
Open Graph duplicado por un plugin social
Plugins de publicación en redes (Blog2Social con og_active y card_active) imprimen su
propio bloque og:title, og:description, og:url (a veces relativo, inválido),
og:image y og:article:published_time además del que emite el plugin SEO. Facebook y
LinkedIn toman el primero que encuentran. Si el plugin SEO ya genera Open Graph y Twitter
Cards, desactivarlos en el plugin social. Detección: contar og:url y og:title en el
HTML; debe haber uno de cada.
Canibalización de keywords entre title/H1
Cuando dos páginas del mismo sitio tienen el mismo title tag o compiten por la misma keyword principal en el H1, pueden canibalizarse en SERP — Google elige una de las dos de forma inconsistente, y ninguna obtiene el posicionamiento esperado.
Señal en GSC: la keyword aparece con rankings fluctuantes entre dos URLs distintas en el mismo período. Ver en GSC > Performance > Queries > hacer click en la query > ver URLs que aparecen para esa query.
Detección con Screaming Frog: Export de todos los H1 y title tags → ordenar por valor → identificar duplicados entre páginas distintas.
Fix:
- Si ambas páginas tienen contenido valioso: diferenciar el enfoque de cada una — una para el término genérico, otra para la variante long-tail o con modificador
- Si una página es claramente inferior: 301 redirect + consolidar contenido en la página fuerte
- Canonical de la débil a la fuerte solo si el contenido es esencialmente duplicado
Análisis con Screaming Frog
Columnas y filtros clave:
| Sección | Filtro | Qué detecta |
| Page Titles | Missing | Páginas sin title tag |
| Page Titles | Duplicate | Títulos repetidos entre páginas |
| Page Titles | Over X Characters | Titles largos (configurar a 60) |
| Page Titles | Below X Characters | Titles cortos (configurar a 30) |
| Meta Description | Missing | Sin meta description |
| Meta Description | Duplicate | Meta descriptions repetidas |
| Meta Description | Over X Characters | Demasiado largas (configurar a 160) |
| H1 | Missing | Páginas sin H1 |
| H1 | Multiple H1s | Páginas con más de un H1 |
| H1 | Duplicate | H1 repetido entre páginas |
Workflow de auditoría:
- Exportar todos los issues a CSV
- Priorizar por tráfico: cruzar con GSC para identificar qué páginas tienen impresiones pero bajo CTR (posibles mejoras de title/meta description)
- Separar issues técnicos (ausentes, duplicados) de optimizaciones (keywords, longitud)
GSC — CTR bajo como señal de title/meta subóptimo
Performance > Filtrar por páginas con >100 impresiones y CTR <2% (desktop, non-brand): Son candidatas a mejora de title tag o meta description.
No confundir CTR bajo con posición baja: una página en posición 8-10 puede tener CTR bajo simplemente por la posición, no por el title. Filtrar por posición 1-5 + CTR bajo para identificar casos donde el title es el problema.
Sitios maduros — acotar el cambio a lo que dice GSC y dejar lista la reversión
En un sitio que ya posiciona, una propuesta de title/meta/H1 "mejor redactada" puede quitar del title justo la consulta que trae los clics. Caso real: una reescritura de titles eliminaba la consulta principal de una guía y cambiaba la página con el mejor CTR del sitio (5,35%). Antes de dar por lista cualquier propuesta, cruzar cada página con sus consultas con clics (GSC, 90 días) y su CTR de 28 días:
| Situación de la página | Qué se cambia |
| CTR bajo o sin impresiones | Title, meta y H1, conservando en el title las palabras de las consultas con clics |
| CTR bueno | Solo la meta description (no afecta al ranking); title y H1 se mantienen |
| La de mejor rendimiento del sitio o de su grupo | No se toca |
Todo cambio deja preparada su base de seguimiento, en una sección "Seguimiento" del entregable:
- Línea base de GSC por página y por consulta antes del cambio, guardada con fecha.
- Consultas vigiladas (las que traen clics hoy).
- Páginas de control del mismo tipo que no se tocan.
- Captura del HTML (drift) para confirmar qué se publicó realmente.
- Criterio explícito para volver atrás, p. ej.: una consulta vigilada con clics baja más de 3 posiciones a 28 días sin que baje el control.
Verificación de claims antes de publicar
Cualquier afirmación específica en un title tag, meta description o H1 debe estar verificada en el sitio real antes de escribirla. Esto incluye:
- Plazos de entrega o respuesta ("en 24h", "en 48h", "respuesta inmediata")
- Precios ("desde X€", "precio especial")
- Atributos de servicio ("gratis", "garantizado", "certificado", "sin compromiso")
- Años de experiencia ("20 años de experiencia")
- Valoraciones o número de reseñas ("4.9 estrellas", "más de 500 reseñas")
- Horarios de atención
Proceso obligatorio antes de incluir cualquier claim:
- WebFetch de la URL afectada (o homepage si es claim general del negocio)
- Confirmar que el texto exacto o equivalente aparece visible en la página
- Si no aparece: usar un claim genérico verificable ("Llámenos", "Solicite información") o eliminarlo
No existe excepción por "es estándar del sector" o "es obvio que lo tienen". Si no está en el sitio, no va en el documento.
Ficha SEO — estructura obligatoria para artículos
Todo artículo de blog, página de servicio o página de tratamiento debe incluir una ficha SEO con los siguientes elementos, en este orden:
1. Metadatos básicos
- Slug (kebab-case, sin tildes, sin caracteres especiales)
- Meta title (50-60 caracteres, keyword en primeras palabras)
- Meta description (140-155 caracteres, keyword natural, CTA implícito)
- Keyword primaria
- Keywords secundarias (3-5)
2. Imágenes
- Mínimo 2 imágenes por artículo
- Alt text: keyword + localización o marca (ej. "fisioterapia deportiva madrid clínica ejemplo")
- Nombre de archivo: kebab-case sin tildes (ej.
fisioterapia-deportiva-madrid.webp) - Formato: .webp
- Tamaño máximo: 100 KB por imagen
3. Análisis keyword research — DataForSEO
- Tabla con volumen mensual, dificultad, CPC, intent
- Histórico mensual de los últimos 12 meses
- Decisión: incluir / descartar / usar como secundaria
4. Análisis keyword research — SE Ranking
- Tabla con posición actual del sitio para cada keyword
- Ajustes respecto al análisis de DataForSEO (discrepancias de volumen, keywords que SE Ranking detecta y DataForSEO no)
5. Schema FAQ JSON-LD
- Mínimo 3 pares pregunta-respuesta
- Preguntas alineadas con las PAA del SERP o las búsquedas relacionadas
- Ver skill
schema-markuppara implementación
Checklist de auditoría on-page
CRÍTICO
[ ] ¿Páginas sin title tag? (Screaming Frog > Page Titles > Missing)
[ ] ¿Páginas sin H1? (Screaming Frog > H1 > Missing)
[ ] ¿Title tags duplicados en páginas con tráfico? (Page Titles > Duplicate)
[ ] ¿H1 duplicados entre páginas que compiten por la misma keyword?
ALTO
[ ] ¿Title tags >70 caracteres? (truncados en SERP)
[ ] ¿Meta descriptions ausentes en páginas de conversión (producto, servicio, categoría)?
[ ] ¿Meta descriptions duplicadas en secciones importantes?
[ ] ¿Múltiples H1 por página? (Page Builders, themes con H1 en header)
[ ] ¿H1 del header del theme aplicándose en todas las páginas?
MEDIO
[ ] ¿Keyword principal en las primeras palabras del title?
[ ] ¿Meta descriptions >160 caracteres? (truncadas)
[ ] ¿Meta descriptions <70 caracteres? (infrautilizadas)
[ ] ¿H1 coherente con el title tag (misma keyword, diferentes formulaciones)?
[ ] ¿WooCommerce/PrestaShop: productos con title = solo nombre de producto sin keyword?
[ ] ¿GSC: páginas con >100 impresiones y CTR <2% en posición 1-5? → title candidato a mejora
BAJO
[ ] ¿Separador del title configurado correctamente en el plugin SEO?
[ ] ¿Estructura jerárquica de headings (H1 > H2 > H3) sin saltos?
[ ] ¿Title tag contiene el nombre de la marca? (recomendado para brand queries)Referencias
- Cómo Google usa los titles: https://developers.google.com/search/docs/appearance/title-link
- Meta description: https://developers.google.com/search/docs/appearance/snippet
- Headings y estructura: https://developers.google.com/search/docs/fundamentals/seo-starter-guide
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

