Skills Agentes

Schema

Para cuando quieras añadir, corregir u optimizar schema markup y datos estructurados: JSON-LD, rich snippets, FAQ schema, product schema, breadcrumb schema y resultados enriquecidos en Google.

Estrellas
51k

en todo el repo

Actividad
41

0–100, la ruta de este skill

Actualizado
hace 4 meses

último commit aquí

Commits
0

últimos 90 días

Contexto
1.3k tok

132 tok en reposo

Paquete
3 archivos

19 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add coreyhaines31/marketingskills --skill schema --agent claude-code

Se instala solo en este repositorio.

Este skill makes network requests.

Qué hace

  • Implementa marcado schema.org en formato JSON-LD para habilitar rich results en Google
  • Revisa el contexto de product-marketing.md antes de pedir información al usuario
  • Recomienda tipos de schema según el tipo de página (Organization, Article, Product, FAQPage, etc.)
  • Valida el schema con Google Rich Results Test y Schema.org Validator
  • Combina múltiples tipos de schema en una página usando @graph

Úsalo cuando

  • El usuario quiere añadir, corregir u optimizar schema markup o datos estructurados
  • Se mencionan términos como JSON-LD, rich snippets, FAQ schema, product schema o knowledge panel
  • Se busca que las páginas muestren resultados enriquecidos en Google

No lo uses cuando

  • Para problemas de SEO más amplios (usar seo-audit)
  • Para optimización de búsqueda con IA (usar ai-seo)

Qué lo activa

Di cualquiera de estas frases y el agente debería cargar este skill.

  • “Ayúdame a añadir schema FAQ a esta página”
  • “Necesito implementar structured data para mis productos”
  • “Quiero que mi blog muestre rich snippets en Google”
  • “Revisa si mi schema.org tiene errores de validación”

SKILL.md

En inglés

Schema Markup

You are an expert in structured data and schema markup. Your goal is to implement schema.org markup that helps search engines understand content and enables rich results in search.

Initial Assessment

Check for product marketing context first: If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Before implementing schema, understand:

  1. Page Type - What kind of page? What's the primary content? What rich results are possible?

  2. Current State - Any existing schema? Errors in implementation? Which rich results already appearing?

  3. Goals - Which rich results are you targeting? What's the business value?


Core Principles

1. Accuracy First

  • Schema must accurately represent page content
  • Don't markup content that doesn't exist
  • Keep updated when content changes

2. Use JSON-LD

  • Google recommends JSON-LD format
  • Easier to implement and maintain
  • Place in <head> or end of <body>

3. Follow Google's Guidelines

  • Only use markup Google supports
  • Avoid spam tactics
  • Review eligibility requirements

4. Validate Everything

  • Test before deploying
  • Monitor Search Console
  • Fix errors promptly

Common Schema Types

Type Use For Required Properties
Organization Company homepage/about name, url
WebSite Homepage (search box) name, url
Article Blog posts, news headline, image, datePublished, author
Product Product pages name, image, offers
SoftwareApplication SaaS/app pages name, offers
FAQPage FAQ content mainEntity (Q&A array)
HowTo Tutorials name, step
BreadcrumbList Any page with breadcrumbs itemListElement
LocalBusiness Local business pages name, address
Event Events, webinars name, startDate, location

For complete JSON-LD examples: See references/schema-examples.md


Quick Reference

Organization (Company Page)

Required: name, url Recommended: logo, sameAs (social profiles), contactPoint

Article/BlogPosting

Required: headline, image, datePublished, author Recommended: dateModified, publisher, description

Product

Required: name, image, offers (price + availability) Recommended: sku, brand, aggregateRating, review

FAQPage

Required: mainEntity (array of Question/Answer pairs)

BreadcrumbList

Required: itemListElement (array with position, name, item)


Multiple Schema Types

You can combine multiple schema types on one page using @graph:

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", ... },
    { "@type": "WebSite", ... },
    { "@type": "BreadcrumbList", ... }
  ]
}

Validation and Testing

Tools

Common Errors

Missing required properties - Check Google's documentation for required fields

Invalid values - Dates must be ISO 8601, URLs fully qualified, enumerations exact

Mismatch with page content - Schema doesn't match visible content


Implementation

Static Sites

  • Add JSON-LD directly in HTML template
  • Use includes/partials for reusable schema

Dynamic Sites (React, Next.js)

  • Component that renders schema
  • Server-side rendered for SEO
  • Serialize data to JSON-LD

CMS / WordPress

  • Plugins (Yoast, Rank Math, Schema Pro)
  • Theme modifications
  • Custom fields to structured data

Output Format

Schema Implementation

// Full JSON-LD code block
{
  "@context": "https://schema.org",
  "@type": "...",
  // Complete markup
}

Testing Checklist

  • Validates in Rich Results Test
  • No errors or warnings
  • Matches page content
  • All required properties included

Task-Specific Questions

  1. What type of page is this?
  2. What rich results are you hoping to achieve?
  3. What data is available to populate the schema?
  4. Is there existing schema on the page?
  5. What's your tech stack?

Related Skills

  • seo-audit: For overall SEO including schema review
  • ai-seo: For AI search optimization (schema helps AI understand content)
  • programmatic-seo: For templated schema at scale
  • site-architecture: For breadcrumb structure and navigation schema planning

Reproducido de coreyhaines31/marketingskills bajo licencia MIT. Leer esta página en markdown.

Archivos

3 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

Antes de instalar

Opcionalmente puede leer .agents/product-marketing.md (o .claude/product-marketing.md) si existe para obtener contexto previo.

Detalles

Categoría
SEO y GEO
Licencia
MIT
Recursos incluidos
referencias
Código fuente
Ver SKILL.md

Etiquetas

Más de coreyhaines31/marketingskills

Este repo incluye 50 skills. Si instalas uno, normalmente ya tienes los demás. Ver el pack marketingskills entero y su comando de instalación

Para generar, iterar o escalar creatividad publicitaria —headlines, descripciones, primary text o variaciones completas— en cualquier plataforma de anuncios pagos.

Costo de contexto al activarse
5.8k tok
Tamaño del paquete
13 archivos
Última actualización
el mes pasado
marketing

Ads

51k

Para campañas de publicidad de pago en Google Ads, Meta, LinkedIn, Twitter/X y otras plataformas: estrategia de campaña, targeting de audiencias, bidding y optimización.

Costo de contexto al activarse
7.1k tok
Tamaño del paquete
16 archivos
Última actualización
el mes pasado
marketing

Úsalo cuando el usuario quiera optimizar contenido para motores de IA, ser citado por LLMs o aparecer en respuestas generadas por IA (AEO, GEO, llms.txt, agent readiness, etc.).

Costo de contexto al activarse
7.4k tok
Tamaño del paquete
10 archivos
Última actualización
hace 20 días
seo geo

Para decisiones de pricing, packaging o monetización, incluidas auditorías de pricing page (legibilidad humana y por agentes de IA); ver paywalls para upgrades in-app y offers para ofertas de servicios/cursos.

Costo de contexto al activarse
3.3k tok
Tamaño del paquete
6 archivos
Última actualización
el mes pasado
marketing

Úsalo para planificar una estrategia de contenido, decidir qué crear o definir pilares, clusters de temas y calendario editorial, no para redactar piezas individuales.

Costo de contexto al activarse
4.7k tok
Tamaño del paquete
4 archivos
Última actualización
el mes pasado
redaccion contenido

Úsalo para escribir, reescribir o mejorar copy de marketing de cualquier página: homepage, landing, pricing, features o about, incluyendo headlines, CTAs y propuestas de valor.

Costo de contexto al activarse
2.1k tok
Tamaño del paquete
4 archivos
Última actualización
el mes pasado
redaccion contenido

Skills relacionados

Úsalo cuando el usuario quiera optimizar contenido para motores de IA, ser citado por LLMs o aparecer en respuestas generadas por IA (AEO, GEO, llms.txt, agent readiness, etc.).

Costo de contexto al activarse
7.4k tok
Tamaño del paquete
10 archivos
Última actualización
hace 20 días
seo geo

Cuando el usuario quiere crear páginas orientadas a SEO a escala usando plantillas y datos, como páginas de directorio, ubicación, comparación o integración (pSEO).

Costo de contexto al activarse
1.8k tok
Tamaño del paquete
3 archivos
Última actualización
hace 4 meses
seo geo

Para cuando el usuario quiere auditar, revisar o diagnosticar problemas de SEO técnico, on-page, de velocidad, indexación o rankings en su sitio.

Costo de contexto al activarse
4.2k tok
Tamaño del paquete
4 archivos
Última actualización
el mes pasado
seo geo