{
  "id": "diagnosing-bugs",
  "handle": "diagnosing-bugs",
  "canonicalUrl": "https://bestskillsforclaude.com/es/skills/diagnosing-bugs",
  "language": "es",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/diagnosing-bugs",
    "es": "https://bestskillsforclaude.com/es/skills/diagnosing-bugs",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/diagnosing-bugs",
    "ja": "https://bestskillsforclaude.com/ja/skills/diagnosing-bugs"
  },
  "category": {
    "id": "build-and-ship",
    "name": "Construir y publicar"
  },
  "publisher": {
    "name": "Matt Pocock",
    "url": "https://github.com/mattpocock"
  },
  "source": "https://github.com/mattpocock/skills",
  "documentation": null,
  "licenseAsStated": "MIT",
  "runtime": "Claude Code and agents that support the skills CLI",
  "lastReviewed": "2026-08-05",
  "headline": "¿Por qué los arreglos de un agente arreglan tantas veces lo que no era?",
  "summary": "Porque hay un arreglo plausible disponible mucho antes de entender la causa.",
  "verdict": "La skill diagnosing-bugs separa el diagnóstico de la reparación: entender qué ocurre, demostrarlo y solo entonces cambiar código. Ataca directamente el fallo más caro de la depuración asistida por agentes, que es un parche confiado sobre un síntoma que esconde el defecto real.",
  "bestFor": "Fallos que ya sobrevivieron a un intento de arreglo, y todo lo intermitente.",
  "skipIf": "El fallo es obvio y local, donde la ceremonia cuesta más de lo que ahorra.",
  "keyTakeaways": [
    "Diagnosticar y reparar son trabajos distintos. Mezclarlos es como se publican parches de síntoma.",
    "Dar tu teoría pronto es la forma más rápida de que te la confirmen en vez de ponerla a prueba.",
    "Pide la evidencia que distingue esa causa de la siguiente más probable.",
    "Se solapa con systematic-debugging de superpowers. Prueba ambas y quédate con una."
  ],
  "quickStart": [
    "Instálala con el CLI de skills desde mattpocock/skills, con licencia MIT.",
    "Dale la observación, no tu teoría: qué esperabas, qué pasó y cómo reproducirlo.",
    "Exige una causa declarada y evidencia antes de aceptar ningún cambio."
  ],
  "sections": [
    {
      "heading": "Qué cambia en la práctica",
      "paragraphs": [
        "Ante una traza de error, un agente casi siempre produce un cambio que hace desaparecer el mensaje. Eso no es arreglar el defecto, y la diferencia suele aparecer una semana después con un error más raro.",
        "Exigir una causa declarada antes del cambio hace inspeccionable el razonamiento. Si la causa está mal, se ve al momento, que es mucho más barato que descubrirlo por una regresión."
      ]
    },
    {
      "heading": "Dónde decepciona",
      "paragraphs": [
        "No puede diagnosticar lo que no observa. Sin logs, sin reproducción y sin entornos disponibles, se limita igual que una persona.",
        "En fallos triviales es más lenta que arreglarlos, así que resérvala para los que ya te costaron una tarde."
      ]
    }
  ],
  "faq": [
    {
      "question": "¿En qué se diferencia de pedir un arreglo?",
      "answer": "Exige una causa declarada y con evidencia antes de tocar código, así los parches de síntoma se ven en vez de colarse."
    },
    {
      "question": "¿Comparto mi teoría del fallo?",
      "answer": "Al principio no. Da observaciones y una reproducción, o te devolverán tu propia teoría confirmada."
    },
    {
      "question": "¿Cómo se compara con systematic-debugging?",
      "answer": "Misma intención, más estructura allí. Elige una para que el agente reciba instrucciones únicas."
    }
  ],
  "sources": [
    {
      "label": "mattpocock/skills en GitHub",
      "url": "https://github.com/mattpocock/skills",
      "kind": "repository"
    },
    {
      "label": "Directorio de agent skills",
      "url": "https://skills.sh",
      "kind": "directory"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/es/skills/diagnosing-bugs/content.md",
    "json": "https://bestskillsforclaude.com/es/skills/diagnosing-bugs/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}