add-handler

Scaffold a new birch logging handler with tests and export updates.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tylerbutler/birch --skill add-handler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-handler
Source: https://github.com/tylerbutler/birch/tree/main/.claude/skills/add-handler
Command: npx skills add https://github.com/tylerbutler/birch --skill add-handler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers quickly scaffold a new birch logging handler, standardizing structure and reducing boilerplate.

Core Features & Use Cases

  • Create a new handler file under src/birch/handler/{argument}.gleam following project conventions.
  • Implement a public handler function that returns a handler using the provided argument as the name.
  • Add tests in test/birch_test.gleam to verify output formats and edge cases.
  • Update exports if needed to expose the new handler to users.

Quick Start

Create a new birch handler using the desired argument to scaffold the handler and associated tests.

Frequently Asked Questions about add-handler

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

FAQPage Schema
How do I scaffold a new birch logging handler in Gleam?

To scaffold a birch logging handler, provide a handler name as an argument. The skill generates a Gleam source file under src/birch/handler/, adds tests to verify output formats, and updates exports automatically.

What is the standard file structure for a birch handler?

A standard birch handler file is placed at src/birch/handler/{argument}.gleam. It implements a public function returning a handler using the provided argument as the name, following project conventions.

Does scaffolding a birch handler include generating tests?

Yes, scaffolding a birch handler includes generating tests. Tests are added to test/birch_test.gleam to verify output formats and edge cases for the newly created logging handler.

How do I update exports when adding a new birch handler?

Exports are updated automatically as part of the birch handler scaffolding workflow. This exposes the new handler to users without requiring manual modifications to the project's export modules.

Can I use this scaffolding tool for any Gleam logging library?

No, this scaffolding tool is specifically designed for the birch logging library. It follows birch's specific project conventions, source file paths, and testing guidelines to ensure structural consistency.

What is the best way to standardize birch handler creation across a project?

The best way to standardize birch handler creation is using a scaffolding skill. It enforces consistent file placement, implements the public handler function, and reduces boilerplate for engineers extending the logging project.