feat(quarto): add quarto-lua skill for Lua shortcodes and filters#39
feat(quarto): add quarto-lua skill for Lua shortcodes and filters#39mcanouil wants to merge 18 commits intoposit-dev:mainfrom
Conversation
Add a new skill for writing Lua shortcodes and filters in Quarto. Covers handler patterns, Lua style conventions, Quarto-specific APIs, and delegates to Quarto's .llms.md pages for detailed API reference.
This comment was marked as resolved.
This comment was marked as resolved.
Include details on custom AST nodes and filter timing in the documentation. This enhances the understanding of Quarto's capabilities for users working with Lua shortcodes and filters.
|
First version of this lua skill for Quarto ready with Quarto CLI v1.9.36 now released. |
Clarified registration instructions for shortcodes and filters in YAML.
cderv
left a comment
cderv
left a comment
There was a problem hiding this comment.
Thanks for this addition !
Something that makes me wonder: Lua filter can be used without Quarto Extensions. Shortcodes can't. Is this skill made for Lua inside quarto extension ? Or just any Quarto Lua writing ?
I wonder if the skill should be more clear on this to help Claude know when this is in Extensions context or just Lua filter context. 🤷♂️
Also, this is a good opportunity to better document the Lua API so I'll add something in the doc with all the feature. (like quarto.format endpoint).
|
@cderv "Something that makes me wonder: Lua filter can be used without Quarto Extensions. Shortcodes can't. " This is not true. 
|
|
Oh cool ! I thought they couldn't ! I guess I forgot this shortcodes configuration can also work in single documents !! Awesome ! |
|
I believe most if not all users don't know about this because that's not documented. |
|
Possibly not documented because not expected initially but side effect 🤷♂️ it seems useful to avoid setting a full extension to add shortcode explicitly to a single project without intent of sharing |
and quick development/debugging ;) (that's how I use it) |
… mention "quarto" for Lua API
…ing other online resources.
It appears, the skill was not triggered when asking for information or trying to extend lua filter with custom callouts, etc.
3 participants
Add a new
quarto-luaskill for writing Lua shortcodes and filters in Quarto.The skill provides inline patterns for shortcode handlers and AST filters, Lua coding conventions (naming, indentation, scoping, error handling), Quarto-specific APIs (
is_format,add_html_dependency,include_text,quarto.log.output), and a decision tree that delegates to Quarto's.llms.mdpages for detailed API reference.A
references/custom-ast-nodes.mdfile documents Quarto's custom AST node types (Callout, ConditionalBlock, Tabset, FloatRefTarget, etc.), constructor signatures, and filter timing phases.Evaluation