dragon-parchment

Create and manage floating overlay panels for terminal user interfaces.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/dotBeeps/hoard --skill dragon-parchment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dragon-parchment
Source: https://github.com/dotBeeps/hoard/tree/main/morsels/skills/dragon-parchment
Command: npx skills add https://github.com/dotBeeps/hoard --skill dragon-parchment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Floating UI panels in terminal-based agent extensions are hard to position, focus, and manage across sessions; dragon-parchment centralizes panel lifecycle, positioning, focus cycling, collision avoidance, and render invalidation so extensions can add panels reliably without reimplementing layout logic.

Core Features & Use Cases

  • Centralized panel lifecycle: create, list, focus, cycle, and dispose panels with consistent behavior across extensions.
  • Smart placement & anchors: auto-placement, suggested layouts for multiple panels, and panel-relative anchoring for contextual detail views.
  • Focus & key hint integration: built-in focus cycling, configurable hotkeys, and key hint metadata so components don't conflict with global controls.
  • TUI-friendly rendering: cached render patterns, width-aware line rendering, and invalidation hooks to keep panels performant.
  • Use Case: Add a contextual detail panel to a list view that opens anchored to the selected item, stacks correctly with other panels, and participates in global focus cycling.

Quick Start

Ask the agent to createPanel with an id and factory, set anchor to right-center and width to 30% and focusOnOpen to true to open a new floating panel.

Frequently Asked Questions about dragon-parchment

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

FAQPage Schema
How do I manage floating overlay panels in a terminal user interface?

Floating overlay panels in a terminal user interface are managed through a centralized lifecycle API that handles creation, positioning, focus cycling, and disposal. This approach prevents extensions from reimplementing layout logic and ensures consistent behavior across sessions.

How do I anchor a contextual detail panel to a selected item in a TUI?

Anchoring a contextual detail panel to a selected item in a TUI uses panel-relative positioning and auto-placement features. You set an anchor property like right-center and configure width percentages to position the floating panel relative to the parent element.

What's the best way to handle focus cycling across multiple terminal UI panels?

Focus cycling across multiple terminal UI panels is handled through built-in focus management and configurable hotkeys. The system provides key hint metadata to prevent conflicts with global controls, allowing multiple panels to participate in consistent focus switching.

Can I use auto-placement and collision avoidance for multiple floating panels?

Auto-placement and collision avoidance for multiple floating panels are supported through suggested layouts and smart placement algorithms. The system calculates geometry tracking and stacking behavior to ensure panels do not overlap incorrectly in responsive TUI environments.

Does terminal panel rendering require manual cache invalidation?

Terminal panel rendering requires cache invalidation through provided invalidation hooks rather than manual management. The system uses cached render patterns and width-aware line rendering to keep floating panels performant during session-aware updates.

What are the limitations of using layout suggestion APIs for TUI overlays?

Layout suggestion APIs for TUI overlays are limited to terminal user interface constraints and responsive rendering boundaries. Panels must participate in geometry tracking and global focus cycling, and complex nested anchoring may require manual width and position adjustments.