New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

K4

by k4ditano in k4ditano/k4

Use this whenever the user is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does, write a plugin for it, or debug one.

MITAuto-check passedMedia & Creative

Install K4

skills CLI
$ npx skills add k4ditano/k4 --skill k4 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install k4ditano/k4 k4 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/k4ditano/k4.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agentes/skills/k4 .claude/skills/k4 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
k4
GitHub stars
123
Token cost
~647 tokens
SKILL.md length
275 words
Files
3
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Use this whenever the user is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does, write a plugin for it, or debug one.

  • Is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does
  • SKILL.md covers Where things are, Read the right guide and Three things to get right from…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Write a plugin for it

What it does

K4 is an agent skill from k4ditano/k4. Use this whenever the user is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does, write a plugin for it, or debug one. Triggers: k4, the island, the bar, a k4 plugin, plugin.json, K4.Plugin, quickshell ipc call k4, pluginReload, pluginStatus, ~/.config/k4/plugins, the k4 launcher, the k4 control center, the k4 capture tool or its video editor, k4 shortcuts. Also use it when the user says "make me a widget/plugin for my bar" and the bar is k4.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `barra.md` and `plugins.md`).

It sits in Media & Creative, covering Video production and Hooks and plugins. It works with Linux. The repository describes itself as: An extensible Dynamic Island-style bar for Hyprland, built with Quickshell: media, control center, notifications, launcher, screen capture, a video editor and a documented plugin… The licence is MIT.

When your agent uses it

  • Is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does
  • Write a plugin for it
  • The user says make me a widget/plugin for my bar and the bar is k4

Example prompts

  • “make me a widget/plugin for my bar”
  • “/k4”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 5b1406c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

K4 loads about 647 tokens when it runs. Until then it costs about 127 tokens; SKILL.md has 275 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~127
When it runs · the whole SKILL.md, loaded when a task matches
~647

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from k4ditano/k4 at commit 5b1406c, republished under its MIT licence (© k4ditano). 275 words, ~647 tokens.

Download SKILL.mdSave it as .claude/skills/k4/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
k4
description
Use this whenever the user is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does, write a plugin for it, or debug one. Triggers: k4, the island, the bar, a k4 plugin, plugin.json, K4.Plugin, quickshell ipc call k4, pluginReload, pluginStatus, ~/.config/k4/plugins, the k4 launcher, the k4 control center, the k4 capture tool or its video editor, k4 shortcuts. Also use it when the user says "make me a widget/plugin for my bar" and the bar is k4.

k4

k4 is an extensible bar for Hyprland, built on Quickshell. It sits collapsed at one edge of the screen and expands when it has something to show.

Everything in it is a plugin, including the parts that look built in: the clock, the launcher, the control center, the capture tool. There is no privileged inner circle — the API a stranger's plugin gets is the API the launcher uses. That is the single most useful thing to know before writing one, because it means anything you can see the bar do, a plugin can do.

Where things are

~/.config/quickshell/k4/          the bar itself (the repository)
~/.config/k4/plugins/<id>/        plugins the user installed or wrote
~/.local/state/k4/plugins.json    which plugins are on
~/.local/state/k4/k4.log          the log — read this first when something breaks

Read the right guide

  • plugins.md — writing a plugin: the fastest path, the API, permissions, testing it without touching the running bar, publishing it.
  • barra.md — driving and debugging the bar itself: IPC, the log, restarting, shortcuts, translations.

Three things to get right from the start

Read the log before guessing. ~/.local/state/k4/k4.log has the QML errors, and quickshell ipc -p ~/.config/quickshell/k4/shell.qml call k4 pluginStatus tells you which plugins failed and why. A plugin that does not appear almost always has an error waiting there.

Never restart the bar to test a plugin. python3 tools/plugins.py --test <id> opens it in a separate instance with no bar, no services and no notifications. If it hangs, it hangs alone. Restarting the user's bar loses whatever they had open.

Declare what you use. A plugin lists its permissions in plugin.json, and tools/plugins.py checks that list against what the QML actually calls. Using something you did not declare does not warn — it makes the plugin refuse to load. That is deliberate, and it is also the fastest way to find out you forgot one.

© k4ditano, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in agentes/skills/k4 of k4ditano/k4.

  • SKILL.md
  • barra.md
  • plugins.md

Open the folder on GitHubat commit 5b1406c

Compare with similar skills

K4 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

K4 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
K4 this skillk4ditano/k4123—~647Automated safety check: PassMIT
Record Demolibnativeapi/nativeapi161—~2.9kAutomated safety check: PassMIT
Runyte Demo Videosrunyte/runyte105—~1.3kAutomated safety check: PassMPL-2.0
Env Setupwwwzhouhui/skills_collection282—~3.5kAutomated safety check: NotesNone
Ffmpeg Skilljiushiwon/wg-skills112—~1.4kAutomated safety check: PassApache-2.0
Youtube DownloaderOpenMinis/MinisSkills444—~1.8kAutomated safety check: PassMIT

Similar skills

  • Record Demo

    libnativeapi/nativeapi

    Record a demo video of a desktop app — launch it, play a scripted scenario with smooth synthetic mouse input, and capture the screen (cursor and click highlights included) straight to an…

    161 GitHub stars~2.9k tokensUpdated yesterday
    Media & CreativeAuto-check passed

  • Runyte Demo Videos

    runyte/runyte

    Design and record scripted videos of real Runyte features on Linux from a user's demo description.

    105 GitHub stars~1.3k tokensUpdated today
    Media & CreativeAuto-check passed

  • Env Setup

    wwwzhouhui/skills_collection

    Checking and provisioning the machine's environment for the video-agent-kit plugin — probing for ffmpeg/ffprobe that actually carry the encoders and filters we render with (libx264/aac/libmp3lame…

    282 GitHub stars~3.5k tokensUpdated 2 days ago
    Media & CreativeAuto-check: notes

  • Ffmpeg Skill

    jiushiwon/wg-skills

    FFmpeg 多媒体处理技能 — 将自然语言描述转为正确的 ffmpeg 命令，覆盖视频剪辑、转码、水印、合成、提取、生成等操作。内置一键安装脚本（Windows/Mac/Linux）。触发词：ffmpeg、视频剪辑、视频裁剪、视频转码、视频压缩、去水印、加水印、视频拼接、视频合成、提取音频、视频转…

    112 GitHub stars~1.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed

  • Youtube Downloader

    OpenMinis/MinisSkills

    Download YouTube videos or extract audio using yt-dlp + ffmpeg in the Linux shell.

    444 GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed

  • Ppt Compressor

    LeoYeAI/openclaw-master-skills

    This skill should be used when the user wants to compress a PowerPoint (.pptx) file by reducing the size of embedded videos and large images.

    2.2k GitHub stars~3.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed

Works with

Categories

Questions about K4

What does K4 do?

Use this whenever the user is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does, write a plugin for it, or debug one. K4 is an agent skill from k4ditano/k4. Use this whenever the user is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does, write a plugin for it, or debug one.

When should I use K4?

K4 fits situations like: is on a machine running k4 — the Dynamic Island-style bar for Hyprland — and wants to change what the bar does; write a plugin for it; the user says make me a widget/plugin for my bar and the bar is k4.

How do I install K4 in Claude Code?

Run `npx skills add k4ditano/k4 --skill k4 -a claude-code`. Or copy the skill folder (agentes/skills/k4 in k4ditano/k4) into .claude/skills/k4 in your project. Claude Code loads it when a task matches its description.

How do I install K4 in Codex?

Run `npx skills add k4ditano/k4 --skill k4 -a codex`. Or copy the skill folder (agentes/skills/k4 in k4ditano/k4) into .agents/skills/k4 in your project. Codex loads it when a task matches its description.

Can I use K4 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add k4ditano/k4 --skill k4 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/k4, .gemini/skills/k4, .github/skills/k4 and .opencode/skills/k4 in your project.

What does K4 need to run?

SKILL.md names no scripts, command-line tools or credentials: K4 is instructions for the agent only. Our summary lists: Python 3.

Does K4 access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is K4 safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does K4 use?

K4 is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does K4 use?

About 647 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to K4?

Skills that share tags, products or a category with K4: Record Demo (libnativeapi/nativeapi, 161 stars), Runyte Demo Videos (runyte/runyte, 105 stars), Env Setup (wwwzhouhui/skills_collection, 282 stars) and Ffmpeg Skill (jiushiwon/wg-skills, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains K4?

k4ditano (a GitHub user) maintains it in k4ditano/k4, which has 123 GitHub stars. The repository was last updated on September 10, 2026.

Source: k4ditano/k4 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.