CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qtpass-fixing

Fixes QtPass bugs end to end, finding the root cause in src/, making a minimal fix, adding a Qt Test regression test, re-running make check until it passes and opening a signed PR. Use when handling a QtPass bug, issue, crash, regression, error message, failing test, patch, or a CodeRabbit or static analysis finding on a PR.

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, exemplary bugfix workflow: every token is project-specific, commands and code are executable, the verify loop has explicit checkpoints and a hard green gate, and detail is properly split into two conditionally-triggered, one-level-deep reference files. No dimension shows a gap against the top anchors.

DimensionReasoningScore

Conciseness

Every section carries repo-specific knowledge Claude cannot derive — the `qCDebug` release-build behavior, the "Qt version floor: 6.8" guard, "Store indices, not pointers", the squash-merge policy — with zero padding and no explanation of general Qt/C++ concepts. The one-line rationales (e.g. "A pointer to a loop reference dangles once the list changes") justify project rules rather than teach basics, so it sits at the lean anchor rather than the "could be trimmed" one.

5 / 5

Actionability

Guidance is copy-paste ready throughout: `gh issue list --search`, `make -j4 && make check`, re-running a single binary via `./tests/auto/<module>/tst_<module> <testFunction> -v2`, `git commit -s -S -m ...`, and a complete `gh pr create` body template, plus runnable C++ fix snippets and a playbook table naming exact files. Specific examples cover the common fix cases, matching the fully-executable anchor.

5 / 5

Workflow Clarity

The six-step sequence has an explicit verify loop ("loop until green"), error-recovery feedback ("read the first failure, fix the code... then re-run only that binary"), regression validation ("Confirm the new test fails against the unfixed code"), and a hard gate ("Only move on when the full make check passes"). The review-findings flow adds verify-then-fix-or-rebut steps, matching the anchor with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

Both referenced files exist and are one level deep, each signaled with a conditional read trigger: "Read [references/fix-patterns.md]... when the fix touches dialogs, colors, paths, env vars..." and "Read [references/tooling.md]... when CI lint fails". The split is deliberate — the five most frequent fix patterns inline, less frequent ones in the reference per its own design note — giving a clear overview with well-signaled navigation and no nesting.

5 / 5

Total

20

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete multi-step capabilities, an explicit "Use when" clause with natural trigger synonyms, and a clearly bounded QtPass bugfix niche. It matches the strongest anchor on every dimension with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "finding the root cause in src/", "making a minimal fix", "adding a Qt Test regression test", "re-running make check until it passes and opening a signed PR" — comprehensively covering the end-to-end bugfix workflow, matching the top anchor exactly. Not 4 because coverage is complete rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the full fix-to-PR pipeline in the first sentence, and the "when" is a concrete "Use when handling..." clause enumerating trigger scenarios. This mirrors the anchor-5 example structure verbatim; nothing is merely implied.

5 / 5

Trigger Term Quality

Trigger terms are natural user phrasings with good synonym coverage: "bug, issue, crash, regression, error message, failing test, patch, or a CodeRabbit or static analysis finding on a PR" — the way a user would actually describe needing this skill. No common variation of the bug-report vocabulary is missing, so it fits the comprehensive anchor rather than the "a few natural terms missing" anchor.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche ("Fixes QtPass bugs end to end") with triggers scoped to QtPass bug scenarios, distinguishable from sibling skills like testing or linting. All trigger phrases are anchored to the QtPass/bug context, so wrong-skill firing risk is minimal.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

IJHack/QtPass

Path

.opencode/skills/qtpass-fixing/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.