CtrlK
BlogDocsLog inGet started
Tessl Logo

research-report

Convert per-item JSON results from /ultra-research:research-deep into a single markdown report with table of contents and per-item sections. Uses a bundled converter script — no per-run script regeneration.

57

Quality

66%

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

Quality

Content

75%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 a well-organized, actionable workflow that leans on a bundled converter and a single one-level-deep reference doc, with clear sequencing and light validation. Minor verbosity and placeholder arguments keep most dimensions at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is mostly lean and actionable with concrete commands, but carries minor over-explanation such as the '--format both' rationale ('covers users who skim in a browser AND users who want raw markdown') and the multi-line legacy path fallback, keeping it just below the fully lean anchor 5.

4 / 5

Actionability

Provides copy-paste-ready bash and python invocations with explicit flags and a Glob pattern, but several arguments remain placeholders (<topic_dir>, <output_dir>, <comma-separated user selections>) and the core conversion logic is delegated to the bundled script rather than shown inline, so it is mostly executable with minor gaps at anchor 4.

4 / 5

Workflow Clarity

Four steps are clearly sequenced with a confirm check in Step 1 ('Confirm the results directory exists and contains JSON files') and a sanity-check offer in Step 4; because report generation is neither destructive, batch, nor XML/database manipulation the cap does not apply, but the lack of an explicit post-generation validation step keeps it at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The body is a well-structured overview with clear sections (Trigger, Pipeline Context, Workflow, Output, References, Scripts) and a clearly signaled one-level-deep reference to references/converter-contract.md, which exists in the bundle; it stops short of the anchor-5 pattern of multiple signposted reference links but is solidly above anchor 3.

4 / 5

Total

16

/

20

Passed

Description

58%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 specific and clearly tied to a distinct pipeline niche, but it lacks an explicit 'Use when...' trigger clause and its keyword coverage is pipeline-bound rather than covering natural user phrasings. Completeness is consequently capped at 3.

Suggestions

Add an explicit 'Use when...' clause naming natural trigger phrases (e.g., 'Use when finishing a research-deep run and the user wants a consolidated report, or when they ask to compile/summarize research results into a document').

Broaden trigger-term coverage with synonyms and extensions a user might actually say — 'research results', 'compile findings', 'report.md', '.json results'.

Mention the HTML output option in the description so the capability list is more comprehensive.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Convert per-item JSON results ... into a single markdown report', 'table of contents', 'per-item sections', 'Uses a bundled converter script' — but omits the HTML output and fields.yaml inputs, leaving minor coverage gaps consistent with anchor 4 rather than the comprehensive anchor 5.

4 / 5

Completeness

The 'what' is clear (convert JSON results into a markdown report with TOC and per-item sections), but there is no explicit 'Use when...' clause — the 'when' is only weakly implied via the /ultra-research:research-deep reference, so per the boundary guidance completeness is capped at 3.

3 / 5

Trigger Term Quality

Relevant terms like 'JSON results', 'markdown report', 'table of contents' appear, but coverage is pipeline-bound and misses common synonyms or file extensions a user might naturally say, fitting anchor 3 more than the fuller anchor 4.

3 / 5

Distinctiveness Conflict Risk

It is tightly scoped to the ultra-research pipeline and a specific slash command, giving a clear niche with minimal overlap risk; it sits above anchor 3 but the trigger is a command name rather than broadly natural language, so anchor 5 is not fully reached.

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
seanGSISG/claude-depot
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.