CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qa

Run functional QA for Zipper. Maps the git diff to CLI flows, tests the built application through Droid Control, and writes a concise QA report. Use when testing PRs, releases, or local changes.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

An exceptionally actionable orchestration skill: every step carries exact commands, paths, formats, and validation/BLOCKED checkpoints with failure-recovery loops, and detail is pushed to separate config, sub-skill, and template files. The only tightening opportunities are minor repetition around Compose conditions and snapshot-validator quirks, and making file references more clearly navigable.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and explains nothing Claude already knows — every line is operational instruction — matching 'efficient; minor instances of over-explanation that could be trimmed'. Not 5 because §6's validator-quirk paragraph is repetitive (three consecutive 'never...' formulations) and the Compose condition is stated twice (§1 and §6); not 3 because there is no padded or concept-explaining content.

4 / 5

Actionability

Fully executable guidance throughout: exact shell snippets (RUN_ID="${QA_RUN_ID:-$(date +%s)-$$}", regex ^[A-Za-z0-9_-]+$), exact paths (qa-results/$RUN_ID/evidence/case-<number>.snapshot.txt), exact invocation format (env -u CI FACTORY_DISABLE_KEYRING=true ./qa-results/$RUN_ID/publish/Zipper …), and exact report formats (result-column emoji codes, link syntax [$label]($RUN_ID/evidence/...)). Matches 'copy-paste ready' with specific formats covering the common cases.

5 / 5

Workflow Clarity

Eight clearly numbered stages with explicit validation checkpoints and stop conditions (symlink refusal, RUN_ID regex check, existing-run-directory BLOCKED, pre-flight prerequisite checks) and error-recovery loops ('Never silently skip a flow... Continue with other relevant flows', 'Upload failures fall back to text and artifacts'). The one destructive operation (cleanup) is explicitly validated ('after verifying qa-results, the run directory, and both targets are not symlinks'), so the destructive-operation cap does not apply; this matches the 5 anchor with feedback loops and checkpoints.

5 / 5

Progressive Disclosure

Detail is appropriately delegated one level deep to clearly signaled files at point of use — config (.factory/skills/qa/config.yaml), the test menu (.factory/skills/qa-cli/SKILL.md), and the report template (.factory/skills/qa/REPORT-TEMPLATE.md) — keeping SKILL.md an orchestration overview, matching 'good structure; most content is appropriately placed'. Not 5 because the references are plain code-formatted paths rather than clearly navigable links and they point outside the skill bundle (no references/ directory exists, so they cannot be verified as bundle files).

4 / 5

Total

18

/

20

Passed

Description

87%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.

A strong description: it states what the skill does through three concrete actions and gives an explicit 'Use when' clause with concrete triggers (PRs, releases, local changes). Keyword coverage and capability breadth have minor room for improvement, but conflict risk is minimal thanks to the named product and harness.

DimensionReasoningScore

Specificity

Names three concrete actions — "Maps the git diff to CLI flows", "tests the built application through Droid Control", "writes a concise QA report" — which matches the 'several specific actions; minor gaps in coverage' anchor. It falls short of 5 because coverage is not comprehensive (e.g., the Archives/Load Files/Production Sets artifacts the body tests are not mentioned) and exceeds 3 because more than 1-2 concrete actions are listed.

4 / 5

Completeness

Explicitly answers both: what ("Run functional QA for Zipper. Maps the git diff to CLI flows, tests the built application through Droid Control, and writes a concise QA report") and when ("Use when testing PRs, releases, or local changes") with concrete trigger phrases. This mirrors the 5-anchor example's structure; a 4 would require the 'when' to be less explicit or specific than it is.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — "testing PRs", "local changes", "QA" — matching 'good keyword coverage; a few natural terms missing'. Not 5 because common variations like "verify", "regression test", or "smoke test" are absent; not 3 because the terms present go beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers — a named product (Zipper), functional QA, and a specific harness (Droid Control) — giving minimal overlap risk with other skills. It is well above the 4 anchor ('mostly distinct; minor overlap risk') because the product-scoped triggers are unlikely to fire for any other skill.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

dwojtaszek/zipper

Path

.factory/skills/qa/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.