tcballard avatar

build-omarchy-plugins

v0.5.0

by tcballard · author: Tom Ballard

Design, scaffold, implement, test, debug, demo, release, migrate, and publish Omarchy 4 Quattro shell plugins.

What build-omarchy-plugins does, in the publisher's words

A model-provider-neutral Agent Plugin for building production-quality Omarchy 4 Quattro shell plugins.

It packages the complete workflow: architecture, repository generation, native QML patterns, bar widgets, panels and overlays, services and IPC, validation, debugging, deterministic demos, releases, marketplace publishing, and migration from older installer-style integrations.

This toolkit targets Omarchy 4.0.0 and later with Quattro shell-plugin support. The badge refers to the installed Omarchy version, reported by omarchy-version, not the ISO image version or the underlying Quickshell engine version. That is the scope of the maintained guidance and generators, not a claim that every current or future Omarchy release has been tested. The 4.0.0+ label has no upper major-version bound; compatibility changes will be documented here. Individual APIs and marketplace contracts are pinned in the contract ledger.

From the project README, punctuation lightly normalized · Open the README on GitHub

Skills
12
MCP servers
0
Stars
50
License
MIT
Repo created
2026-08-29
Last pushed
2026-09-21
Publisher type
User
Version
0.5.0

Links

Skills · 12

omarchy-bar-widget
Build or refactor an Omarchy Quattro bar-widget implementation, including settings, orientation, popouts, instances and shared services. Use for widget QML or behaviour; global bar styling belongs to theme skills, and replacing the entire bar is outside this skill.
omarchy-panel-overlay
Build or refactor Omarchy Quattro panel, overlay, or menu entry points. Use for summon/hide lifecycle, payloads, layer-shell windows, focus, dismissal, positioning, keyboard navigation, or multi-monitor presentation.
omarchy-plugin-debug
Diagnose an Omarchy Quattro plugin that is not discovered, validated, enabled, loaded, reloaded, summoned, or behaving correctly. Use for local environment, manifest, shell config, QML runtime, IPC, process, and recovery failures.
omarchy-plugin-demo
Create or verify a deterministic Omarchy plugin demo and marketplace screenshot using fictional data. Use for fixture CLIs, isolated state, reversible shell setup, screenshot capture, and demo evidence; never use real credentials or live personal data.
omarchy-plugin-design
Design an Omarchy 4 Quattro shell plugin before implementation. Use when choosing plugin kinds, architecture, dependencies, state ownership, IPC, security boundaries, or evidence. Do not treat legacy package installers as shell plugins; route those through migration.
omarchy-plugin-migrate
Migrate an older installer-style Omarchy integration or standalone Quickshell surface to Omarchy 4 Quattro. Use to separate machine setup, daemon, credentials, and shell UI while preserving safe install, upgrade, and removal behavior.
omarchy-plugin-publish
Prepare and submit a public Omarchy plugin to omarchyplugins.com through the HANCORE marketplace issue workflow. Use for category, tags, exact issue body, owner attestations, validation feedback, verification, or updates; requires explicit owner approval before issue creation.
omarchy-plugin-release
Preflight and prepare an Omarchy plugin release from a public Git repository. Use for versioning, clean-tree checks, CI, documentation, preview, dependencies, install/remove instructions, tag boundaries, checksums, and release evidence.
omarchy-plugin-scaffold
Create a new Omarchy 4 Quattro shell-plugin repository or add its initial supported entry points. Use for manifest, QML, tests, CI, demo, license, and README scaffolding; not for overwriting an established plugin.
omarchy-plugin-test
Validate and test an Omarchy 4 Quattro plugin. Use for manifest and path checks, advisory security linting, QML syntax or unit tests, fixture tests, live-shell smoke tests, and release evidence; not as a claim of security certification.
omarchy-qml-patterns
Build or refactor QML hosted inside the Omarchy 4 Quattro shell, including plugin theme-token bindings, responsive layout, process execution and state. Use for QML implementation; global palette or shell.toml styling belongs to theme skills, and standalone Quickshell apps are outside this skill.
omarchy-service-ipc
Build or review an Omarchy Quattro headless service and its IPC contract. Use for singleton polling, process execution, shared state, authenticated CLI integration, timers, retries, or `IpcHandler`; not for generic systemd services.

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

Category

Other. Assigned by this directory. Agent Plugins 1.0.0 has no category field, so no manifest declares one.

Keywords

omarchy · quattro · quickshell · qml · agent-skills · plugin-development · developer-tools

Related by publisher and keywords

  • Bounded Angular 21 to 22 upgrade preflight, execution, compatibility, and validation guidance.

  • Focused Angular architecture, component, dependency-boundary, and service-design guidance.

  • Focused Angular TestBed, component test, visual validation, and test-stability guidance.

  • ngautopilot-corejanpereira-dev

    Core NgAutoPilot workflows for project intake, stack detection, routing, compatibility gates, and risk assessment.

  • ngautopilot-skillsjanpereira-dev

    A skills-only package of NgAutoPilot engineering guidance.

  • ngautopilot-toolsjanpereira-dev

    Read-only NgAutoPilot MCP tools for catalog, Angular compatibility, upgrade coverage, packs, adapters, subagents, and repository inspection.

Add the verified badge to your README[![Verified by AgentPluginsDirectory.com against Schema 1.0.0](https://agentpluginsdirectory.com/badge.svg)](https://agentpluginsdirectory.com/plugins/build-omarchy-plugins)

Verified . We fetched the manifest from GitHub and checked it against the official Agent Plugins 1.0.0 schema at agent-plugins.org.