qol-plugin-lights

qol-skills

Claude Code skills for everything in the qol-tools GitHub org: the qol-tray host app, every plugin, the shared libraries, the workspace conventions, the CI/CD pipeline, and the language patterns the codebase relies on.

This repo is a Claude Code marketplace — 12 fine-grained plugins, one per logical area, so you can toggle the scope you want on any given machine.

Install

Install the marketplace once, then enable only the plugins you need:

/plugin marketplace add qol-tools/qol-skills
/plugin install qol-host
/plugin install qol-plugin-launcher
# ...etc

Or install everything via /plugin in the Claude Code UI and toggle plugins on/off per project.

Plugins

Plugin	Skills bundled
qol-plugin-alt-tab	qol-plugin-alt-tab, plugin-alt-tab-release-flow
qol-plugin-launcher	qol-plugin-launcher, plugin-launcher-release-flow
qol-plugin-pointz	qol-plugin-pointz, pointz-client
qol-plugin-ide-checkout	qol-plugin-ide-checkout, qol-tray-task-runner-ide-checkout
qol-plugin-keyremap	qol-plugin-keyremap
qol-plugin-lights	qol-plugin-lights
qol-plugin-os-themes	qol-plugin-os-themes
qol-plugin-screen-recorder	qol-plugin-screen-recorder
qol-plugin-window-actions	qol-plugin-window-actions
qol-host	qol-tray, qol-tray-dev-logging, qol-tray-feature-profile, qol-tray-release-flow, qol-tray-ui-systems, qol-world-canvas, qol-apps-testing
qol-dev-conventions	rust, gpui, preact, commit, git-push, git-trees, coding-general, qol-architecture, qol-shared-libs, qol-plugin-template
qol-ecosystem	qol-tools, qol-cicd

Each plugin has its own .claude-plugin/plugin.json; every skill lives at plugins/<plugin-name>/skills/<skill-name>/SKILL.md.

Repo layout

qol-skills/
├── .claude-plugin/
│   └── marketplace.json         # lists all 12 plugins
├── plugins/
│   ├── qol-plugin-alt-tab/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/
│   │       ├── qol-plugin-alt-tab/SKILL.md
│   │       └── plugin-alt-tab-release-flow/SKILL.md
│   └── ...
├── LICENSE
└── README.md

Naming convention

Prefix	Scope
qol-plugin-*	individual plugins under the qol-tools/plugin-* repos
qol-host	qol-tray host app internals (core, UI systems, Profile, world canvas, release flow)
qol-dev-conventions	language and cross-repo engineering skills (rust, gpui, preact, commit, git-*, qol-architecture, qol-shared-libs, qol-plugin-template, coding-general)
qol-ecosystem	workspace- and org-level conventions (qol-tools, qol-cicd)

When adding a new plugin skill, the skill name follows: qol-plugin-<plugin-id-without-the-plugin-prefix> — e.g. plugin-alt-tab becomes qol-plugin-alt-tab.

Updating skills

Skills are plain markdown. Edit, commit, push:

cd qol-skills
# edit plugins/qol-host/skills/qol-tray/SKILL.md
git add plugins/qol-host/skills/qol-tray/SKILL.md
git commit -m "docs(qol-tray): clarify daemon lifecycle"
git push

Installed plugins pick up changes via /plugin marketplace update qol-skills.

Frontmatter

Every skill is a Markdown file with YAML frontmatter at the top:

---
name: skill-name-in-kebab-case
description: One paragraph including what it does AND when to use it. Under 1024 characters. No XML tags.
---

The name must match the directory name. Avoid claude or anthropic prefixes (reserved). For deeper guidance see Anthropic's Complete Guide to Building Skills for Claude.

License

PolyForm Noncommercial 1.0.0 — same as the rest of the qol-tools org. See LICENSE.