ASD

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
44.1k

en todo el repo

Actividad
45

0–100, la ruta de este skill

Actualizado
hace 3 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 49 skills. Si instalas uno, normalmente ya tienes los demás.

Úsalo para generar, iterar o escalar creatividad publicitaria —titulares, descripciones, texto primario o variaciones completas— en cualquier plataforma de pago.

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

Ads

44.1k

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

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

Pricing

44.1k

Para decisiones de pricing, packaging o monetización: tiers, freemium, prueba gratuita, aumentos de precio, valor percibido y auditorías de páginas de pricing para humanos y agentes de IA.

Costo de contexto al activarse
2.3k tok
Tamaño del paquete
5 archivos
Última actualización
hace 17 días
marketing

Social

44.1k

Ayuda a crear, programar y optimizar contenido de redes sociales para LinkedIn, Twitter/X, Instagram, TikTok o Facebook, y a hacer escucha social y triage de engagement.

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

Para cuando el usuario quiere saber qué marketing impulsa realmente conversiones e ingresos, elegir un modelo de atribución o reconciliar cifras contradictorias entre herramientas.

Costo de contexto al activarse
5.2k tok
Tamaño del paquete
6 archivos
Última actualización
hace 21 días
datos analitica

Para montar un flujo de marketing recurrente y autoejecutable que un agente corre en una cadencia, en vez de una tarea puntual; orquesta otras skills de marketing como un loop siempre activo.

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

Skills relacionados

Launch

44.1k

Úsalo cuando el usuario quiera planear un lanzamiento de producto, anuncio de feature o estrategia de release, incluyendo Product Hunt, beta launch, early access o waitlist.

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

Para cuando el usuario quiere encontrar partners de co-marketing, planear campañas conjuntas o hacer brainstorming de oportunidades de partnership.'

Costo de contexto al activarse
2.5k tok
Tamaño del paquete
2 archivos
Última actualización
hace 3 meses
marketing

Escribe cold emails B2B y secuencias de seguimiento que generan respuestas: asuntos, aperturas, cuerpo, CTAs, personalización y secuencias multi-touch.

Costo de contexto al activarse
1.8k tok
Tamaño del paquete
7 archivos
Última actualización
hace 2 meses
marketing