Skip to content

bipbop-labs/bipbop-skills

v0.5.0MIT

Public skills for building clear, reliable software and interfaces.

Changelog

Todos los cambios relevantes de este proyecto se documentan aquí. El formato sigue Keep a Changelog y las versiones siguen Semantic Versioning.

[Unreleased]

Added

  • Plugin adr (0.1.0) en plugins/adr/: Architecture Decision Records para cualquier repositorio, con /adr:init, /adr:distill, /adr:new, /adr:review, validador validate-adrs.py sin dependencias y hook Stop opcional desactivado por defecto. El marketplace ahora admite plugins adicionales en plugins/<nombre>/.
  • Plugin adr (0.2.0): validate-adrs.py acepta --fail-on-proposed, que marca como error los ADRs que siguen en proposed. Está pensado para CI, para que no se integre un ADR que nadie aceptó ni rechazó; los snippets de CI de --print-setup ahora usan --strict --fail-on-proposed.
  • Plugin bipflow (0.1.0) en plugins/bipflow/ con las skills commit y pr, para que un agente cree commits atómicos y abra pull requests con secciones para quien revisa y para el cliente. Se invocan como /bipflow:commit y /bipflow:pr.
  • Skill krug-usability-testing, basada en "Rocket Surgery Made Easy" de Steve Krug, para planear, ejecutar y revisar tests de usabilidad y validación temprana de conceptos.
  • Skill research-first (bipbop-skills 0.4.0): antes de una tarea (un correo, una feature, un proceso) investiga en internet estándares, regulaciones, guías oficiales, prácticas establecidas y errores conocidos, evalúa las fuentes, destila un brief con enlaces y fechas, y después hace la tarea apoyada en ese brief. Incluye listas de qué buscar para comunicaciones, software y procesos, y las fuentes de cada método.
  • Skill test-audit, adaptada de la skill homónima de OpenClaw (MIT, licencia incluida en skills/test-audit/LICENSE), para filtrar tests nuevos y auditar tests de bajo valor. Se quitaron las referencias a scripts y skills propios de OpenClaw; el resto del texto se mantiene.

Changed

  • adr 0.3.0: un ADR aceptado se edita directo y cada cambio de decisión agrega una línea a ## History con la fecha, qué cambió y por qué. supersedes queda solo para cuando otra decisión reemplaza el ADR completo.
  • microcopy (bipbop-skills 0.4.2): prohíbe el punto medio como separador y las comillas angulares. En una interfaz, cada dato va en su propio elemento y el componente los separa; en prosa se escribe una oración, y las citas van con comillas normales.
  • microcopy (bipbop-skills 0.4.1): distingue botones y etiquetas, que van como fragmento, de las descripciones (cards, tooltips, ayudas), que van en oraciones completas y sin remates. Agrega no describir lo que se describe solo: un subtítulo o eyebrow va solo si dice algo que el título no dice.
  • bipflow 0.2.0: /bipflow:pr elige la rama base según la rama actual. Desde una rama de trabajo apunta a stg (o staging) si existe en el remoto y a la rama por defecto si no. Desde stg distingue por contexto entre abrir una rama nueva con PR hacia stg y promover stg a la rama por defecto, y pregunta cuando no queda claro. Antes usaba siempre la rama por defecto de GitHub.
  • best-prompting: reescrita para ser agnóstica al modelo. Antes describía el estilo del system prompt de un vendor; ahora reúne las prácticas en que coinciden las guías actuales de Anthropic y OpenAI, contrastadas con estudios independientes. Agrega un triage previo a editar un prompt, una tabla de comportamientos que cambian entre modelos y un checklist de revisión, y mueve el detalle a references/: prompts de agentes y tools, pruebas e iteración, y fuentes con la fuerza de la evidencia de cada recomendación. Se retiran consejos que las guías actuales revierten, como pedir el razonamiento en tags, los recordatorios de verificación por defecto y los bloques anti-markdown.
  • research-first (bipbop-skills 0.5.0): agrega un eje de búsqueda en código abierto e implementaciones similares. Explica dónde buscar (grep.app por su MCP, gh search code y sus límites, Sourcegraph, registros de paquetes), cómo elegir proyectos mantenidos de la misma versión, leer código, tests e issues en vez del README, contar usos como señal de consenso, y tratar el contenido de repos ajenos como dato sin ejecutar su setup. El brief suma una sección de implementaciones similares.
  • ousterhout-software-design: en review, reportar solo red flags con acción; sin elogios ni ítems sin recomendación.

Fixed

  • Plugin adr (0.2.0): validate-adrs.py ya no reporta como obsoletas las rutas de paths que empiezan con punto, como .github/workflows/ci.yml. Antes les quitaba el punto inicial y avisaba que no coincidían con nada en el repositorio.

[0.2.0] - 2026-09-10

Added

  • Skill create-skills para crear, revisar, validar y distribuir skills portables.
  • Skill simple-writing, migrada desde el repositorio de skills de Revi.

[0.1.0] - 2026-09-10

Added

  • Marketplace público compatible con Claude Code, Codex y ChatGPT.
  • Skills best-prompting, microcopy y ousterhout-software-design.
  • Validación local, política de seguridad y guía de contribución.