ql-quality — Claude Code skill: what it does, how to install
ql-quality is a skill from the qualitylayer set that hooks into your coding agent and works on code quality inside the project.
npx skills add maxritter/qualitylayer --skill ql-quality -a claude-codeWhat ql-quality does
ql-quality ships as part of the qualitylayer collection by maxritter. You install it into an agent and it gets picked up when the agent works on your codebase. Supported agents include Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.
Install runs through npx skills add maxritter/qualitylayer --skill ql-quality with a per-agent flag such as -a claude-code. GitHub Copilot takes a different route: gh skill install maxritter/qualitylayer ql-quality. The skill file then lands at a path like ~/.claude/skills/ql-quality/SKILL.md or .cursor/skills/ql-quality/SKILL.md, depending on the agent.
The license is proprietary, so check the repository terms before you install. Gemini CLI also has a second option — installing straight from GitHub by pointing at the skill folder path.
What it helps with
- wire code quality checks into your agent
- install the same skill across several editors
- locate the skill file after installation
- distribute skills to agents without copying files by hand
Example prompts for the agent
- Install the ql-quality skill:
npx skills add maxritter/qualitylayer --skill ql-quality -a claude-code - Check that the ql-quality skill is active in this project
- Add ql-quality for Cursor with
npx skills add maxritter/qualitylayer --skill ql-quality -a cursor
How to install ql-quality
1Skills CLI (Vercel)
npx skills add maxritter/qualitylayer --skill ql-quality -a claude-code2Manually: put the files in place
~/.claude/skills/ql-quality/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ql-quality/
1Skills CLI (Vercel)
npx skills add maxritter/qualitylayer --skill ql-quality -a codex2Manually: put the files in place
.agents/skills/ql-quality/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add maxritter/qualitylayer --skill ql-quality -a cursor2Manually: put the files in place
.cursor/skills/ql-quality/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install maxritter/qualitylayer ql-quality2Manually: put the files in place
.github/skills/ql-quality/SKILL.md1Skills CLI (Vercel)
npx skills add maxritter/qualitylayer --skill ql-quality -a gemini-cli2Platform CLI
gemini skills install https://github.com/maxritter/qualitylayer --path qualitylayer/src/skills/ql-qualityManually: put the files in place
.devin/skills/ql-quality/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add maxritter/qualitylayer --skill ql-quality -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ql-quality
How do I install ql-quality in Claude?
Run npx skills add maxritter/qualitylayer --skill ql-quality -a claude-code. The skill file ends up at ~/.claude/skills/ql-quality/SKILL.md.
What does the ql-quality skill do?
It gives your agent code quality work inside the project. The skill is part of the qualitylayer set and installs with its own command.
Which agents support ql-quality?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each has its own install flag, and Copilot uses gh skill install maxritter/qualitylayer ql-quality.
