CtrlK
BlogDocsLog inGet started
Tessl Logo

report-generate

Professional financial research report generation — standard structure (summary / views / main body / risks / recommendation), Markdown formatting standards, rating system, and terminology guide.

59

Quality

74%

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 ./agent/src/skills/report-generate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

This is a strong instruction-only skill: highly actionable templates, explicit quantitative rating criteria, and a preparation-to-output workflow with validation on the PDF delivery path. Its main weaknesses are mild padding (the abbreviations table) and a monolithic single-file layout where the templates and terminology guide could be split into one-level-deep references.

DimensionReasoningScore

Conciseness

The body is dominated by high-value tables and templates (rating thresholds, number formats, terminology mappings) with almost no concept explanation Claude already knows. The main trimmable excess is the 8-row abbreviations table (YoY/ROE/EPS definitions are basic knowledge) and a slightly long chart-substitute example — minor over-explanation consistent with anchor 4 rather than the more padded anchor 3.

4 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: a copy-paste-ready report template, a complete backtest template with grounding rules ("read the engine-written metrics.csv and equity.csv"), explicit rating thresholds ("Sharpe > 1.5, max drawdown < 20%"), exact number formats with examples, a term-substitution table, and a concrete output checklist (rating, ≥3 risk warnings, disclaimer). Per the scoring notes, absence of code is not penalized when instruction guidance is this concrete.

5 / 5

Workflow Clarity

"Preparation Before Writing" gives a clear 4-step sequence (clarify type → collect data → determine view → choose rating), the "Output Format" section serves as a final delivery checklist, and the PDF section includes a genuine validation checkpoint ("Check its returned status, path, and bytes_written... If rendering fails, report that tool error instead of claiming the PDF was created"). It falls short of anchor 5 because the writing workflow itself lacks a verify step (e.g., an explicit data-consistency check before delivery — Note 2 states the rule but no checkpoint enforces it).

4 / 5

Progressive Disclosure

The file is well-sectioned with clear headers, but at ~280 lines everything is inlined in SKILL.md with no bundle files at all — the ~90 lines of templates, terminology guide, and abbreviation tables are detail content that could live in one-level-deep reference files, matching anchor 3 ("content that should be separate is inline"). It is above anchor 2 because structure and navigation within the file are good, and below anchor 4 because there are no references to signal — the simple-skill exception (under 50 lines) does not apply at this length.

3 / 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 communicates a clear and fairly specific capability set for financial research report generation, but it omits any explicit trigger guidance. Adding a "Use when..." clause with natural user phrases (e.g., stock reports, equity research, backtest write-ups) would substantially improve both completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g., "Use when the user asks for a stock/industry/strategy research report, an equity rating or target price, or a write-up after a backtest."

Add natural synonyms users would actually say — "equity research", "stock analysis", "investment report", "analyst report" — alongside the current terminology.

Mention the report types covered (deep-dive, industry, strategy, backtest, flash note) so the description matches the body's scope and improves trigger matching.

DimensionReasoningScore

Specificity

The description lists several concrete components — "standard structure (summary / views / main body / risks / recommendation)", "Markdown formatting standards", "rating system, and terminology guide" — going beyond naming the domain. It stops short of anchor 5 because it enumerates content areas rather than a comprehensive set of concrete actions, and PDF delivery and backtest-report generation (covered in the body) are absent.

4 / 5

Completeness

The "what" is clearly stated (generates structured professional financial research reports with a defined structure, formatting standards, ratings, and terminology), but there is no "Use when..." clause or equivalent explicit trigger guidance — no indication of when Claude should invoke it (e.g., "Use when the user asks for a stock/industry/backtest report"). Per the judging guideline, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords like "financial research report", "rating", and "Markdown formatting" are present, but common natural variations users would say — "equity research", "stock analysis", "investment report", "analyst report" — are missing. It fits anchor 3 (some relevant keywords, missing common variations/synonyms) rather than 4, whose example shows fuller keyword coverage including synonyms and file extensions.

3 / 5

Distinctiveness Conflict Risk

The financial-research framing (rating system, target prices, risk warnings, analyst conventions) carves out a fairly distinct niche with minor overlap risk against generic writing/formatting skills. It is not a 5 because terms like "report generation" and "Markdown formatting standards" alone could weakly overlap with general document skills; it is clearly above 3 because the securities-research specifics are unmistakable.

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.

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
HKUDS/Vibe-Trading
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.