CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-gitlab-rereview

Re-review a GitLab merge request after new commits and reconcile the previous review

57

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./mastracode/factory/factory-skills/factory-gitlab-rereview/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 concrete, well-sequenced operational skill with strong validation and error-recovery logic throughout. Its weaknesses are presentational: monolithic run-on paragraphs and large spec-like sections inlined in SKILL.md instead of split into reference files.

Suggestions

Move the step 5 test-report comment format (section order, table columns, regression proof, not-run rules) into a reference file (e.g., references/test-report-format.md) and keep only a short summary inline.

Move the step 6 factory_review_source field semantics and cross-check/mismatch decision tree into a reference file (e.g., references/routing-checks.md), keeping the mandatory tool call and stop conditions in the main body.

Break the run-on paragraphs in steps 5-7 into bulleted sub-steps or checklists so each validation checkpoint and error-recovery branch is scannable instead of buried mid-paragraph.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows — nearly every token carries a project-specific rule — but steps 5 and 6 are ~500-word run-on paragraphs packing many distinct rules (test-report format, drift checks, routing cross-checks) into unbroken prose that could be substantially tightened and restructured. This lands on mostly-efficient-but-could-be-tightened rather than the minor-trim anchor at 4.

3 / 5

Actionability

Guidance is fully concrete and executable for an instruction-only skill: exact tool calls with field-by-field shapes (factory_review_source), exact commands (env -u GH_TOKEN -u GITHUB_TOKEN -u GITLAB_TOKEN -u GITLAB_ACCESS_TOKEN, git status --porcelain, pnpm turbo build --filter <pkg>^...), exact status values, and a fully specified comment structure with section order and table columns. Every common case is covered with copy-paste-ready specifics.

5 / 5

Workflow Clarity

A clear 1-7 sequence with explicit validation checkpoints (head confirmation, checkout equality, tree-cleanness checks before and after tests) and genuine feedback loops for error recovery (verdict rejection retry, head-drift restoration, fallback comment flow). It falls short of anchor 5 because for a process this complex the checkpoints and error-recovery branches are buried in prose rather than presented as checklists or broken-out sub-steps, making the sequence harder to follow than it should be.

4 / 5

Progressive Disclosure

Structure exists (role guard, numbered steps, explicit delegation to the bundled factory-gitlab-review skill and the factory-review category pages), but large self-contained chunks — the test-report comment format specification in step 5 and the factory_review_source routing/cross-check rules in step 6 — are inlined in SKILL.md when they clearly belong in separate reference files. This matches the anchor of some structure with inline content that should be separate, rather than the minimal-structure anchor at 2 since the sequence and references are clearly signaled.

3 / 5

Total

15

/

20

Passed

Description

61%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 tight, appropriately scoped description with good natural trigger terms and a distinct niche, held back by a missing explicit "Use when..." trigger clause and modest coverage of the underlying actions.

Suggestions

Add an explicit trigger clause, e.g. "Use when a GitLab merge request receives new commits after a previous review pass, or when re-checking or reconciling a prior MR review."

Name one or two more concrete actions (e.g., disposition prior findings, publish a fresh verdict on the new head) to broaden capability coverage without padding.

Include common synonyms such as "MR" and "follow-up review" so the description matches more of the phrases a user would naturally say.

DimensionReasoningScore

Specificity

The description names the domain ("GitLab merge request") and two concrete actions ("Re-review... after new commits", "reconcile the previous review"), but coverage is not comprehensive — verdict publishing, test gating, and finding dispositions are absent. This matches the anchor for naming the domain with 1-2 concrete actions rather than the several-specific-actions anchor above.

3 / 5

Completeness

The "what" is clear (re-review an MR after new commits and reconcile the prior pass), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by "after new commits". The judging guideline caps this dimension at 3 for a missing trigger clause, so it cannot reach the explicit what-and-when anchor at 4.

3 / 5

Trigger Term Quality

"GitLab", "merge request", "re-review", "new commits", and "previous review" are natural phrases a user would say when needing this skill. A few common variants are missing (e.g., "MR", "follow-up review", "updated commits"), fitting the good-coverage-with-gaps anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The re-review/reconciliation framing carves a clear niche distinct from a first-pass review skill and from GitHub review skills. Minor overlap risk remains with a closely related baseline "review GitLab merge request" skill, matching the mostly-distinct anchor rather than the minimal-conflict anchor at 5.

4 / 5

Total

14

/

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

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

mastra-ai/mastra

Path

mastracode/factory/factory-skills/factory-gitlab-rereview/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.