CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deep-research

Load for research tasks, architectural investigations, and vendor, library, or technology comparisons.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/deep-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

90%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 dense, lean operational guide: executable commands, a precise mode table, explicit validation with exit-code semantics, and a post-validation checklist. The only gaps are the missing fix-and-revalidate loop and the referenced-but-absent templates/findings.md in the bundle.

DimensionReasoningScore

Conciseness

Every line carries information Claude could not know: Exa mode table with result counts/text caps/timeouts, flag semantics ("--include-domain is a hard host filter, not a quality filter"), sidecar rules, and env-var/1Password handling. No known concepts are re-explained and no section is padded, matching 'Lean and efficient; every token earns its place'.

5 / 5

Actionability

The Running and Validation sections give copy-paste-ready commands with full paths covering report, query-file, json, validate, and doctor invocations, plus the mode table, overrides, and validate's output shape ("{ok, errors, warnings, mode, synthesis, queryCount}") and exit semantics. This matches 'Fully executable; copy-paste ready commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The sequence is clear and validation is explicit: run the report (mode chosen up front), write findings.md plus sidecar, then "run `validate` and stop", with "exits 0 when there are no errors" and a manual read-back checklist (contradicted claims, off-topic sources, unsupported recommendations). It sits below 5 only because no fix-and-revalidate loop is spelled out for validation failures — 'Clear sequence with most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

The body is a lean overview that pushes detail into the script: `scripts/deep-research` exists in the bundle and references (`agents/planner.md`, `templates/findings.md`, `../code-quality/SKILL.md`) are one level deep and each is signaled with its purpose. It falls short of 5 because `templates/findings.md` and `agents/planner.md` are referenced but not present in the bundle, a minor organization gap matching 'Good structure; most content is appropriately placed; references mostly clear'.

4 / 5

Total

18

/

20

Passed

Description

43%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 provides explicit trigger guidance with natural keywords, but it omits the 'what' entirely — no capability, action, or artifact is stated. Adding a one-clause statement of what the skill does would lift both completeness and specificity substantially.

Suggestions

State what the skill does, e.g. "Exa-powered research that produces an evidence-backed findings.md report with cited sources" — this gives the description a concrete 'what' for completeness and specificity.

Fold in artifact-oriented trigger terms such as "findings report", "X vs Y comparison", or "evaluate options" so users naming the output naturally hit the skill.

Mention the report deliverable explicitly ("writes a findings.md report") so the skill is distinguishable from generic research or search skills.

DimensionReasoningScore

Specificity

The description names the domain ("research tasks, architectural investigations, and vendor, library, or technology comparisons") but lists no concrete actions — there is no verb stating what the skill actually does (e.g., produce a report, run a search). This matches the anchor 'Names the domain but actions are minimal or generic'; it is below 3 because no capability at all is stated, and above 1 because the domain categories are specific.

2 / 5

Completeness

Only the 'when' is present ("Load for research tasks, ...") with no 'what' — the description never says what the skill does (Exa-powered research producing an evidence-backed findings.md report, per the summary field). This matches the anchor 'only "when" is present without "what"'. It cannot be 3 because that anchor requires a clear 'what', and the explicit 'Load for...' trigger keeps it above 1.

2 / 5

Trigger Term Quality

Natural terms users would say are present: "research", "vendor, library, or technology comparisons", "architectural investigations". This matches 'Good keyword coverage; a few natural terms missing' — variants like "evaluate options", "X vs Y", "deep research", or "due diligence" are absent, keeping it below 5, while coverage clearly exceeds the 'some relevant keywords but missing common variations' level of 3.

4 / 5

Distinctiveness Conflict Risk

"vendor, library, or technology comparisons" is a fairly distinct niche, but "research tasks" and "architectural investigations" are broad and would overlap with other research or code-analysis skills. This matches 'Somewhat specific but could still overlap with similar skills' — above 2 because the comparison framing is not generic, below 4 because of the broad leading terms.

3 / 5

Total

11

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

vanillagreencom/kendex

Path

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