CtrlK
BlogDocsLog inGet started
Tessl Logo

research

Structure a research based on the user request. Identify what must change in order to complete the task.

45

Quality

47%

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

Quality

Content

61%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 content is concise and reasonably organized with concrete output paths, but its testing workflow lacks executable detail and validation checkpoints. Strengthening the verify loop and specifying how to run/evaluate temp files would lift the weaker dimensions.

Suggestions

Specify how to create and run the temp Python files (e.g., `python tmp_check.py` and what output to look for) instead of 'check the logics you are thinking'.

Add an explicit validation checkpoint before deleting temp files (e.g., 'Confirm the script exits 0 and output matches expectations, then delete').

Give a concrete example of documenting assumptions and comparing approaches in the research .md so the deliverable is unambiguous.

DimensionReasoningScore

Conciseness

The body is lean with no padding of concepts Claude already knows; only minor awkward phrasing ('check the logics you are thinking') could be trimmed, keeping it just below the fully lean 5 anchor.

4 / 5

Actionability

It gives concrete paths (`.cursor/plans/{plan_name_folder}/research` as a `.md`) but the testing guidance ('check the logics you are thinking on the root folder') is vague and missing key execution details, fitting the incomplete 3 anchor.

3 / 5

Workflow Clarity

The 'You must' list plus sections provide a rough sequence, but there are no validation checkpoints and the create/delete-temp-files step is unverified; the rubric caps such batch/file operations at 3.

3 / 5

Progressive Disclosure

Under 50 lines with no bundle files, organized into labeled sections ('Python test validations', 'Document base'); good structure with minor organization gaps rather than the fully clean 5 anchor.

4 / 5

Total

14

/

20

Passed

Description

33%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 conveys a general research/analysis purpose but is vague and lacks any trigger ('Use when...') guidance. Its generic phrasing gives it high conflict risk with other planning skills.

Suggestions

Add an explicit 'Use when ...' clause naming concrete trigger situations (e.g., 'Use when planning code changes before implementation').

Replace generic verbs with specific deliverables (e.g., 'Produces a research plan at .cursor/plans/{name}/research.md identifying files to change and chosen approach').

Add domain-specific keywords users would naturally say (e.g., 'investigate', 'plan', 'impact analysis', 'research before coding').

DimensionReasoningScore

Specificity

Names the research domain but the actions ('structure a research', 'identify what must change') are minimal and generic rather than concrete; it does not reach the 1-2 concrete-action threshold of a 3.

2 / 5

Completeness

It states a clear-enough 'what' (structure research, identify changes) but provides no 'when'/Use-when guidance, so per the rubric guideline a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Only the generic keyword 'research' appears; there are no natural trigger phrases a user would actually say, matching the 'one or two generic keywords' anchor and falling below the 3 anchor's partial coverage.

2 / 5

Distinctiveness Conflict Risk

'research', 'user request', and 'complete the task' are very broad and would overlap with many coding skills; not generic enough for a 1 but well above the 3 anchor's 'somewhat specific'.

2 / 5

Total

9

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pymc-labs/pymc-marketing
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.