# ql-chat

The ql-chat skill from the qualitylayer set puts your agent into conversation mode. Useful when you want to talk a task through before touching code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 2101
- 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-chat/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/ql-chat

## What it does

ql-chat is one of the skills in the maxritter/qualitylayer repository. It installs like any other skill and gets invoked in conversation when you want the agent to discuss rather than edit: clarify requirements, walk through options, ask you questions first. One command pulls it in, and the skill file lands in the skills directory of your platform.

Installation differs per platform. Claude takes `npx skills add maxritter/qualitylayer --skill ql-chat -a claude-code`; Codex and Cursor use the same call with `-a codex` and `-a cursor`; OpenCode uses `-a opencode`. GitHub Copilot installs through `gh skill install maxritter/qualitylayer ql-chat`, and Gemini CLI through `gemini skills install` with the skill path inside the repository.

The package ships under a proprietary license, so check the terms before dropping it into a work project. The skill targets the agent platforms listed above; Claude.ai is not one of them.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add maxritter/qualitylayer --skill ql-chat -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-chat/SKILL.md

## When to use it
- talk a task through with the agent before writing code
- pin down requirements in a back-and-forth
- compare solution options inside the chat
- switch the agent from editing files to asking questions

## Example prompts
- invoke the ql-chat skill and walk me through the architecture of this module
- ql-chat: let's talk through how to split this task into steps first
- load ql-chat and ask me questions about the requirements

## Similar
- [chat-sdk](https://affpapa.org/en/nevibecode/skills/vercel-chat-sdk.md) — skill · 5400 installs
- [setup-vivox-voice-chat](https://affpapa.org/en/nevibecode/skills/setup-vivox-voice-chat.md) — skill · 5000 installs
- [Chat with PDF](https://affpapa.org/en/nevibecode/skills/chat-with-pdf.md) — skill · 4800 installs
- [understand-chat](https://affpapa.org/en/nevibecode/skills/understand-chat.md) — skill · 3800 installs
- [chat-with-anyone](https://affpapa.org/en/nevibecode/skills/chat-with-anyone.md) — skill · 2100 installs
- [integrate-atlas-chat](https://affpapa.org/en/nevibecode/skills/integrate-atlas-chat.md) — skill · 1900 installs

From the same set: [maxritter/qualitylayer](https://affpapa.org/en/nevibecode/by/maxritter/qualitylayer.md) — 2 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
