research-note

Generate a professional Word document research note

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/daloopa/skills/research-note/SKILL.md

Quality

Content

77%

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 well-sequenced, highly actionable orchestrator workflow with strong checkpoints, but it is verbose with repeated boilerplate and monolithic rather than split across reference files. Consolidating the repeated resolution logic and moving the render/template spec into a reference file would improve token efficiency and navigation.

Suggestions

Factor the repeated '3-step resolution' block into a single defined procedure and reference it instead of restating it verbatim in Phases A, G, and elsewhere.

Move the full HTML Report Template / Section render spec (Phase K) and the industry-specific templates into a reference file and link to it from the body.

De-duplicate the Context Key Checklist against the keys already declared in each phase to cut redundancy.

Dimension	Reasoning	Score
Conciseness	Mostly directive rather than explanatory, but ~320 lines with verbatim repetition (the '3-step resolution' block and a context-key checklist that duplicates already-defined keys).	2 / 3
Actionability	Concrete tool names, exact WebSearch query templates, an exact citation format, explicit table schemas, and falsifiable-belief formats make the guidance copy-paste ready despite being instruction-only.	3 / 3
Workflow Clarity	A clear Phase A-K sequence with gating prompts, a pre-render Context Key Checklist, and has_* flags provides explicit validation checkpoints.	3 / 3
Progressive Disclosure	External references are one-level-deep and clearly signaled, but no bundle exists and the entire ~320-line body (report template, industry templates, render spec) is inline and could be split.	2 / 3
	Total	10 / 12 Passed

Description

50%

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 states a clear action and domain but is one short sentence with no 'Use when' trigger guidance, so it only partially answers when Claude should invoke the skill. It is concrete but minimal and could conflict with generic document skills.

Suggestions

Add an explicit 'Use when...' trigger clause, e.g. 'Use when the user asks for a research note, equity research report, or company analysis document.'

List a few more concrete actions (e.g., 'gather financials, run DCF/comps, cite Daloopa sources') to lift specificity.

Reconcile 'Word document' with the body, which actually renders an HTML report — pick one to avoid mismatch and false triggers.

Dimension	Reasoning	Score
Specificity	Names a concrete domain ('Word document research note') and one action ('Generate'), but does not enumerate multiple specific actions.	2 / 3
Completeness	States what the skill does but provides no explicit 'when' trigger guidance, capping completeness at 2 per the rubric.	2 / 3
Trigger Term Quality	Includes natural terms a user might say ('research note', 'Word document') but lacks a 'Use when...' clause and common variations.	2 / 3
Distinctiveness Conflict Risk	'research note' gives some niche distinctiveness, but 'Word document' is generic and could overlap with general document skills.	2 / 3
	Total	8 / 12 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
relative_links	Relative link issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: openai/plugins
Path: plugins/daloopa/skills/research-note/SKILL.md
Commit: 11c74d6

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.