Agent skill

Quickshell

by ChrisTitusTech in ChrisTitusTech/titus-ai

Build, lint, and troubleshoot Quickshell QML configurations or source builds.

No licenceAuto-check passedDevelopment

Install Quickshell

skills CLI
$ npx skills add ChrisTitusTech/titus-ai --skill quickshell -a claude-code

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

GitHub CLI
$ gh skill install ChrisTitusTech/titus-ai quickshell --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/ChrisTitusTech/titus-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/quickshell .claude/skills/quickshell && 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
quickshell
GitHub stars
146
Token cost
~779 tokens
SKILL.md length
324 words
Files
6 (incl. scripts, references)
Skills in repo
17
Repo updated
First seen
Licence
None found

At a glance

Build, lint, and troubleshoot Quickshell QML configurations or source builds.

  • Works in 6 steps: Locate the project shape → Read local project instructions first… → For QML edits, resolve this skill's… → …
  • Quickshell modules
  • SKILL.md covers Core Workflow, Resources, Fast Commands and Guardrails
  • Calls cmake

What it does

Quickshell is an agent skill from ChrisTitusTech/titus-ai. Build, lint, and troubleshoot Quickshell QML configurations or source builds. Use for shell.qml, Quickshell modules, qmllint setup, runtime validation, packaging, and version-matched API guidance.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/build-and-run.md` and `references/docs-map.md`).

It sits in Development, covering Linting and formatting.

When your agent uses it

  • Quickshell modules
  • Runtime validation
  • Version-matched API guidance

Example prompts

  • “/quickshell”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Locate the project shape
  2. Read local project instructions first (AGENTS.md, README, docs, package metadata).
  3. For QML edits, resolve this skill's absolute directory, keep the working
  4. For runtime validation, load the managed config with quickshell --path or quickshell --config in a real or nested compositor/session.
  5. For documentation or API work, detect the project's target version from its
  6. For source builds, use CMake/Ninja and preserve required runtime features.

What it can do on your machine

Read from SKILL.md and the folder at commit 162d624. 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

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • cmake

    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

Quickshell loads about 779 tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 324 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~779
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.9k

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 324 words (~779 tokens).

“directory at the target project, and run its scripts/quickshell-qmllint helper before treating qmllint import errors as real.”

— opening of SKILL.md by ChrisTitusTech
name
quickshell

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (scripts, references) in .agents/skills/quickshell of ChrisTitusTech/titus-ai.

  • SKILL.md
  • agents/openai.yaml
  • references/build-and-run.md
  • references/docs-map.md
  • references/linting.md
  • scripts/quickshell-qmllint

Open the folder on GitHubat commit 162d624

Compare with similar skills

Quickshell 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.

Quickshell compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Quickshell this skillChrisTitusTech/titus-ai146—~779Automated safety check: PassNone
Install Anti-Slop Oxlint Rulesdmmulroy/anti-slop5.3k1 repos~2.2kAutomated safety check: PassMIT
Summarise Ecosystem Resultsastral-sh/ruff50k1 repos~2.2kAutomated safety check: PassMIT
Minimizing Ty Ecosystem Changesastral-sh/ruff50k—~4.6kAutomated safety check: PassMIT
Babysit PR To Pass CIsgl-project/sglang37k2 repos~3kAutomated safety check: PassApache-2.0
Rust Best Practicesfarm-fe/farm5.6k3 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Installs, updates or migrates the vendored anti-slop Oxlint plugin in a repository, keeping local rule changes and the plugin's license and provenance files.

    5.3k GitHub starsUsed in 1 repo~2.2k tokens
    DevelopmentAuto-check passed
  • Official

    A skill your agent uses when a user says "summarise ecosystem results", "summarize this ty ecosystem report", "what changed in this ecosystem run?", or asks to summarise or summarize ty ecosystem…

    50k GitHub starsUsed in 1 repo~2.2k tokens
    DevelopmentAuto-check passed
  • Official

    A skill your agent uses when a user says "minimize this ty ecosystem change", "reproduce this ecosystem result", "investigate a primer difference", "investigate a mypyprimer difference"…

    50k GitHub stars~4.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Babysit PR To Pass CI

    sgl-project/sglang

    Start and persistently pursue a goal to babysit an SGLang pull request until selected GitHub Actions workflows pass on the latest PR head.

    37k GitHub starsUsed in 2 repos~3k tokens
    DevelopmentAuto-check passed
  • Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.

    5.6k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Go Pedantry

    chromedp/chromedp

    This skill should be used when the user is writing Go code and needs guidance on Go-specific pedantry: error wrapping with fmt.Errorf and %w, interface design (accept interfaces return structs)…

    13k GitHub stars~3.7k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from ChrisTitusTech/titus-ai

All 17 skills in this repo
  • Mdbook

    ChrisTitusTech/titus-ai

    Create, edit, validate, and publish mdBook projects or mdBook-based KDP manuscripts.

    146 GitHub stars~773 tokensUpdated yesterday
    Auto-check passed
  • Code Review

    ChrisTitusTech/titus-ai

    Review code with CodeRabbit when the user requests CodeRabbit or repository policy selects it.

    146 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Find Skills

    ChrisTitusTech/titus-ai

    Find and evaluate installable agent skills when the user asks to discover skills or extend agent capabilities.

    146 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Forgejo Maintainer

    ChrisTitusTech/titus-ai

    Administer Forgejo or Gitea installations, including upgrades, backups, migrations, repository access, and Actions runners.

    146 GitHub stars~460 tokensUpdated yesterday
    Auto-check passed
  • PR Readiness

    ChrisTitusTech/titus-ai

    Validate changes and pull requests through merge readiness, including local gates, Codex review, CI, independent review, manual evidence, and unresolved review threads.

    146 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Python AI

    ChrisTitusTech/titus-ai

    Build and troubleshoot Python AI applications involving model APIs, local LLMs, retrieval, tools, agents, prompts, evaluation, or AI dependencies.

    146 GitHub stars~601 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Quickshell

What does Quickshell do?

Build, lint, and troubleshoot Quickshell QML configurations or source builds. Quickshell is an agent skill from ChrisTitusTech/titus-ai. Build, lint, and troubleshoot Quickshell QML configurations or source builds.

When should I use Quickshell?

Quickshell fits situations like: quickshell modules; runtime validation; version-matched API guidance.

How do I install Quickshell in Claude Code?

Run `npx skills add ChrisTitusTech/titus-ai --skill quickshell -a claude-code`. Or copy the skill folder (.agents/skills/quickshell in ChrisTitusTech/titus-ai) into .claude/skills/quickshell in your project. Claude Code loads it when a task matches its description.

How do I install Quickshell in Codex?

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

Can I use Quickshell 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 ChrisTitusTech/titus-ai --skill quickshell -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/quickshell, .gemini/skills/quickshell, .github/skills/quickshell and .opencode/skills/quickshell in your project.

What does Quickshell need to run?

Going by SKILL.md and its folder, Quickshell needs the command-line tools its instructions call (cmake).

Does Quickshell 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 Quickshell 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Quickshell use?

No licence was found for Quickshell or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Quickshell use?

About 779 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Quickshell?

Skills that share tags, products or a category with Quickshell: Install Anti-Slop Oxlint Rules (dmmulroy/anti-slop, 5.3k stars), Summarise Ecosystem Results (astral-sh/ruff, 50k stars), Minimizing Ty Ecosystem Changes (astral-sh/ruff, 50k stars) and Babysit PR To Pass CI (sgl-project/sglang, 37k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Quickshell?

ChrisTitusTech (a GitHub user) maintains it in ChrisTitusTech/titus-ai, which has 146 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

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