CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

compose-next

Use for multi-step feature work, bug fixes, or refactors where requirements need to settle, a feature document should carry design + tasks + delivery evidence, and the change deserves independent review before merge. Use it only when the user explicitly requests this workflow, whether with `/compose-next`, by name, or in any other clear natural language; do not infer the request from task complexity alone. Not for one-shot edits, single-file tweaks, or answering questions — those need no orchestration overhead.

Quality

90%

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 well-sequenced workflow contract: every phase has concrete commands, templates, or exact tool-call structures, and validation with feedback loops is built into verify, review, and finish. The only room for improvement is minor token redundancy from rules stated twice and the absence of any reference-file split for the template and worktree details.

Suggestions

State the explicit-request gating once in the body (it currently appears in the intro paragraph and again as a standalone paragraph, in addition to the description) and merge the two merge-confirmation statements in Finish into a single rule.

Consider moving the spec template and amendment rules to a references/spec-template.md so the main body stays a lean phase contract — or, if the one-load design is intentional, say so where the template appears to justify its inline length.

Trim lawyered parentheticals like '(detached HEAD, an unrelated feature branch, unknown default branch)' to the single most common case, letting the 'ask the user' fallback cover the rest.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive throughout — git worktree mechanics are given as commands with no explanation of what a worktree is, and the template is shown rather than described. Minor redundancy keeps it below anchor 5: the explicit-request gating appears in both the intro ('Enter this workflow only on an explicit user request') and a standalone paragraph, and the merge-confirmation rule is stated twice in Finish ('Do not auto-finish: confirm with the user before any irreversible action' and 'the merge always needs its own confirmation'). This fits anchor 4 ('efficient; minor instances that could be trimmed'), not anchor 3, since there is no padding or concept teaching.

4 / 5

Actionability

Copy-paste-ready commands and templates throughout: 'Run `git check-ignore -q "$path"`... Then run `git worktree add "$path" -b "$branch" "$base"`', concrete dependency modes ('bun ci', 'uv sync --frozen'), a complete fill-in spec template with frontmatter, and exact Question-tool option structures. Even judgment-based sections give precise structures (the reviewer-provision list and the three required review conclusions), matching anchor 5's 'fully executable... specific examples cover the common cases' for an instruction-only skill.

5 / 5

Workflow Clarity

The full sequence is explicit ('grill → workspace → spec → implement → verify → review → finalize → finish') with decision routing in Step 0 ('Fully constrained mechanical change... → skip Grill and Spec'), explicit validation ('Verification and review are strictly sequential... Do not substitute prior output or a subagent report for fresh evidence'), error-recovery loops ('After two failed fixes, stop patching and re-derive the cause'; 'Fix critical findings, re-verify, and re-review affected areas'), non-convergence stop conditions, and destructive-action gating. This matches anchor 5's 'clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so this is a deliberately self-contained single file ('One skill load, no internal skill hand-offs') with clear per-phase section headers and no nested references. At ~200 lines it exceeds the under-50-lines exception that would allow a 5 without references, and material like the spec template, amendment rules, and worktree mechanics could be split into reference files — fitting anchor 4 ('good structure; most content is appropriately placed; minor organization gaps') rather than anchor 5, and clearly above anchor 3 since nothing is buried or poorly signaled.

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 that clearly and explicitly defines what the skill does, when to use it (explicit user request only, including the slash command and natural-language equivalents), and when not to use it. Trigger coverage is good though missing a few natural synonyms, and the capability statements are concrete but slightly abstract in places.

DimensionReasoningScore

Specificity

Quotes several concrete capabilities: 'multi-step feature work, bug fixes, or refactors', 'a feature document should carry design + tasks + delivery evidence', and 'independent review before merge'. Phrases like 'where requirements need to settle' stay somewhat abstract, so it matches anchor 4 ('several specific actions; minor gaps') rather than anchor 5's comprehensive, fully concrete action list.

4 / 5

Completeness

Explicitly answers both questions: what ('a feature document should carry design + tasks + delivery evidence, and the change deserves independent review before merge') and when ('Use it only when the user explicitly requests this workflow, whether with /compose-next, by name, or in any other clear natural language'), plus explicit exclusions ('Not for one-shot edits, single-file tweaks, or answering questions'). This matches anchor 5's 'clearly and explicitly answers both what AND when with concrete trigger phrases'; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'feature work', 'bug fixes', 'refactors', 'feature document', 'review before merge', and the explicit '/compose-next' trigger. It lacks common synonyms a user might say ('spec', 'design doc', 'workflow', 'orchestration'), matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage, and clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The gating rule 'Use it only when the user explicitly requests this workflow... do not infer the request from task complexity alone' plus the explicit exclusion list gives it a clear niche with near-zero accidental-trigger risk, matching anchor 5. Although 'bug fixes' and 'refactors' are broad domains, the explicit-consent requirement removes the overlap risk that would place it at anchor 4.

5 / 5

Total

18

/

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

XiaomiMiMo/MiMo-Code

Path

packages/cli/src/skill/builtin/.bundle/compose-next/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.