BipBop Skills

Marketplace público de skills mantenidas por BipBop Labs para Claude Code, Codex y ChatGPT. El marketplace bipbop publica tres plugins: bipbop-skills, con las skills generales del árbol skills/, y los plugins adr y bipflow, que viven en plugins/. Cada árbol es la fuente canónica para todos los clientes.

Skills disponibles

Incluidas en el plugin bipbop-skills.

Skill	Uso
`best-prompting`	Escribir y revisar prompts, descripciones de tools y briefs para agentes, con prácticas agnósticas al modelo y la evidencia detrás de cada una.
`create-skills`	Crear, revisar, validar y empaquetar skills portables siguiendo las mejores prácticas de Claude, Codex y ChatGPT.
`krug-usability-testing`	Planear, ejecutar y revisar tests de usabilidad y validación temprana de conceptos, y priorizar arreglos mínimos.
`microcopy`	Escribir botones, errores, vacíos, confirmaciones y otros textos breves de interfaz.
`ousterhout-software-design`	Diseñar y revisar software con foco en complejidad, módulos profundos e información oculta.
`research-first`	Investigar cómo resuelve la industria una tarea (estándares, regulaciones, guías y errores conocidos), destilarlo en un brief con fuentes y hacer la tarea apoyada en él.
`simple-writing`	Reescribir textos para que se entiendan a la primera, en lenguaje simple o lectura fácil.
`test-audit`	Filtrar tests nuevos al escribirlos y auditar tests de bajo valor, acoplados a la implementación o duplicados. Adaptada de OpenClaw (MIT).

Plugins adicionales

Se instalan por separado y sus skills llevan su propio namespace.

Plugin	Uso
`adr`	Architecture Decision Records para cualquier repositorio: `/adr:init`, `/adr:distill`, `/adr:new`, `/adr:review` y un validador sin dependencias. Instalar con `/plugin install adr@bipbop`.
`bipflow`	Flujo de Git para agentes: `/bipflow:commit` crea commits atómicos que respetan los hooks y `/bipflow:pr` abre pull requests con resumen técnico, plan de pruebas y resumen para el cliente. Instalar con `/plugin install bipflow@bipbop`.

Instalar y mantener al día

El marketplace se llama bipbop y se agrega una sola vez. Después instalas solo los plugins que necesites:

Plugin	Qué trae	Ejemplo de uso
`bipbop-skills`	Las skills generales de la tabla de arriba.	`/bipbop-skills:microcopy`
`adr`	Architecture Decision Records.	`/adr:new`
`bipflow`	Commits y pull requests.	`/bipflow:commit`

Claude Code

Instalar, dentro de Claude Code:

/plugin marketplace add BipBop-Labs/bipbop-skills
/plugin install bipbop-skills@bipbop
/plugin install adr@bipbop
/plugin install bipflow@bipbop

Actualizar:

/plugin marketplace update bipbop
/plugin update bipbop-skills@bipbop
/plugin update adr@bipbop
/plugin update bipflow@bipbop
/reload-plugins

El primer comando descarga el catálogo nuevo; los siguientes actualizan cada plugin instalado, y /reload-plugins aplica los cambios sin reiniciar la sesión. Un plugin solo se actualiza cuando sube su versión, así que revisa el CHANGELOG para saber qué cambió.

Para no hacerlo a mano, activa la actualización automática: /plugin > Marketplaces > bipbop > Enable auto-update. Claude Code revisa el marketplace al iniciar y actualiza los plugins instalados. En marketplaces de terceros como este viene desactivada por defecto.

Revisar lo instalado o quitar un plugin:

/plugin list
/plugin uninstall bipflow@bipbop

Las skills commit y pr vivían antes en bipbop-skills. Si las usabas desde ahí, instala bipflow e invócalas como /bipflow:commit y /bipflow:pr.

Codex CLI

Instalar:

codex plugin marketplace add BipBop-Labs/bipbop-skills --ref main
codex plugin add bipbop-skills@bipbop
codex plugin add adr@bipbop
codex plugin add bipflow@bipbop

Actualizar. Codex conserva un snapshot local del marketplace, así que hay que pedir los cambios nuevos:

codex plugin marketplace upgrade bipbop
codex plugin marketplace list
codex plugin list

Para fijar una versión reproducible, usa un tag en vez de main:

codex plugin marketplace add BipBop-Labs/bipbop-skills --ref v0.2.0

ChatGPT administrado

Un administrador puede importar https://github.com/BipBop-Labs/bipbop-skills desde Admin > Plugins > Add > Import marketplace. Deja vacío el subdirectorio para usar la raíz del repositorio. Los marketplaces nuevos se sincronizan automáticamente cada día; Sync now solicita una actualización inmediata.

Estructura

.
├── plugin.json                         # Manifest portable Agent Plugins
├── .agents/plugins/marketplace.json   # Marketplace de Codex y ChatGPT
├── .claude-plugin/
│   ├── marketplace.json               # Marketplace de Claude Code
│   └── plugin.json                    # Manifest de compatibilidad de Claude
├── skills/<nombre>/
│   ├── SKILL.md
│   ├── references/                    # Material detallado opcional
│   ├── scripts/                       # Automatización determinista opcional
│   └── assets/                        # Recursos opcionales
├── plugins/<nombre>/                  # Plugins adicionales con su propio manifest
│   ├── plugin.json
│   ├── .claude-plugin/plugin.json
│   ├── skills/<nombre>/SKILL.md
│   └── scripts/
└── scripts/validate.py

El marketplace y el plugin bipbop-skills viven en la raíz; los plugins adicionales, en plugins/<nombre>/. Así Claude y Codex resuelven el mismo árbol sin copias ni enlaces simbólicos que puedan divergir.

Buenas prácticas para escribir skills

Estas reglas combinan el subconjunto común de las guías oficiales de skills de OpenAI, paquetes de plugins de OpenAI, plugins de Claude Code y marketplaces de Claude Code.

Una meta reconocible por skill. Divide workflows con disparadores, entradas o criterios de éxito distintos.
name y description en el frontmatter. El nombre usa kebab-case y coincide con su carpeta. La descripción explica qué hace la skill y cuándo debe activarse. Los pasos, formatos y reglas de seguridad van en el cuerpo.
Instrucciones accionables. Declara precondiciones, entradas, decisiones, efectos laterales, manejo de fallos y una verificación observable. Una skill debe decir cómo saber que terminó bien.
Divulgación progresiva. Mantén SKILL.md enfocado. Mueve material extenso a references/, scripts repetibles a scripts/ y recursos estáticos a assets/. Enlaza cada archivo y explica cuándo cargarlo.
Código solo cuando aporta determinismo. No agregues un script si las instrucciones y herramientas existentes resuelven el trabajo de forma fiable. Documenta entradas, salidas, red y efectos laterales de todo ejecutable.
Prioridad clara. Las instrucciones explícitas de la persona y las reglas del sistema tienen prioridad sobre la guía de una skill. Evita reglas ambiguas o contradictorias.
Sin datos privados. No publiques nombres de clientes, correos, teléfonos, RUT, IDs de Notion, URLs internas, tokens, webhooks, código propietario ni ejemplos reconocibles. Revisa toda la historia que vas a empujar, no solo el estado final.
Portabilidad real. Usa rutas relativas dentro de la carpeta de la skill. No dependas de rutas locales, archivos fuera del plugin ni symlinks que escapen del repositorio.
Prueba activación y resultado. Verifica solicitudes que deben activar la skill, solicitudes que no deben activarla, casos ambiguos, errores de herramientas y calidad del resultado final.
Cambios mínimos y revisables. Una PR por tema. Cualquier cambio en scripts, hooks, MCP, permisos o dependencias recibe revisión de seguridad explícita.

Plantilla mínima:

---
name: example-skill
description: Hace X. Usar cuando la persona pide Y o necesita Z.
---

# Example skill

## When to use
- Disparadores claros.
- Casos que quedan fuera.

## Procedure
1. Acción con un criterio de término observable.

## Pitfalls
- Fallos específicos y cómo evitarlos.

## Verification
- Evidencia que demuestra que la tarea terminó bien.

Validar

python3 scripts/validate.py
claude plugin validate .

El validador local revisa JSON, coherencia entre manifests, frontmatter, nombres únicos, enlaces relativos, symlinks e identificadores sensibles. Claude agrega su validación oficial. Codex no expone un comando plugin validate; por eso el chequeo final usa una instalación aislada desde el marketplace.

Antes de abrir una PR, prueba ambos clientes en directorios aislados. Si cambiaste un plugin adicional, reemplaza bipbop-skills por su nombre (adr o bipflow):

CODEX_TEST_HOME="$(mktemp -d)"
CODEX_HOME="$CODEX_TEST_HOME" codex plugin marketplace add ./ --json
CODEX_HOME="$CODEX_TEST_HOME" codex plugin add bipbop-skills@bipbop --json
CODEX_HOME="$CODEX_TEST_HOME" codex plugin list --json
rm -rf "$CODEX_TEST_HOME"

CLAUDE_TEST_HOME="$(mktemp -d)"
CLAUDE_CONFIG_DIR="$CLAUDE_TEST_HOME" claude plugin marketplace add ./
CLAUDE_CONFIG_DIR="$CLAUDE_TEST_HOME" claude plugin install bipbop-skills@bipbop
CLAUDE_CONFIG_DIR="$CLAUDE_TEST_HOME" claude plugin list --json
rm -rf "$CLAUDE_TEST_HOME"

Para validar la distribución Git, repite la prueba con BipBop-Labs/bipbop-skills --ref <rama-o-tag> después de publicar la referencia que quieres probar.

Versiones y actualizaciones

El plugin bipbop-skills usa SemVer y mantiene la misma versión en plugin.json y .claude-plugin/plugin.json. Cada plugin adicional en plugins/<nombre>/ tiene su propia versión, sincronizada entre sus dos manifests. Los catálogos no repiten la versión para evitar drift.

PATCH: correcciones y ajustes compatibles.
MINOR: una skill nueva o una capacidad compatible.
MAJOR: renombrar o eliminar skills, cambiar comportamiento de forma incompatible, o exigir permisos/herramientas nuevas.

Cada release lleva tag vMAJOR.MINOR.PATCH y una entrada en CHANGELOG.md. Los clientes detectan una actualización por el cambio de versión: si cambias un plugin sin subir su versión, quienes ya lo instalaron no reciben el cambio.

Seguridad, privacidad y licencias

Lee SECURITY.md antes de reportar una vulnerabilidad. Todo aporte original de este repositorio se publica bajo MIT. Marcas, libros y otros materiales de terceros pertenecen a sus respectivos titulares.

Contribuir

Lee CONTRIBUTING.md, agrega o actualiza las pruebas necesarias y abre una PR con el resultado de python3 scripts/validate.py.