widget-pipeline

Analyze Quarto .qmd lectures for widget opportunities and generate iframe-wrapped embeds.

Updated May 10, 2026
One-click install
npx skills add https://github.com/c-kraus/thws-skills --skill widget-pipeline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: widget-pipeline
Source: https://github.com/c-kraus/thws-skills/tree/main/widget-pipeline
Command: npx skills add https://github.com/c-kraus/thws-skills --skill widget-pipeline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It removes the manual effort of finding good widget opportunities inside a Quarto .qmd chapter and then integrating interactive widgets back into the document.

Core Features & Use Cases

  • Widget opportunity analysis: Scans a .qmd for widget-worthy sections and returns prioritized specifications (Prozesse, Zusammenhänge, Parametervariationen).
  • End-to-end widget creation: Builds the top 3 widgets, saves them into a consistent widgets/kapitel-XX/ structure, and prepares them for iframe embedding.
  • Safe, precise integration into .qmd: Inserts canonical iframe wrappers using surgical replacements so the rest of the document remains unchanged.
  • Two modes: FULL mode performs analysis + build + integrate; ANALYZE-ONLY mode produces the analysis report and stops.

Quick Start

Run widget-pipeline in FULL mode on the Quarto file chapter-kap-03-example.qmd to automatically analyze it, build the top 3 widgets, save them under widgets/kapitel-03/, and integrate the iframe embeds into the correct sections.

Frequently Asked Questions about widget-pipeline

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

FAQPage Schema
How do I add interactive widgets to a Quarto .qmd lecture chapter?

To add interactive widgets to a Quarto .qmd lecture, this Skill scans the chapter content, builds self-contained HTML widgets, and integrates them via canonical iframe embeds using surgical replacements so the document remains unchanged.

Can I automatically analyze Quarto content for interactive visualization opportunities?

Yes, you can analyze Quarto content for interactive visualization opportunities using the ANALYZE-ONLY mode, which scans .qmd files for widget-relevant sections like processes, dependencies, and parameter variations, then returns a prioritized specification report.

What is the best way to embed self-contained HTML widgets into Quarto without breaking existing content?

The best way to embed self-contained HTML widgets into Quarto is through canonical iframe-wrapped embeds using the THWS iframe template, inserted via surgical str_replace edits so the rest of your document remains completely unchanged.

Does Quarto support auto-resizing iframes for lecture widgets?

Quarto supports auto-resizing iframes for lecture widgets by generating production-ready self-contained HTML files equipped with auto-resize postMessage logic wrapped inside the THWS iframe template.

How do I structure widget files for a Quarto lecture pipeline?

To structure widget files for a Quarto lecture pipeline, the Skill automatically saves generated widgets into a consistent widgets/kapitel-XX/ directory structure, preparing them for seamless iframe embedding into the correct sections.

When should I not use full automation for Quarto widget integration?

You should not use full automation for Quarto widget integration when you only need to identify opportunities without building; instead, use the ANALYZE-ONLY mode to produce the analysis report and stop before the build and integrate phases.