Blyp Docs

Skills

Blyp skills are portable markdown files that help AI coding agents install and wire Blyp correctly. Start with blyp-core, then add only the supported presets that match the runtime or connector used by the repo.

This first release covers supported presets only. It does not claim full coverage for every Blyp export.

Install flow

You can install bundled skills automatically using the CLI:

blyp skills install

This opens an interactive picker. To install a specific skill by name:

blyp skills install blyp-core
  1. Install blyp-core first.
  2. Add only the runtime or connector presets the repo actually needs.
  3. Copy the canonical SKILL.md file into the matching agent directory.

Agent install paths

AgentProject-local pathGlobal path
Codex.agents/skills/<skill>/SKILL.md~/.agents/skills/<skill>/SKILL.md
OpenCode.opencode/skills/<skill>/SKILL.md~/.config/opencode/skills/<skill>/SKILL.md
Claude Code.claude/skills/<skill>/SKILL.md~/.claude/skills/<skill>/SKILL.md
Cursor.cursor/rules/<skill>/SKILL.md~/.cursor/rules/<skill>/SKILL.md

Supported preset matrix

PresetCategoryCoversWhen to installDocsRaw file
blyp-corecoreBase Blyp install, config, ingestion, and runtime rulesInstall first in any repo where an agent might add or modify Blyp logging.Core/skills/blyp-core/SKILL.md
blyp-nextjsintegrationNext.js App Router routes with withLogger() and clientLogHandlerInstall when the codebase uses Next.js App Router and imports from @blyp/core/nextjs.Next.js/skills/blyp-nextjs/SKILL.md
blyp-expressintegrationExpress middleware, req.blypLog, and error logging flowInstall when the codebase mounts Blyp in Express and needs correct middleware ordering.Express/skills/blyp-express/SKILL.md
blyp-honointegrationHono middleware, context.get("blypLog"), and ingestion interceptionInstall when the app uses Hono middleware and request logging via @blyp/core/hono.Hono/skills/blyp-hono/SKILL.md
blyp-elysiaintegrationElysia plugin setup and ctx.log request loggingInstall when the server uses Elysia and integrates Blyp as a plugin.Elysia/skills/blyp-elysia/SKILL.md
blyp-workersintegrationWorkers-only initWorkersLogger(), createWorkersLogger(), and manual emit()Install when the target runtime is Cloudflare Workers instead of Node.js or Bun.Cloudflare Workers/skills/blyp-workers/SKILL.md
blyp-client-expointegrationBrowser createClientLogger() and Expo createExpoLogger() delivery rulesInstall when Blyp needs to emit from browsers or Expo apps into a Blyp-enabled backend.Client + Expo/skills/blyp-client-expo/SKILL.md
blyp-betterstackconnectorconnectors.betterstack, auto/manual log forwarding, and Better Stack error trackingInstall when the codebase forwards Blyp logs or handled errors into Better Stack.Better Stack/skills/blyp-betterstack/SKILL.md
blyp-posthogconnectorconnectors.posthog, auto/manual delivery, and error trackingInstall when the codebase forwards Blyp logs or errors into PostHog.PostHog/skills/blyp-posthog/SKILL.md
blyp-sentryconnectorconnectors.sentry, auto/manual delivery, and existing client reuseInstall when Blyp logs or structured events need to flow into Sentry.Sentry/skills/blyp-sentry/SKILL.md
blyp-otlpconnectorNamed OTLP targets, auto/manual delivery, and client forwarding requestsInstall when Blyp forwards to Grafana, Datadog, Honeycomb, or another OTLP target.OTLP/skills/blyp-otlp/SKILL.md

What each preset gives agents