create-evlog-adapter

Create an evlog adapter with eight mandatory integration touchpoints.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/andreasasprou/polaris --skill create-evlog-adapter-andreasasprou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-evlog-adapter
Source: https://github.com/andreasasprou/polaris/tree/main/.agents/skills/create-evlog-adapter
Command: npx skills add https://github.com/andreasasprou/polaris --skill create-evlog-adapter-andreasasprou

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Adding a new observability drain adapter requires coordinated edits across source code, build configuration, package exports, tests, documentation, and site indexes, which is error-prone and easy to miss. This Skill enforces a complete, repeatable eight-touchpoint workflow so new adapters are integrated consistently and safely into the evlog package and the docs site.

Core Features & Use Cases

  • End-to-end checklist: Defines the eight mandatory touchpoints (adapter source, build entry, package exports, tests, adapter docs, adapters overview, public skills table, and renumbering of custom.md) to ensure no step is skipped.
  • Templates and tests: Provides adapter source and test templates that mandate config priority, timeout handling, error logging, exported send functions, and batch operations for reliable production behavior.
  • Documentation & site integration: Ensures multi-framework Quick Start examples, overview cards, env var docs, and review-logging-patterns table entries are all updated to keep developer docs accurate.

Quick Start

Create a new evlog adapter named datadog and complete all eight touchpoints by adding the adapter source, updating build and package exports, creating tests, adding the adapter doc page and overview entry, updating the review-logging-patterns table, and renumbering custom.md so the docs build and tests pass.

Frequently Asked Questions about create-evlog-adapter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new observability drain adapter to send wide events to an external platform?

To add a new observability drain adapter, you must complete an eight-touchpoint workflow covering adapter source, build config, package exports, tests, documentation, overview entries, a review table, and renumbering to ensure safe package integration.

What steps are required to integrate a TypeScript logging adapter into a production package?

Integrating a TypeScript logging adapter requires updating adapter source, build entries, package exports, unit tests, and documentation cards to ensure the implementation satisfies config priority, timeout handling, and batch send functions for production reliability.

How do you handle timeout and abort logic when sending wide events to an observability platform?

Timeout and abort handling for wide events is mandated within adapter source templates, ensuring that drain adapters log errors without throwing and manage external platform send operations reliably under network constraints.

Why do my evlog documentation builds fail after adding a new observability adapter?

Documentation builds fail when the eight mandatory touchpoints are incomplete, specifically if the adapter overview, review-logging-patterns table, or the renumbering sequence in custom.md are skipped during the integration workflow.

Can I batch send wide events to an external observability platform without throwing errors?

Yes, adapter templates mandate exported single and batch send functions alongside non-throwing error logging, allowing wide events to be transmitted to observability platforms safely without crashing the application.

Does adding an evlog drain require updating package exports and build configuration?

Yes, adding an evlog drain requires coordinated updates to both package exports and build configuration entries to properly expose the new adapter source and ensure the observability integration functions correctly.