CtrlK
BlogDocsLog inGet started
Tessl Logo

results-report

This skill should be used when the user asks to "write an experiment report", "summarize experimental results", "do experiment retrospection", "write a results report", "写实验总结报告", "写实验复盘", or mentions turning completed experiment artifacts into a structured, decision-oriented research report. It assumes strict analysis should come from `results-analysis` first.

68

Quality

82%

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

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.

A well-structured, decision-oriented instruction skill: concrete naming/frontmatter contracts, a gated 6-step workflow, and clean one-level-deep references. The main defects are a missing referenced example file, triplicated missing-bundle instructions, and the absence of post-write verification.

Suggestions

Create `examples/example-results-report.md` or remove it from the 'Reference files' list — it is currently a broken reference in an otherwise clean bundle.

Consolidate the three statements of the missing-bundle rule (role boundary, 'Hard gate', workflow step 2) into one authoritative gate section.

Add a final verification step to the workflow (e.g., confirm the written filename matches the `YYYY-MM-DD--{experiment-line}--r{round}--{purpose}.md` contract and that linked `Experiments/`/`Results/` notes resolve).

DimensionReasoningScore

Conciseness

The body is lean, directive, and assumes Claude's competence (no concept explanations), matching 'Efficient; minor instances of over-explanation that could be trimmed' — the missing-bundle rule is stated three times (role boundary, 'Hard gate', and workflow step 2) and could be consolidated. It is not a 5 because of that redundancy, and not a 3 since there is no genuine padding or teaching of known concepts.

4 / 5

Actionability

It provides concrete, executable artifacts: a verbatim filename contract with two real examples, a complete copy-paste YAML frontmatter block, a fixed 10-section structure, and explicit write-target branches. It falls short of 5 because some steps remain directive rather than verifiable (e.g., 'Each section must answer a real question', 'cite actual evidence' give no acceptance criteria).

4 / 5

Workflow Clarity

The 6-step workflow is clearly sequenced with a strong validation checkpoint (the 'Hard gate' on missing analysis bundle, with route-back to `results-analysis`) and edge-case handling ('Use `r00` only as a temporary placeholder'), matching 'Clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because there is no post-write verification step (e.g., confirming the filename matches the contract or that linked notes resolve).

4 / 5

Progressive Disclosure

References are well-signaled at point of use ('Read `references/report-naming.md` before finalizing the filename'), listed at the bottom, and one level deep — six of seven referenced files verified on disk. It is not a 5 because `examples/example-results-report.md` is referenced in the 'Reference files' list but does not exist (no `examples/` directory in the bundle), a broken navigation path.

4 / 5

Total

16

/

20

Passed

Description

90%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 with explicit, quotable trigger phrases (bilingual) and clear what/when coverage. Its only real weakness is thin capability enumeration — the description captures the deliverable but not the report's concrete components.

Suggestions

Add 2-3 concrete capability phrases to the 'what' clause (e.g., 'interprets figures, documents limitations and failure cases, and writes back to Obsidian Results/Reports/') so specificity can reach 4-5.

Keep the current trigger list; it already covers natural English and Chinese phrasings well.

DimensionReasoningScore

Specificity

The description names the domain clearly ('turning completed experiment artifacts into a structured, decision-oriented research report') but describes essentially one composite action; it never mentions the skill's other concrete capabilities (figure interpretation, limitations analysis, Obsidian write-back), so it matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' rather than the level-4 'lists several specific actions'.

3 / 5

Completeness

It explicitly answers both: what ('turning completed experiment artifacts into a structured, decision-oriented research report') and when ('This skill should be used when the user asks to...') with concrete quoted trigger phrases, matching the level-5 anchor exactly. It is not a 4 because the 'when' guidance is already maximally explicit with verbatim trigger phrases.

5 / 5

Trigger Term Quality

It quotes multiple natural phrases users would say — "write an experiment report", "summarize experimental results", "do experiment retrospection", "write a results report" — plus Chinese synonyms ("写实验总结报告", "写实验复盘") and a descriptive clause for the 'mentions' case, giving comprehensive synonym coverage.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (post-experiment reporting) and explicitly differentiates from the sibling skill — 'It assumes strict analysis should come from `results-analysis` first' — so trigger overlap risk is minimal. Voice is third-person ('This skill should be used'), so no specificity penalty applies.

5 / 5

Total

18

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
Galaxy-Dawn/claude-scholar
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.