agentleFS
carlosuhartcarlosuhart/seo-audit-skills/skills/seo-quote/SKILL.md

seo-quote

Skill6 starsChanged 15 days agoMITView on GitHub

Genera un informe .docx de auditoría con cotización en USD para propuestas comerciales: datos mínimos del sitio, horas estimadas y presupuesto. Usar con "cotización SEO", "presupuesto SEO" o "/seo-quote".

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No es una auditoría completa: es la exploración mínima suficiente para justificar un diagnóstico, definir un scope de trabajo y calcular un …

    line 14
  2. Very specific:

    No bloquea recursos CSS/JS críticos ni el raíz /

    line 74
  3. Distinctive:

    No preguntar por datos si se pueden obtener en Fase 1.

    line 401

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

SEO Quote Report Generator

Genera un informe-propuesta SEO en .docx listo para entregar a un cliente potencial. No es una auditoría completa: es la exploración mínima suficiente para justificar un diagnóstico, definir un scope de trabajo y calcular un presupuesto creíble.


Parámetros de entrada

ParámetroDefaultDescripción
<url>requeridoURL raíz del sitio a auditar
--rate60Tarifa hora en USD
--langesIdioma del documento (es / en)

Fase 1: Recolección de datos mínimos

Ejecutar en este orden. Detener y reportar si una fuente falla; continuar con las demás.

1.1 Volumen del sitio (sitemap)

GET <url>/sitemap.xml
GET <url>/sitemap_index.xml   (si el anterior falla o es índice)
GET <url>/post-sitemap.xml    (WordPress)
GET <url>/page-sitemap.xml    (WordPress)

Extraer:

  • Total de URLs indexadas (suma de todos los sitemaps)
  • Desglose por tipo: posts, páginas, categorías, productos (si aplica)
  • Fecha del lastmod más reciente y más antiguo (señal de frecuencia de publicación)

Si no hay sitemap: registrar como issue crítico y estimar volumen desde robots.txt o crawl de homepage.

1.2 Stack tecnológico (homepage)

WebFetch de <url> (homepage). Detectar:

  • CMS (WordPress, PrestaShop, Shopify, Wix, custom)
  • Plugin SEO activo (Rank Math, Yoast, AIOSEO, The SEO Framework, ninguno)
  • Cache/CDN (LiteSpeed Cache, WP Rocket, Cloudflare, W3 Total Cache)
  • Constructor de páginas (Divi, Elementor, Gutenberg, otro)
  • Advertising (Advanced Ads, AdSense, Mediavine, etc.)
  • Analytics/Tag Manager (GA4, GTM, Site Kit)

Señales de detección:

  • X-Powered-By, Server headers
  • Clases CSS: elementor-, et_pb_, wp-block-
  • Paths: /wp-content/, /wp-json/, /modules/, cdn.shopify.com
  • Meta generators

1.3 robots.txt

GET <url>/robots.txt

Verificar:

  • Existe y es accesible
  • Referencia al sitemap principal
  • No bloquea recursos CSS/JS críticos ni el raíz /
  • Reglas de AI crawlers presentes/ausentes (GPTBot, ClaudeBot, PerplexityBot)

1.4 Señales on-page homepage

Desde el WebFetch de 1.2, extraer:

  • <title> tag (presente/ausente, longitud)
  • <meta name="description"> (presente/ausente, longitud)
  • H1 (presente/ausente, texto)
  • Canonical (apunta a sí mismo o a otra URL)
  • <meta name="robots"> si existe
  • OG tags presentes (og:title, og:description, og:image)
  • Schema JSON-LD: listar @types detectados

1.5 Core Web Vitals (DataForSEO o PageSpeed)

Si DataForSEO MCP disponible: on_page_lighthouse sobre la homepage. Si no: WebFetch de https://pagespeed.web.dev/report?url=<url> para extraer scores visibles.

Registrar:

  • Performance score (Lighthouse)
  • LCP, INP/FID, CLS valores si visibles
  • Mobile vs Desktop si hay diferencia notable

1.6 Autoridad de dominio (DataForSEO backlinks)

Si DataForSEO MCP disponible: backlinks_summary para el dominio raíz.

Extraer:

  • Referring domains
  • Backlinks total
  • Rank (DataForSEO Rank o similar)

Si no disponible: omitir sección en el documento o indicar "datos pendientes de herramienta de backlinks".


Fase 2: Clasificación de complejidad

Asignar el sitio a uno de tres tiers basándose en los datos recolectados.

Tier A — Sitio pequeño / simple

  • Menos de 100 URLs en sitemap
  • CMS estándar (WordPress básico, Wix, Squarespace)
  • Sin plugin SEO activo o configuración mínima
  • Sin e-commerce
  • Performance score ≥ 70 mobile

Tier B — Sitio mediano / estándar

  • 100–1.000 URLs
  • WordPress con plugin SEO (Rank Math, Yoast)
  • Page builder activo (Elementor, Divi)
  • CDN/cache presente pero con posibles conflictos
  • E-commerce pequeño (WooCommerce < 500 productos)
  • Performance score 50–70 mobile

Tier C — Sitio grande / complejo

  • Más de 1.000 URLs
  • Stack complejo (múltiples plugins de cache, ads, analytics, builders)
  • E-commerce grande (>500 productos) o multiidioma (hreflang)
  • Performance issues críticos (score < 50 mobile)
  • Problemas de indexación detectados
  • Presencia en múltiples mercados/idiomas

Fase 3: Detección de issues

Catalogar cada issue encontrado en Fase 1 asignando:

  • Criticidad: Crítico / Alto / Medio / Bajo
  • Descripción: qué se detectó
  • Impacto SEO: por qué importa (en una línea, lenguaje no técnico)
  • Horas estimadas de corrección: ver tabla de horas

Tabla de issues frecuentes y horas por tier

IssueCriticidadHoras Tier AHoras Tier BHoras Tier C
Sin sitemap XMLCrítico123
robots.txt mal configuradoCrítico112
Sin plugin SEO activoCrítico235
Sin schema markupAlto248
Meta descriptions ausentes/duplicadas (bulk)Alto2614
Títulos fuera de rango o duplicados (bulk)Alto2614
Sin H1 o H1 incorrecto (bulk)Alto2410
Core Web Vitals en rojo (LCP/INP/CLS)Alto4816
Sin HTTPS o mixed contentCrítico235
Headers de seguridad ausentesMedio123
Redirect chains (3+ hops)Alto248
Páginas huérfanas significativasMedio248
Imágenes sin alt text (bulk)Medio138
Contenido delgado (< 300 palabras) en páginas claveAlto3820
Sin canonical en páginas de listado/paginaciónMedio124
AI crawlers sin gestionar (robots.txt)Bajo112
Sin llms.txt (GEO/visibilidad en AI Search)Bajo123
E-E-A-T débil (sin autor, sin about, sin trust signals)Alto3610
Hreflang ausente en sitio multiidiomaCrítico4816

Para issues no listados: estimar horas con el criterio de complejidad del tier + factor de volumen de páginas afectadas.


Fase 4: Plan de trabajo

Organizar las acciones en 3 fases temporales. Cada fase tiene un objetivo y un conjunto de acciones.

Estructura del plan

Fase 1 — Fundamentos técnicos (semanas 1–2) Acciones críticas y altas que bloquean el SEO base: sitemap, robots.txt, redirects, HTTPS, schema básico, plugin SEO configurado. Sin esta fase, el resto del trabajo no tiene tracción.

Fase 2 — Optimización on-page y contenido (semanas 3–6) Optimización de titles, meta descriptions, H1, imágenes. Mejora de contenido en páginas prioritarias (las que ya rankean o tienen potencial alto). Interlinking.

Fase 3 — Autoridad y visibilidad AI (semanas 7–12) Link building, schema avanzado (FAQ, Article, Organization), GEO (llms.txt, AI crawler policy, structured data para AI citation), reporting mensual.

Ajustar el cronograma si el tier es A (compresión posible a 6 semanas) o C (extensión a 16–20 semanas).


Fase 5: Cálculo de presupuesto

Servicios contemplados

Construir una tabla de servicios con horas por servicio basándose en los issues detectados y el tier.

ServicioDescripciónHorasTarifa (USD/h)Total (USD)
Auditoría SEO técnica inicialRevisión completa del estado técnicoXrate$
Configuración plugin SEOSetup completo Rank Math / YoastXrate$
Optimización on-page (bulk)Titles, metas, H1 en N páginas prioritariasXrate$
Schema markupImplementación tipos claveXrate$
Core Web VitalsDiagnóstico y correcciones de performanceXrate$
Optimización de contenidoMejora de N artículos existentesXrate$
InterlinkingAnálisis y ejecución de links internosXrate$
GEO / AI Search Visibilityllms.txt, AI crawlers, structured data GEOXrate$
Seguimiento mensualReporting + ajustes + monitorizaciónXrate$

Solo incluir los servicios pertinentes para los issues detectados. No inflar con servicios que no aplican.

Cálculo de horas por volumen de sitio

Para optimizaciones bulk (titles, metas, contenido), usar esta escala:

  • 1–50 páginas: horas base del issue
  • 51–200 páginas: horas base × 2,5
  • 201–500 páginas: horas base × 5
  • 501–1.000 páginas: horas base × 8
  • 1.000 páginas: horas base × 12 + evaluar automatización/scripting (descuento 30% si se aplica scripting)

Totales

  • Total horas proyecto: suma
  • Total presupuesto (USD): horas × tarifa
  • Opción mantenimiento mensual: horas mensuales × tarifa
  • Forma de pago sugerida: 50% inicio / 50% entrega (one-time) o mensual (mantenimiento)

Usar formato numérico europeo en el documento: punto para miles, coma para decimales. En código Python interno usar float estándar; solo formatear al escribir el documento.


Fase 6: Generación del documento .docx

Generar un script Python con python-docx y ejecutarlo. Guardar en <directorio-de-auditorias>/<cliente>/cotizacion-seo-<slug-dominio>-<YYYY-MM-DD>.docx.

Crear el directorio si no existe.

Estructura del documento

1. Portada
   - Título: "Diagnóstico SEO y Propuesta de Trabajo"
   - Subtítulo: <nombre del sitio> | <fecha>
   - Preparado para: [nombre cliente si disponible]
   - Preparado por: Zythos Media

2. Resumen ejecutivo (1 página)
   - Estado actual: tier + score resumen
   - Issues críticos detectados: N (lista breve)
   - Oportunidad estimada: descripción cualitativa del potencial
   - Inversión total: USD X.XXX

3. Situación actual del sitio
   3.1 Datos generales
       - URL, CMS, stack tecnológico
       - Volumen: N URLs indexadas (posts, páginas, otros)
       - Frecuencia de publicación (estimada)
       - Autoridad de dominio (si disponible)
   3.2 Core Web Vitals
       - Tabla LCP / INP / CLS + valoración pass/warn/fail
   3.3 Visibilidad en búsqueda (si hay datos GSC disponibles)

4. Problemas detectados
   Tabla con columnas: Prioridad | Problema | Impacto | Solución propuesta
   Ordenar de Crítico a Bajo.
   Lenguaje orientado al cliente, no técnico.

5. Plan de trabajo
   5.1 Fase 1 — Fundamentos técnicos
   5.2 Fase 2 — Optimización on-page y contenido
   5.3 Fase 3 — Autoridad y visibilidad AI
   Cada fase: objetivo, acciones, entregables esperados.

6. Cronograma
   Tabla: Fase | Actividad | Semanas | Responsable

7. Presupuesto
   Tabla de servicios con horas y costes.
   Totales bien delimitados.
   Nota de condiciones de pago.

8. Próximos pasos
   3 bullets claros: qué debe hacer el cliente para arrancar.

Estilos del documento

  • Fuente cuerpo: Calibri 11
  • Fuente títulos: Calibri 14 (sección), 12 (subsección), bold
  • Tabla issues: header fila oscura (#1F4E79), texto blanco; filas alternas blancas y #D6E4F0
  • Tabla presupuesto: header fila oscura (#1F4E79), texto blanco; fila total en bold con fondo #E8F5E9
  • Sin emojis. Sin bullet points estilo ChatGPT. Prosa directa.

Plantilla Python base

from docx import Document
from docx.shared import Pt, RGBColor, Inches, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.oxml.ns import qn
from docx.oxml import OxmlElement
from datetime import datetime
import os

def fmt_usd(value):
    """Formato europeo: 1.234,50"""
    s = f"{value:,.2f}"
    return s.replace(",", "X").replace(".", ",").replace("X", ".")

def add_table_row(table, cells, bold=False, bg_color=None, text_color=None):
    row = table.add_row()
    for i, text in enumerate(cells):
        cell = row.cells[i]
        cell.text = str(text)
        run = cell.paragraphs[0].runs[0] if cell.paragraphs[0].runs else cell.paragraphs[0].add_run(str(text))
        run.font.size = Pt(10)
        run.bold = bold
        if text_color:
            run.font.color.rgb = RGBColor(*text_color)
        if bg_color:
            tc = cell._tc
            tcPr = tc.get_or_add_tcPr()
            shd = OxmlElement('w:shd')
            shd.set(qn('w:fill'), bg_color)
            shd.set(qn('w:val'), 'clear')
            tcPr.append(shd)
    return row

# --- Datos del sitio (completar con los datos recolectados) ---
DATOS = {
    "url": "https://www.debosaber.cl",
    "nombre": "DeboSaber.cl",
    "cms": "WordPress",
    "plugin_seo": "Rank Math",
    "cache": "LiteSpeed Cache",
    "constructor": "Gutenberg",
    "urls_total": 710,
    "urls_posts": 710,
    "urls_paginas": 0,
    "tier": "C",
    "tarifa": 60,
    "fecha": datetime.now().strftime("%d/%m/%Y"),
    "cliente": "DeboSaber.cl",
    "preparado_por": "Zythos Media",
}

ISSUES = [
    # (prioridad, problema, impacto, solucion, horas)
    ("Crítico", "Sin sitemap XML activo", "Google no puede descubrir ni rastrear las páginas eficientemente", "Activar y configurar sitemap en Rank Math", 2),
    ("Alto", "Meta descriptions duplicadas o ausentes en >50% de posts", "El buscador genera snippets automáticos que no invitan al clic", "Optimización bulk de meta descriptions en posts prioritarios", 14),
    # ... más issues
]

SERVICIOS = [
    # (servicio, descripcion, horas, tarifa)
    ("Auditoría SEO técnica inicial", "Revisión completa del estado técnico con informe detallado", 8, DATOS["tarifa"]),
    ("Optimización on-page bulk", f"Titles, metas y H1 en {DATOS['urls_posts']} posts", 28, DATOS["tarifa"]),
    # ... más servicios
]

# --- Generación del documento ---
doc = Document()

# Estilos globales
style = doc.styles['Normal']
style.font.name = 'Calibri'
style.font.size = Pt(11)

# ... (código completo del documento)

output_path = f"<directorio-de-auditorias>/{DATOS['nombre'].lower().replace('.', '-')}/cotizacion-seo-{DATOS['nombre'].lower().replace('.', '-')}-{datetime.now().strftime('%Y-%m-%d')}.docx"
os.makedirs(os.path.dirname(output_path), exist_ok=True)
doc.save(output_path)
print(f"Documento guardado: {output_path}")

El script real generado debe estar completamente funcional y rellenar todos los datos recolectados en las fases 1–5.


Output final esperado

  1. El documento .docx guardado en <directorio-de-auditorias>/<cliente>/cotizacion-seo-<slug>-<fecha>.docx
  2. En el chat: resumen de 5 líneas con:
    • Tier asignado
    • Issues críticos detectados (N)
    • Total horas estimadas
    • Presupuesto total (USD, formato europeo)
    • Ruta del archivo generado

Notas de comportamiento

  • No preguntar por datos si se pueden obtener en Fase 1. Solo preguntar si una fuente crítica falla y no hay alternativa.
  • Si DataForSEO no está disponible, omitir esas secciones del documento con nota "Datos pendientes de herramienta de backlinks".
  • El documento va dirigido al cliente, no al equipo técnico. Lenguaje claro, sin jerga SEO innecesaria.
  • Nunca inventar datos de tráfico, rankings o backlinks sin fuente verificada.
  • Si el usuario proporciona datos GSC o de ranking, incorporarlos en la sección "Visibilidad en búsqueda".
  • Formato numérico europeo en todo el documento (punto miles, coma decimales).
  • Actualizar CLAUDE.md del proyecto si se identifica información nueva del cliente durante la ejecución.

Reglas de cálculo de horas — verificación interna

Antes de escribir el presupuesto, verificar que las horas sean coherentes con el tier:

TierRango total horas típico (proyecto inicial)
A12–30 horas
B30–80 horas
C80–200 horas

Si el total calculado cae fuera del rango, revisar los multiplicadores de volumen antes de ajustar la tarifa.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.