# ql-workflow

ql-workflow is a coding-agent skill from maxritter/qualitylayer that can be added to several supported development environments. Choose the installation command that matches your agent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 2102
- Author: maxritter
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/maxritter/qualitylayer/tree/HEAD/qualitylayer/src/skills/ql-workflow/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/ql-workflow

## What it does

ql-workflow belongs to the maxritter/qualitylayer repository and is intended for use with coding assistants. Its listed platforms include Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

Installation depends on the target environment. For Claude Code, run `npx skills add maxritter/qualitylayer --skill ql-workflow -a claude-code`; the resulting skill file is expected at `~/.claude/skills/ql-workflow/SKILL.md`. Codex uses `.agents/skills/ql-workflow/SKILL.md`, while GitHub Copilot has its own `gh skill install` command.

The repository uses the license identifier `LicenseRef-Proprietary`. Check that licensing status before including the skill in a project. The available description does not establish a specific code-review routine, toolset, or other operational behavior, so those capabilities should not be assumed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add maxritter/qualitylayer --skill ql-workflow -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ql-workflow/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ql-workflow/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add maxritter/qualitylayer --skill ql-workflow -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ql-workflow/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add maxritter/qualitylayer --skill ql-workflow -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ql-workflow/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install maxritter/qualitylayer ql-workflow
```

2. **Manually: put the files in place**
- File: `.github/skills/ql-workflow/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add maxritter/qualitylayer --skill ql-workflow -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/maxritter/qualitylayer --path qualitylayer/src/skills/ql-workflow
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ql-workflow/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add maxritter/qualitylayer --skill ql-workflow -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/maxritter/qualitylayer/tree/HEAD/qualitylayer/src/skills/ql-workflow/SKILL.md

## When to use it
- Add ql-workflow to a Claude Code setup
- Install the skill for a Codex project
- Configure ql-workflow in Cursor
- Connect the skill to GitHub Copilot
- Choose the matching install command for Gemini CLI or OpenCode

## Example prompts
- Add the ql-workflow skill to Claude Code for this project.
- Set up ql-workflow in Codex and check where its skill file is stored.
- Install ql-workflow in Cursor using the command intended for that environment.

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [maxritter/qualitylayer](https://affpapa.org/en/nevibecode/by/maxritter/qualitylayer.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md