bengal-add-directive

Add custom MyST directives to Bengal by implementing the DirectiveHandler protocol.

41|Updated Oct 2, 2025
One-click install
npx skills add https://github.com/lbliii/bengal --skill bengal-add-directive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bengal-add-directive
Source: https://github.com/lbliii/bengal/tree/main/skills/bengal-add-directive
Command: npx skills add https://github.com/lbliii/bengal --skill bengal-add-directive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured process for extending Bengal's content rendering capabilities by adding custom MyST directives, enabling more dynamic and specialized content blocks within your static sites.

Core Features & Use Cases

  • Custom Content Blocks: Create unique admonitions, cards, tabs, or any other custom content structures.
  • Rendering System Extension: Integrate new ways to parse and display content beyond standard Markdown.
  • Use Case: You need to create a special "code-example" directive that highlights code snippets with specific syntax and includes a copy-to-clipboard button. This skill guides you through implementing that directive.

Quick Start

Follow the steps in the SKILL.md to define options, create a handler, and register your new directive.

Frequently Asked Questions about bengal-add-directive

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

FAQPage Schema
How do I add custom MyST directives to a static site generator?

Add custom MyST directives to a static site generator by implementing the DirectiveHandler protocol and registering new directive types. This process enables specialized content blocks, custom admonitions, and advanced display elements within Bengal-generated sites.

How does directive handling work for custom content rendering in Bengal?

Directive handling for custom content rendering works by implementing a handler that defines options and processes content, registering it as a new directive type to parse and display specialized structures beyond standard Markdown within Bengal.

Can I create custom admonitions and specialized content blocks for my static site?

Yes, you can create custom admonitions and specialized content blocks for your static site by extending Bengal's rendering system, facilitating the integration of unique elements like cards, tabs, and custom code examples.

What is the best way to implement a custom code-example directive with a copy-to-clipboard button?

The best way to implement a custom code-example directive with a copy-to-clipboard button is to use this Skill's structured process to define options, create a handler, and register the new directive within Bengal's rendering pipeline.

Do I need any specific dependencies to extend Bengal content rendering?

No specific dependencies are required to extend Bengal content rendering. You can implement the DirectiveHandler protocol and register new directive types directly using the provided scripts and references.

Why are my custom directives not rendering in the Bengal static site generator?

Custom directives may not render in the Bengal static site generator if the handler was not properly registered after defining its options, preventing the rendering system from parsing and displaying the specialized content blocks.