CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

shaping

Use this methodology when collaboratively shaping a solution with the user - iterating on problem definition (requirements) and solution options (shapes).

Quality

72%

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 ./shaping/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.

The skill body is a dense, highly actionable methodology definition with concrete templates, conventions, and worked examples throughout — its main quality risks are length and self-containment rather than vagueness. Splitting peripheral sections (spikes, breadboarding/slicing, examples) into reference files and trimming repeated rules would improve both conciseness and progressive disclosure.

Suggestions

Move separable material — spike structure/format, breadboarding and slicing details, and the closing worked example — into reference files (e.g., references/spikes.md, references/slicing.md) and link them from short summary sections in SKILL.md.

De-duplicate repeated rules: the fit-check binary rule appears in both 'Conventions' and 'Flagged Unknown', and breadboarding's tables-as-source-of-truth point is restated in the Slicing section.

Trim justification prose ('Why This Matters', 'Why "Detail X" Not "C"') to one-line rationales to cut token cost without losing the rules.

DimensionReasoningScore

Conciseness

Most content is novel methodology-specific rules that earn their tokens, but the ~590-line body includes unnecessary repetition and padding: the fit-check binary rule is stated twice ('Fit check is BINARY' and again in 'Flagged Unknown'), the spike and breadboarding sections restate overlapping points, and sections like 'Why This Matters' add justification prose. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where such instances would be minor.

3 / 5

Actionability

For an instruction-only skill the guidance is fully concrete and copy-paste ready: exact markdown templates for fit checks, shape tables, spike files, and source capture, plus explicit good/bad examples ('E: Modify CUR in place...' vs 'E: The solution') and precise rules (chunking at 9 top-level requirements, 🟡 change markers). Per the rubric's code_vs_instruction note, absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The Phases section, phase-transition criteria, and Possible Actions list give a clear sequence, and there are genuine feedback loops (missing requirement → new R → re-run fit check; spike → then decide). It falls short of 5 because 'Possible Actions' explicitly states 'These can happen in any order' without a canonical checklist ordering, and document-sync steps rely on the tooling hook rather than an explicit validation step. It sits above 3, where checkpoints would be missing or implicit.

4 / 5

Progressive Disclosure

The body has good section headers and internal navigation, but no bundle files exist (references/, scripts/, assets/ are absent) and clearly separable material — spike structure, breadboarding details, slicing, and the worked example — is inlined in a single ~590-line file. This matches 'Some structure but could be better organized; content that should be separate is inline' rather than 2, because headers make navigation easy and the only external pointer (the /breadboarding skill) is clearly signaled.

3 / 5

Total

15

/

20

Passed

Description

62%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 correctly includes an explicit 'Use when' clause and names both halves of the methodology (problem definition and solution options), but it relies on the skill's own jargon and a circular trigger. Adding concrete natural trigger phrases and specific capabilities would raise completeness and trigger quality.

Suggestions

Replace the circular trigger 'when collaboratively shaping a solution' with concrete natural phrases users would say, e.g. 'Use when the user wants to explore or compare solution approaches, define requirements, or decide between design options'.

List a few more concrete capabilities (e.g., building fit-check decision matrices, running spikes, breaking a chosen approach into slices) to strengthen specificity and completeness.

Add common synonyms such as 'explore options', 'problem framing', and 'requirements gathering' to broaden trigger term coverage.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions — 'iterating on problem definition (requirements)' and 'solution options (shapes)' — but these are the methodology's own abstractions rather than concrete capabilities, and coverage is not comprehensive. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; a 4 would require several specific actions with only minor gaps, which the single generic sentence does not provide.

3 / 5

Completeness

Both parts are present: 'what' is 'iterating on problem definition (requirements) and solution options (shapes)' and 'when' is explicit ('Use this methodology when collaboratively shaping a solution with the user'). The trigger clause is present but somewhat circular and could be more specific, matching 'Has both what and when; when could be more explicit or specific'; it falls short of 5, which demands concrete trigger phrases like the PDF example.

4 / 5

Trigger Term Quality

It carries some relevant natural terms ('shaping', 'requirements', 'solution options') but misses common variations a user would say, such as 'explore options', 'problem definition', 'design', or 'proposal'. This fits 'Some relevant keywords but missing common variations or synonyms' rather than 4, where keyword coverage would be good with only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

'Shaping' plus the requirements/solution-options framing carves a fairly distinct niche with low conflict risk against unrelated skills, matching 'Mostly distinct; minor overlap risk'. It is not a 5 because the trigger 'collaboratively shaping a solution' could still overlap with general planning, design, or requirements-gathering skills.

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

skill_md_line_count

SKILL.md is long (594 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

rjs/shaping-skills

Path

shaping/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.