CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-wrapup

Prepare an approved ticket for human submission by updating durable knowledge, summarizing scope and verification, teaching material flows with progressive visuals, and providing the merge handoff. Use only after review approval. Unless codeHost.pullRequests is false, commit the approved work, push the ticket branch, and create or update the pull request. It never merges.

Quality

94%

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

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

The body is a lean, operational runbook: concrete git and gh commands with conditional branches, explicit validation checkpoints, and error-recovery guidance, with details correctly pushed to four well-signaled one-level-deep reference files. The only improvable point is mild duplication of git guardrails and controller/direct-run policy across sections.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no explanations of concepts Claude already knows, but a few guardrails are restated across sections — "Never use git add -A ... or a glob" appears in both the commit and merge-command sections, and the controller-vs-direct-run policy is repeated between the handoff sections and the final paragraph. Not 5 because those minor duplications could be consolidated; not 3 because almost every sentence carries non-obvious, skill-specific instruction.

4 / 5

Actionability

Fully executable commands throughout: git status --porcelain, staged adds by path, commit message format, push -u, and both gh pr edit and gh pr create paths with heredoc bodies, plus placeholder conventions. Not 4: both conditional branches (existing PR vs new PR) and failure handling are concretely covered, leaving no gaps.

5 / 5

Workflow Clarity

Clear sequence (readiness → durable knowledge → handoff → PR → merge commands → output) with explicit validation checkpoints — "The last command must print nothing", gh pr list before create/edit, controller verification that the PR head is local HEAD — and error recovery ("If the commit, the push, or gh fails, report the exact command and its error ... print the remaining commands"). Despite involving destructive-adjacent git operations, validation and feedback loops are present, so no cap applies.

5 / 5

Progressive Disclosure

The SKILL.md is an operational overview, and all four referenced files (visual-explanations.md, usage-table.md, panes-handoff.md, output.md) exist, are one level deep, and are loaded conditionally with clear signals such as "Read [references/visual-explanations.md] whenever the change has three or more moving parts". Not 4: navigation is easy, splitting is appropriate, and no nesting or buried references exist.

5 / 5

Total

19

/

20

Passed

Description

92%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 enumerates the skill's concrete actions comprehensively, states an explicit and gated use condition, and defines a distinct niche in the factory pipeline. The only weakness is slightly narrow trigger vocabulary that omits natural synonyms a user might say.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "updating durable knowledge", "summarizing scope and verification", "teaching material flows with progressive visuals", "commit the approved work, push the ticket branch, and create or update the pull request" — with comprehensive coverage of the wrap-up workflow, matching the anchor-5 example's action density. Not 4: there are no meaningful gaps in the action coverage for this skill.

5 / 5

Completeness

Clearly answers both: the what is the full action list above, and the when is explicit — "Use only after review approval" — with the additional gating "Unless codeHost.pullRequests is false". Not 4: the when clause is explicit and specific, not merely present-but-vague.

5 / 5

Trigger Term Quality

Good keyword coverage — "approved ticket", "review approval", "commit", "push the ticket branch", "pull request", "merge handoff" — but common natural phrasings such as "wrap up", "finalize", or "close out" are absent. Not 5 because synonyms and user-natural variations are missing; not 3 because the domain terms are well covered rather than merely "some relevant keywords".

4 / 5

Distinctiveness Conflict Risk

"Use only after review approval" and "Prepare an approved ticket for human submission" carve out a clear factory wrap-up niche, and "It never merges" bounds it against merge skills. Not 4: the gating trigger is distinct enough that overlap risk with a generic PR-creation skill is minimal.

5 / 5

Total

19

/

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

geut/factory-skills

Path

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