CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rewrite-problem

Transforms vague or ill-defined questions into clear, structured, and actionable "good problems" by extracting the core objective, identifying comparison dimensions, and applying structured reasoning. Use when a user wants to compare multiple options, evaluate trade-offs, make a decision between alternatives, or asks questions like "which is better", "pros and cons", "help me decide", "how should I choose", or "what are the trade-offs". Produces a rewritten problem statement with explicit comparison dimensions, a structured evaluation framework, and a decision-ready output format.

Quality

89%

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

78%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 compact, well-structured instructional skill with a concrete template and a worked example that makes the process easy to follow. Main gaps: the worked example only partially demonstrates the per-dimension analysis step, output lacks an explicit validation checkpoint, and the criteria section duplicates the template.

Suggestions

Extend the worked example so Dimension Analysis demonstrates one labeled reasoning form for each listed dimension (not just the 维护成本 sub-goal), matching what step 3 requires.

Add an explicit final validation step instructing Claude to check the rewritten problem against the 验收条件 template and the 清晰/结构化/可操作 criteria before producing the output.

Merge or trim the '好问题的定义标准' section, since its content largely restates the 验收条件 template, to remove duplication.

DimensionReasoningScore

Conciseness

The ~40-line body is lean with no padding of concepts Claude already knows, but the '好问题的定义标准' section overlaps conceptually with the '验收条件' template, and '输出格式' partially restates the numbered instructions. Efficient overall with minor instances that could be trimmed; not 5 because of this duplication.

4 / 5

Actionability

Concrete numbered steps, a fill-in-the-blank acceptance template, an explicit output format, and a fully worked React-vs-Vue example make the guidance mostly executable. Not 5: the example's Dimension Analysis covers only one dimension with one reasoning form ('目的-手段实践推理') while step 3 demands an independent in-depth analysis of every dimension, leaving a minor gap in the demonstrated procedure.

4 / 5

Workflow Clarity

Steps 1-4 are clearly sequenced and the 验收条件 template acts as an implicit checkpoint, and the task is non-destructive text restructuring so no validation cap applies. Not 5: there is no explicit final validation step (e.g., re-checking the rewrite against 清晰/结构化/可操作 before output) — the checkpoints are present but implicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and content is organized into well-labeled sections (template, instructions, criteria, example, output format), which per the simple-skill scoring note qualifies for the top score.

5 / 5

Total

17

/

20

Passed

Description

96%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: concrete third-person capability statements, an explicit 'Use when' clause with verbatim user phrasings, and comprehensive trigger coverage. The only weakness is mild overlap risk with generic decision-support requests.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions in third-person voice — 'extracting the core objective, identifying comparison dimensions, and applying structured reasoning' and 'Produces a rewritten problem statement with explicit comparison dimensions, a structured evaluation framework, and a decision-ready output format' — giving comprehensive, non-generic coverage of the skill's behavior.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' ('Transforms vague or ill-defined questions into... good problems... Produces a rewritten problem statement...') and the 'when' ('Use when a user wants to compare multiple options... or asks questions like...') with concrete trigger phrases. Not 4, because the 'when' clause is already fully explicit and specific.

5 / 5

Trigger Term Quality

It includes the exact natural phrases users would say: 'which is better', 'pros and cons', 'help me decide', 'how should I choose', or 'what are the trade-offs', plus variations like 'compare multiple options' and 'evaluate trade-offs'. This is comprehensive natural-term coverage including synonyms.

5 / 5

Distinctiveness Conflict Risk

The problem-reformulation niche is distinct, but decision-flavored triggers like 'help me decide' and 'make a decision between alternatives' create minor overlap risk with a general decision-support or comparison skill. Not 5 because the trigger set is not cleanly separated from generic decision-help requests.

4 / 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

Leo-stone-dot/my_life_agent

Path

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