CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-and-planning

Perform structured research and turn findings into an implementation plan.

Quality

52%

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

Quality

Content

33%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 maximally lean but hollow: it contains only a purpose sentence and two reference links, and those referenced files are absent from the bundle, leaving no actionable guidance or workflow at all. The progressive-disclosure skeleton is the right pattern, but it points at nothing.

Suggestions

Create the referenced files (or fix the paths — 'reference/' does not exist in the bundle) so 'reference/research.md' and 'reference/make-plan.md' resolve to real content.

Add the core workflow inline in the body: the sequence for clarifying requirements, researching, and drafting the plan, with an explicit validation checkpoint (e.g. confirm the plan addresses each requirement before finalizing).

Include a minimal concrete template or example of the expected plan output so the guidance is actionable even before following the references.

DimensionReasoningScore

Conciseness

The body is 8 lines with zero padding: a purpose sentence and a two-item reference list, with no explanation of concepts Claude already knows. Every token earns its place, matching the 'lean and efficient' anchor; it is not a 4 because there are no instances of over-explanation to trim.

5 / 5

Actionability

'Use this skill to clarify requirements and produce a plan before implementation' describes intent without any concrete steps, commands, examples, or criteria — and the two reference links that would carry the actual guidance point to files that do not exist in the bundle. This matches 'entirely vague or abstract; only describes rather than instructs'; it is not a 2 because not even high-level executable hints are present.

1 / 5

Workflow Clarity

The skill is inherently a multi-step process (research, then produce a plan) but the body provides no sequence, no steps, and no checkpoints of any kind — the workflow exists only in the referenced files, which are missing. This matches 'steps missing or incoherent; no sequence'; it is not a 2 because not even a rough step list is present.

1 / 5

Progressive Disclosure

The References section is a well-formed one-level-deep overview pattern in shape, but both links ('reference/research.md', 'reference/make-plan.md') point to files that do not exist anywhere in the bundle, so the promised detail is unreachable and the skill is an empty shell. This lands at 'minimal structure' rather than a 3-4 'references present and clear', because navigation is broken; it is not a 1 because the body is a small organized overview rather than a monolithic wall of text.

2 / 5

Total

9

/

20

Passed

Description

50%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 is concise and states a clear two-part capability in third person, but it omits any 'when to use' trigger guidance and offers only high-level actions with thin keyword coverage. Its broad research/planning framing also creates overlap risk with many similar skills.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to investigate a topic, explore requirements, or produce a plan before implementation.'

Enumerate the concrete actions involved (e.g. 'gather sources, summarize findings, draft a step-by-step implementation plan') to raise specificity.

Include natural synonyms users would say ('research', 'investigate', 'requirements', 'spec', 'plan before coding') to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain and two actions — 'Perform structured research' and 'turn findings into an implementation plan' — but these stay at a high level with no further concrete actions, matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not a 4 because it does not list several specific actions, and not a 2 because the actions named are more than a generic domain label.

3 / 5

Completeness

The 'what' is clear (structured research plus turning findings into an implementation plan), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is explicit rather than vague, and not a 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

'structured research', 'findings', and 'implementation plan' are natural phrases a user might say, but coverage stops there — missing common variations and synonyms like 'investigate', 'requirements', 'before coding', or 'spec'. This sits at 'some relevant keywords but missing common variations', below the 'good keyword coverage' of a 4 because there is no trigger clause supplying additional natural terms.

3 / 5

Distinctiveness Conflict Risk

The two-stage research-to-plan pipeline gives it some shape, but 'research' and 'plan' are broad terms that overlap heavily with general research, planning, and brainstorming-style skills. It fits 'somewhat specific but could still overlap with similar skills'; it is not a 2 because the pipeline framing is more specific than a bare domain label, and not a 4 because no distinct trigger terms set it apart.

3 / 5

Total

12

/

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

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

pymc-labs/CausalPy

Path

.agents/skills/research-and-planning/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.