CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mflux-pr

Make a clean PR in mflux (inspect diff, quick verification, commit, push, open PR) using repo conventions.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.cursor/skills/mflux-pr/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, exemplar skill body: almost every line is non-obvious repo-specific knowledge delivered as executable commands, tables, and checklists, with detail properly delegated to sibling skills. The only gaps are a missing concrete git command for the cross-model diff audit and the implicit ordering of the core commit/push/PR sequence.

DimensionReasoningScore

Conciseness

The body is ~68 lines of dense, repo-specific knowledge (just commands, file-category tables, model-port checklists) with no padding and no explanation of concepts Claude already knows — every token earns its place.

5 / 5

Actionability

Mostly executable, copy-paste-ready commands (`just lint`, `just test-fast`, `just ci-extract`, the MFLUX_PRESERVE_TEST_OUTPUT pytest invocation, the `du -sh`/`mflux-save` measurement block), but 'List files changed outside src/mflux/models/<model>/' omits the git command and commit-message guidance ('consistent with repo history') stays abstract.

4 / 5

Workflow Clarity

Validation checkpoints are explicit (lint, golden tests, CI release-note check) and there is a real feedback loop ('If the check fails on an open PR, use the mflux-pr-docs skill again... The check runs again on an edit'), but the top-level commit→push→open-PR sequence is only implied rather than laid out stepwise in the body. Not 5 because the core sequence relies on the description rather than being sequenced here; not 3 because checkpoints and error recovery are explicit and concrete.

4 / 5

Progressive Disclosure

No bundle files exist, and the body appropriately delegates detail one level deep to clearly signaled sibling skills ('use the mflux-pr-docs skill to write the PR body', 'see mflux-model-porting → Integration surfaces checklist') while keeping compact inline checklists; sections are well organized and easy to navigate.

5 / 5

Total

18

/

20

Passed

Description

66%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 concise, concrete, well-scoped description whose main weakness is the missing 'when' guidance: it says clearly what the skill does but never states when Claude should invoke it, capping completeness. Trigger terms are good but would benefit from the full 'pull request' phrasing.

Suggestions

Add an explicit trigger clause, e.g. 'Use when about to open a pull request in the mflux repository or when the user asks to commit, push, or create a PR in mflux.'

Include the spelled-out 'pull request' (alongside 'PR') so the description matches users who say either form.

Hint at the required PR-body/release-note step (e.g. 'includes delegating the PR body and release note to mflux-pr-docs') so the 'what' covers the CI-enforced part of the workflow.

DimensionReasoningScore

Specificity

'inspect diff, quick verification, commit, push, open PR' lists several specific concrete actions, but 'quick verification' is generic and the required PR-body/release-note step (a CI-enforced part of the workflow per the body) is missing from the description. Not 5 because of these minor coverage gaps; not 3 because multiple concrete actions are explicitly named.

4 / 5

Completeness

The 'what' is clear (make a clean PR in mflux via the listed steps), but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description — the 'when' lives only in the body's 'When to Use' section. Per the judging guidelines, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms users would say — 'PR', 'commit', 'push', 'diff', 'repo' — are present, but common variations like the spelled-out 'pull request' or 'open a pull request' are missing. Not 5 because synonym coverage is incomplete; not 3 because keyword coverage is good rather than partial.

4 / 5

Distinctiveness Conflict Risk

'Make a clean PR in mflux' carves out a clear repo-scoped niche, but closely related sibling skills (e.g. 'mflux-pr-docs' for PR bodies) and generic PR-creation behavior create minor overlap risk. Not 5 due to that overlap with closely related skills; not 3 because the mflux scoping and concrete step list make it mostly distinct.

4 / 5

Total

15

/

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: 2 missing

Warning

Total

15

/

16

Passed

Repository

mflux-community/mflux

Path

.cursor/skills/mflux-pr/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.