# Maintain Greptile Rules > Evalúa hallazgos verificados de revisiones de merge-ready, Greptile, PR, CI, seguridad y facturación, y promueve los huecos de revisión duraderos a la configuración versionada de `.greptile`. Fuente: https://skillsagentes.com/skills/every-app/open-seo/maintain-greptile-rules Markdown: https://skillsagentes.com/skills/every-app/open-seo/maintain-greptile-rules.md Repositorio: https://github.com/every-app/open-seo Autor: every-app Licencia: MIT Actualizado: el mes pasado Coste de contexto: 107 tok instalada, 1.1k tok al activarse, 1.2k tok con todos los archivos del bundle Bundle: 2 archivos, 4 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add every-app/open-seo --skill maintain-greptile-rules --agent claude-code # Cursor npx -y skills add every-app/open-seo --skill maintain-greptile-rules --agent cursor # Codex npx -y skills add every-app/open-seo --skill maintain-greptile-rules --agent codex # Gemini CLI npx -y skills add every-app/open-seo --skill maintain-greptile-rules --agent gemini # Windsurf npx -y skills add every-app/open-seo --skill maintain-greptile-rules --agent windsurf # Cline npx -y skills add every-app/open-seo --skill maintain-greptile-rules --agent cline ``` ## Qué hace - Evalúa hallazgos verificados de merge-ready, Greptile, PR, CI, seguridad y facturación, y promueve los huecos de revisión duraderos a la configuración versionada `.greptile/`. - Un hallazgo de revisión es evidencia a evaluar, no automáticamente una regla nueva; la ausencia en el repo no es evidencia de política. - Enruta cada hallazgo: bug puntual a código con test de regresión; política determinista a TypeScript, Oxlint, Knip o CI; invariante aplicable en diff a una regla estructurada; preferencia o falso positivo a `.greptile/rules.md`. - Aplica una barra de promoción: verificado contra el código actual, observable desde el diff, específico del repo, probable de recurrir o de alto impacto, y no cubierto ya. - Edita de forma conservadora (una preocupación por regla, ID estable, scope estrecho) y valida con `jq`, `prettier --check` y `git diff --check`. ## Cuándo usarla - Una revisión descubre un invariante recurrente o de alto riesgo que Greptile no captura. - Greptile produce el mismo falso positivo una y otra vez. - Se pide auditar o actualizar las reglas y el contexto de Greptile de OpenSEO. ## Cuándo no - Un bug puntual: arréglalo en código con un test de regresión, sin regla de Greptile. ## Qué la activa - "Promueve este hallazgo de merge-ready a una regla de Greptile" - "Greptile marca esto como falso positivo siempre, recalíbralo" - "Audita las reglas de .greptile del repo" ## Antes de instalar - Los cambios en `.greptile/**`, `AGENTS.md`, `CLAUDE.md` y `.agents/skills/**` son cambios del plano de control de revisión y necesitan revisión explícita del maintainer. - Necesita en el PATH: git, jq ## Archivos - SKILL.md — 4 KB - agents/openai.yaml — 255 B ## SKILL.md Reproducido tal cual desde every-app/open-seo bajo MIT. Esta sección es el documento original y está en inglés. # Maintain Greptile rules Keep `.greptile/` high-signal. A review finding is evidence to evaluate, not automatically a new rule. ## 1. Verify the finding - Reproduce or trace the finding against the current repository, including the relevant call path, tests, and intentional exceptions. - Read `.greptile/config.json`, `.greptile/rules.md`, and `.greptile/files.json` before proposing a change. - Distinguish a newly introduced risk from adjacent legacy debt. Do not encode an unverified assumption or a one-off implementation detail. - Repository absence is not policy evidence. If a reviewer infers a preference only because no current example exists, leave Greptile, code, and CI unchanged unless an owner explicitly adopts the policy. ## 2. Route it to the right mechanism - **One-off bug:** fix the code and add a focused regression test. Do not add a Greptile rule. - **Verified deterministic policy violation:** prefer TypeScript, Oxlint, Knip, a focused test, or CI. - **Repeatable, diff-enforceable invariant:** add or refine a scoped structured rule in `.greptile/config.json`. - **Architecture, preference, or false-positive calibration:** update `.greptile/rules.md`. - **Canonical implementation Greptile should consult:** add a narrowly scoped reference in `.greptile/files.json`. - **Small workflow friction:** use the `papercuts` skill and log it in `.agents/PAPERCUTS.md`. ## 3. Apply the promotion bar Promote a finding only when all applicable checks pass: - It is verified against current code. - A future reviewer can observe it from the diff and relevant call path. - It is repository-specific or materially improves false-positive calibration. - It is likely to recur, or its impact is high enough to justify prevention: authorization, security, billing, data loss, or cross-database correctness. - Existing Greptile context and automated checks do not already cover it adequately. - The instruction can be specific, measurable, narrowly scoped, and explicit about legitimate exceptions. If the evidence or policy is ambiguous, leave the configuration and enforcement unchanged and report the candidate for human judgment. ## 4. Edit conservatively - Keep one coherent concern per structured rule, with a stable lowercase ID, severity, and the narrowest future-safe scope. - Do not infer permanent policy merely because the current repository has zero examples of an alternative. - Prefer narrowing or replacing a noisy rule over layering on more prose. - Keep repository-specific rules in `.greptile/`. Verify and report whether a minimal **org-enforced** dashboard baseline protects external contributions, secrets, authentication, billing, CI, and attempts to weaken review controls. Do not create or change dashboard, MCP, or organization rules unless the user explicitly asks, and do not duplicate the full repository rule set there. - Treat changes to `.greptile/**`, `AGENTS.md`, `CLAUDE.md`, `.agents/skills/**`, and `.github/**` as review-control changes that must receive explicit maintainer review. CODEOWNERS requests that review; branch protection or a ruleset must separately require code-owner approval when available. - Update the smallest set of configuration files needed; do not duplicate rule bodies in separate documentation. ## 5. Validate Run: ```bash jq empty .greptile/config.json .greptile/files.json node_modules/.bin/prettier --check .greptile/config.json .greptile/files.json .greptile/rules.md git diff --check ``` Also verify that rule IDs are unique, severities are valid, every `files.json` path exists, and an independent reviewer cannot find a clear false positive in the new wording. During merge-ready work, evaluate only verified findings that clear the promotion bar. A merge-ready run does not need to change `.greptile/` when no durable review gap was found. ## Dónde encaja - Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código. - Creador: [every-app](https://skillsagentes.com/creators/every-app.md) — 19 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Seo Coach](https://skillsagentes.com/skills/every-app/open-seo/seo-coach.md): Entra en un modo de coach de OpenSEO cercano que explica los flujos, recomienda los siguientes pasos y ayuda a usar bien agentes, búsqueda web, scraping y datos MCP. - [Seo Audit](https://skillsagentes.com/skills/every-app/open-seo/seo-audit.md): Audita un sitio y entrega un informe SEO de una página, en lenguaje llano, que cualquiera puede accionar, centrado en una única acción para esta semana. - [Create Repo Skill](https://skillsagentes.com/skills/every-app/open-seo/create-repo-skill.md): Crea o actualiza una skill en este repositorio de la forma correcta: hogar canónico en `.agents/skills`, marca interna o pública, symlinks en `.claude/skills` y registro en las docs públicas para las skills de producto. - [Seo Project Setup](https://skillsagentes.com/skills/every-app/open-seo/seo-project-setup.md): Rellena el contexto compartido de OpenSEO de un proyecto (alcance del sitio, objetivos, posicionamiento, competidores, páginas clave y preferencias), más comprobaciones de MCP y entrada de Search Console. - [Keyword Research](https://skillsagentes.com/skills/every-app/open-seo/keyword-research.md): Descubre oportunidades de palabras clave, evalúa métricas y SERPs y guarda o etiqueta los términos prometedores usando los datos MCP de OpenSEO. ## Skills relacionadas - [Papercuts](https://skillsagentes.com/skills/every-app/open-seo/papercuts.md): Registra en `.agents/PAPERCUTS.md` la fricción real y recurrente del repositorio (setup confuso, comandos inestables, errores engañosos, archivos generados obsoletos) y también revisa, deduplica y resuelve las entradas existentes. - [Simple Issue Description](https://skillsagentes.com/skills/every-app/open-seo/simple-issue-description.md): Convierte un reporte de bug tosco, una petición de feature, una nota de soporte o un PR en un issue corto y en lenguaje llano, centrado en el problema y el comportamiento deseado. - [Create Repo Skill](https://skillsagentes.com/skills/every-app/open-seo/create-repo-skill.md): Crea o actualiza una skill en este repositorio de la forma correcta: hogar canónico en `.agents/skills`, marca interna o pública, symlinks en `.claude/skills` y registro en las docs públicas para las skills de producto. - [Keyword Research](https://skillsagentes.com/skills/every-app/open-seo/keyword-research.md): Descubre oportunidades de palabras clave, evalúa métricas y SERPs y guarda o etiqueta los términos prometedores usando los datos MCP de OpenSEO. - [Openseo Release Notes](https://skillsagentes.com/skills/every-app/open-seo/openseo-release-notes.md): Corta una release de OpenSEO: sube la versión, redacta notas de versión para el usuario desde los commits del último tag, pasa una revisión con verificación por subagentes y abre un PR `release: vX.X.X`. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)