How this skill is triggered — by the user, by Claude, or both
Slash command
/np-troubleshooting:np-apiThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Skill para explorar y consultar la API de Nullplatform.
docs/agent-commands.mddocs/api-keys.mddocs/applications.mddocs/builds.mddocs/concepts.mddocs/deployments.mddocs/dimensions.mddocs/entity-hooks.mddocs/infrastructure.mddocs/metadata.mddocs/nrn.mddocs/parameters.mddocs/runtime-configuration.mddocs/scopes.mddocs/services.mddocs/telemetry.mddocs/workflows.mdscripts/check_auth.shscripts/deploy-agent-dump.shscripts/fetch_np_api_url.shSkill para explorar y consultar la API de Nullplatform.
| Comando | Proposito |
|---|---|
/np-api | Mapa de entidades y relaciones |
/np-api check-auth | Verificar autenticacion con Nullplatform |
/np-api search-endpoint <term> | Buscar endpoints por termino |
/np-api describe-endpoint <endpoint> | Documentacion completa del endpoint |
/np-api fetch-api <url> | Ejecutar request a la API |
Ejecutar el script de verificacion:
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/check_auth.sh
Mostrar el resultado al usuario. Si falla, indicar las opciones:
RECOMENDADO: NP_API_KEY (no expira, token cacheado en ~/.claude/)
export NP_API_KEY='tu-api-key'
export NP_API_KEY='...' a ~/.zshrc o ~/.bashrcAlternativa: NP_TOKEN (expira en ~24h)
export NP_TOKEN='eyJ...'
Ejecutar:
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/np-api.sh search-endpoint <term>
Muestra lista de endpoints que contienen el termino buscado.
Ejecutar:
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/np-api.sh describe-endpoint <endpoint>
Muestra documentacion completa del endpoint: parametros, respuesta, navegacion, ejemplos.
Ejecutar:
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/np-api.sh fetch-api <url>
Retorna el JSON de la respuesta de la API.
Movido: El comando resend-notification se movio a
/np-service-wizard resend-notification <id> [channel_id]porque requiere la API key admin (desecrets.tfvars), no la key de troubleshooting de np-api.
Informar al usuario que use /np-service-wizard resend-notification <id> [channel_id] en su lugar.
Para buscar notificaciones y ver resultados (lectura, no requiere admin):
# Buscar notificaciones
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/np-api.sh fetch-api "/notification?nrn=<nrn_encoded>&source=service"
# Ver resultado de entrega por canal
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/np-api.sh fetch-api "/notification/<id>/result"
Ejecutar:
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/np-api.sh
Muestra el mapa de entidades y jerarquia de Nullplatform.
Para explorar la API de forma segura:
/np-api para ver el mapa de entidades/np-api search-endpoint <term> para encontrar el endpoint/np-api describe-endpoint <endpoint> para ver la documentacion/np-api fetch-api <url> para ejecutar el requestsearch-endpoint para confirmar que el endpoint existe?describe-endpoint para conocer los parametros validos?| Mal | Por que | Bien |
|---|---|---|
fetch-api "/scope/123" directo | Asumis que el endpoint existe | Primero search-endpoint scope |
fetch-api "/scope?application_id=X" | Asumis query params | Primero describe-endpoint /scope |
| Inferir endpoints de respuestas JSON | La API puede no seguir convenciones REST | Siempre verificar con search-endpoint o describe-endpoint |
| Script | Proposito |
|---|---|
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/fetch_np_api_url.sh <url> | Fetch directo de API |
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/deploy-agent-dump.sh <deployment_id> | Dump K8s de deployment |
${CLAUDE_PLUGIN_ROOT}/skills/np-api/scripts/scope-agent-dump.sh <scope_id> | Dump K8s de scope |
Cuando descubras un endpoint nuevo o el usuario pida documentarlo:
.md correspondiente en docs/ (o crear uno nuevo)## @endpoint /ruta/del/endpoint
Descripcion breve de que hace.
### Parametros
- `param1` (path|query, required|optional): Descripcion
### Respuesta
- `campo1`: Descripcion
- `campo2`: Descripcion
### Navegacion
- **→ entidad**: `campo` → `/otro/endpoint`
- **← desde**: `/endpoint?filtro={id}`
### Ejemplo
\```bash
np-api fetch-api "/ruta/del/endpoint/123"
\```
### Notas
- Comportamientos no obvios
- Errores comunes
El CLI detecta ## @endpoint como marcador y extrae la documentacion automaticamente.
Cuando el usuario pida "genera un reporte de np-api" o "np-api report":
Revisar toda la conversacion y extraer:
/np-api (comando completo)| Segs | Accion | Contenido | Exitosa |
|---|---|---|---|
| 0 | prompt | Resumen del prompt del usuario | - |
| N | np-api | Comando ejecutado | ✓ / ✗ |
Para cada llamada fallida:
Lista de cambios a docs/*.md con formato:
npx claudepluginhub nullplatform/ai-plugins --plugin np-troubleshootingExposes the DashClaw platform's routes, schema, and env vars via snapshot and live queries. Use for integration, troubleshooting, and governance — prefers `python -m livingcode query` or REST fallback.
Wires a PostHog endpoint into a client app or SDK — fetches OpenAPI spec, generates typed clients, handles auth headers, payload shaping, and rate-limit errors.
Guides raw HTTP API integration with CloudBase platform for Android, iOS, Flutter, React Native, non-Node backends, and admin scripts. Not for SDK or MCP flows.