CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spear

SPEAR loop for any non-trivial agent task — Scope, Plan, Execute, Assess, Resolve. Prevents the strong-start-weak-finish failure mode by forcing an explicit MECE rubric and a Plan→Execute→Assess inner loop until the rubric passes.

Quality

71%

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 ./skills/spear/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 well-structured, highly actionable process guide with an exemplary validation feedback loop, held back by promotional padding and a broken reference to a missing example file. Fixing the dangling examples/ reference and trimming the ad footer would move it toward the top anchors.

Suggestions

Ship the referenced examples/agent-bug-fix.md file (or remove the reference) — the only bundle reference in the skill currently points to a nonexistent file.

Delete or drastically shorten the 'About this skill' promotional footer; the ~10 lines of Synter marketing links are pure token overhead in a skill body.

Tighten the MECE explanation to the operational rule (items don't overlap; together they cover everything that must pass) without re-defining the acronym at textbook length.

DimensionReasoningScore

Conciseness

The core sections are lean — gate tables, a compact anti-pattern table, and tight time budgets — but roughly ten lines of the closing 'About this skill' section are promotional padding (Synter links, utm campaigns) that earns no tokens for the task. The MECE definition also re-explains a concept Claude already knows, so the body sits at anchor 3 rather than 4.

3 / 5

Actionability

The body gives concrete, executable guidance: per-phase gate criteria ('Every rubric item is 10/10. Anything < 10 = fail'), a six-step numbered rubric-authoring procedure, an anti-pattern→correction table, and a copy-paste output format template. It falls short of anchor 5 because the worked example — the most instructive artifact — is delegated to 'examples/agent-bug-fix.md', which does not exist in the bundle.

4 / 5

Workflow Clarity

The five phases are explicitly sequenced with gate conditions per phase, a hard pass criterion (only 10/10 passes), and a built-in feedback loop: 'If Assess fails, narrow Plan to the gap … and re-run Execute + Assess. Repeat until the rubric holds.' The anti-patterns table adds error-recovery guidance, matching the top anchor exactly.

5 / 5

Progressive Disclosure

Section structure is good and the worked example is correctly pushed out of the main file, but the sole reference ('See examples/agent-bug-fix.md') points to a file that is not present in the bundle (no examples/, references/, scripts/, or assets/ directories exist). A clearly signaled reference that dangles, with all substantive content otherwise inline, lands at anchor 3.

3 / 5

Total

15

/

20

Passed

Description

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

The description clearly conveys what the skill does and is well-differentiated by its named framework, but it reads more like a definition than a trigger. Adding an explicit 'Use when…' clause with natural user phrases (e.g., bug fixes, features, multi-step refactors) would raise both completeness and trigger-term quality.

Suggestions

Add an explicit 'Use when…' clause with concrete trigger phrases, e.g., 'Use when starting any non-trivial task: bug fixes in shared code, user-visible features, multi-step refactors or migrations, customer-facing artifacts.'

Include natural synonyms users would actually say (bug fix, feature work, refactor, migration, QA rubric) instead of only framework jargon like 'MECE rubric' and 'strong-start-weak-finish'.

Briefly state the concrete outputs (problem statement + non-goals, MECE rubric, scored assessment table) so the 'what' covers what the user receives, not just the mechanism.

DimensionReasoningScore

Specificity

The description names the framework, all five phases ("Scope, Plan, Execute, Assess, Resolve") and two concrete mechanisms ("forcing an explicit MECE rubric" and "a Plan→Execute→Assess inner loop until the rubric passes"). It stops short of anchor 5 because it never states the concrete outputs (gates, rubric tables, scored assessments) or what the skill actually produces for the user.

4 / 5

Completeness

The 'what' is clear (enforces a MECE rubric and an inner Plan→Execute→Assess loop), but there is no 'Use when…' clause; "for any non-trivial agent task" is only a weak, implicit trigger. Per the rubric guideline, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

The only plausibly natural phrase is "non-trivial agent task"; terms like "SPEAR loop", "MECE rubric", and "strong-start-weak-finish failure mode" are jargon a user would not naturally say. Common trigger variations ("bug fix", "feature", "refactor", "multi-step task") appear only in the body, not the description, keeping it at anchor 3 rather than 4.

3 / 5

Distinctiveness Conflict Risk

The named SPEAR framework and its distinctive vocabulary make it unlikely to trigger for an unrelated skill, satisfying anchor 4. It is not a 5 because "any non-trivial agent task" is a broad scope that overlaps general planning and execution-management skills.

4 / 5

Total

14

/

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

Synter-Media-AI/free-skills

Path

skills/spear/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.