Release Date: 2026-05-18
Author: Fu-Jie
Version: 0.3.2
What's New
⚡ OpenWebUI 0.9.x Compatibility
Added runtime async detection and compatibility layer for OpenWebUI 0.9.x+ asynchronous database models (Skills), with graceful sync fallback for older versions.
Details: OpenWebUI 0.9.x introduced async/await database model methods. This plugin now wraps all Skills.* model calls (get_skills_by_user_id, update_skill_by_id, insert_new_skill, delete_skill_by_id) with _call_openwebui_compat, which automatically detects whether the called method is async and awaits appropriately, or runs sync methods in a background thread via asyncio.to_thread when needed. No configuration changes are required — the plugin works on both pre-0.9.x and 0.9.x+ OpenWebUI instances.
📝 Multi-line Frontmatter Descriptions
install_skill now correctly parses description: > and description: | blocks in remote SKILL.md files, so imported skill descriptions no longer truncate to a single line.
Before: Multi-line YAML folded/literal scalars in skill frontmatter description: fields were not correctly extracted, causing long descriptions to be collapsed or silently dropped during remote skill installation.
After: The frontmatter parser now properly handles YAML folded style (description: >) and literal style (description: |) scalars, preserving paragraph breaks and multi-line content as originally authored.
↩️ Better Metadata Fallbacks
If a skill frontmatter provides title without name, the installer now uses that title before falling back to directory-based names.
Before: When a remote SKILL.md frontmatter specified title: "My Skill" but omitted name:, the installer skipped the title and fell back to the directory name from the URL path.
After: The name resolution order now checks title (from frontmatter) before the directory/file name fallback, so explicit skill titles are respected.
Migration Notes
- No manual migration required. Existing users can simply update the plugin.
- If you run OpenWebUI < 0.9.x, the plugin continues to work without any configuration changes.
- If you run OpenWebUI ≥ 0.9.x, the async compatibility layer activates automatically.
Full Changelog
| Change | Description |
|---|---|
| ⚡ OpenWebUI 0.9.x Compatibility | Runtime detection + async/sync bridging for Skills model calls |
| 📝 Multi-line Frontmatter | YAML folded/literal scalar support in description: fields
|
| ↩️ Better Metadata Fallbacks | title frontmatter field respected as skill name before URL-based fallback
|
For full commit history, see the GitHub releases page.
Version Changes
Plugin Updates
- OpenWebUI Skills Manager Tool: v0.3.1 → v0.3.2 | 📖 README