copyq-scripting

v1.0.0

Foundational advanced clipboard scripting skills for CopyQ on Ubuntu Linux — CLI reference, custom commands, tab/item management, global shortcuts, and command bundle import/export.

Claude Code7 skills

by Daniel RosehillMIT0updated 3 months ago

Source

$ git clone https://github.com/danielrosehill/Claude-CopyQ-Scripting-Plugin

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

copyq-scripting/

├── .claude-plugin/plugin.json
├── skills/bind-global-shortcut/SKILL.md
├── skills/clipboard-inspect/SKILL.md
├── skills/copyq-cli-reference/SKILL.md
├── skills/export-import-commands/SKILL.md
├── skills/install-and-configure/SKILL.md
├── skills/manage-tabs-and-items/SKILL.md
└── skills/write-custom-command/SKILL.md

Skills7

bind-global-shortcutskills/bind-global-shortcut/SKILL.md

Bind a system-wide keyboard shortcut to a CopyQ Custom Command — show menu, paste-as-plain-text, run a transformation on the current clipboard, etc. Covers both the in-CopyQ `GlobalShortcut` field and the alternative of binding the shortcut at the desktop-environment level (KDE / GNOME) to a `copyq` CLI invocation.

clipboard-inspectskills/clipboard-inspect/SKILL.md

Read the current clipboard, the X11 PRIMARY selection, or any item from CopyQ history — by row, by MIME type, or filtered by regex. Use when the user wants to inspect what's on the clipboard, dump history to a file, or pipe clipboard contents into another tool.

copyq-cli-referenceskills/copyq-cli-reference/SKILL.md

Authoritative reference for the CopyQ command-line interface and scripting language on Ubuntu Linux. Load this before authoring any other CopyQ skill output so generated commands and scripts are syntactically valid. Covers `copyq` subcommands (read, write, add, remove, tab, select, eval, edit), the embedded ECMAScript-flavoured scripting language, MIME-type handling, and item formats.

export-import-commandsskills/export-import-commands/SKILL.md

Export CopyQ Custom Commands to a versionable `.ini` bundle and import them on another machine or after a reinstall. Use when the user wants to back up their CopyQ commands, sync between workstations, or ship a curated bundle as part of a dotfiles repo.

install-and-configureskills/install-and-configure/SKILL.md

Install CopyQ on Ubuntu (apt or upstream PPA), enable autostart, and apply a sensible baseline configuration — clipboard history limit, store images, monitor selections, and tray behaviour. Use when the user says CopyQ is missing, freshly installed, or behaving with default settings they want changed.

manage-tabs-and-itemsskills/manage-tabs-and-items/SKILL.md

Create, rename, reorder, and remove CopyQ tabs; move or copy items between tabs; deduplicate; pin items; and clear history selectively. Use when organising clipboard history into named buckets (Links, Snippets, Code, etc.) or doing bulk cleanup.

write-custom-commandskills/write-custom-command/SKILL.md

Author a CopyQ Custom Command — automatic clipboard transformations, menu actions, or global-shortcut handlers. Produces a valid `.ini` snippet that can be imported via Preferences → Commands → Load, or via `copyq loadCommands`. Use when the user wants CopyQ to react automatically to clipboard events (e.g. strip formatting, route URLs to a tab, redact secrets).

Manifests1

.claude-plugin/plugin.json

{
  "name": "copyq-scripting",
  "version": "1.0.0",
  "description": "Foundational advanced clipboard scripting skills for CopyQ on Ubuntu Linux — CLI reference, custom commands, tab/item management, global shortcuts, and command bundle import/export.",
  "author": {
    "name": "Daniel Rosehill",
    "url": "https://github.com/danielrosehill"
  },
  "repository": "https://github.com/danielrosehill/Claude-CopyQ-Scripting-Plugin",
  "license": "MIT",
  "keywords": [
    "copyq",
    "clipboard",
    "linux",
    "ubuntu",
    "automation",
    "scripting"
  ]
}