CtrlK
BlogDocsLog inGet started
Tessl Logo

event-driven

Event-driven strategy based on sentiment-scored signals from news, announcements, and macro events. The LLM acts as the NLP engine, and event data follows a CSV schema.

58

Quality

73%

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 ./agent/src/skills/event-driven/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 body is a strong, self-contained reference: executable code with docstrings, a concrete CSV schema with examples, a fixed LLM scoring prompt, and a thoughtful pitfalls section covering look-ahead bias, dedup, and decay sensitivity. Remaining gaps are minor: a referenced signal_engine.py script that is not actually bundled, no explicit CSV-parse validation step in the workflow, and some parameter descriptions repeated across sections.

Suggestions

Either provide signal_engine.py as a bundled script or reword the workflow step to 'implement/save the aggregation functions below as signal_engine.py' so the reference matches what exists.

Add an explicit validation checkpoint after writing the event CSV (e.g. reload with pd.read_csv(quoting=csv.QUOTE_ALL) and confirm schema/dates) before proceeding to aggregation.

DimensionReasoningScore

Conciseness

The body is efficient — dense tables, lean code, no padding with concepts Claude already knows — but decay_lambda and alpha semantics are each restated across the docstring, inline comments, and the Parameters table, and 'No additional dependencies. LLM analysis is handled by the Agent itself...' could be trimmed, matching the efficient-with-minor-trimming anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Both functions (compute_event_signal, combine_signals) are fully executable with typed signatures and docstrings, and the CSV schema, LLM prompt template, and pip install command are copy-paste ready; the one minor gap is that the workflow step references 'signal_engine.py' as a provided script while no such bundle file exists — the logic lives only inline — matching the mostly-executable-with-minor-gaps anchor.

4 / 5

Workflow Clarity

The four-step workflow (fetch -> LLM scoring -> event CSV -> aggregation) is clearly sequenced, and validation is largely embedded: the code enforces event_date <= trade_date with an explicit anti-look-ahead comment and pitfalls cover dedup, CSV quoting, and threshold handling. A minor gap is the absence of an explicit 'validate the CSV parses' checkpoint in the sequence itself, so it fits the clear-sequence-with-most-checkpoints anchor rather than the explicit-validation-with-feedback-loops anchor.

4 / 5

Progressive Disclosure

This is a single self-contained SKILL.md with no bundle files and well-organized, clearly headed sections in a logical order (purpose -> workflow -> schema -> event types -> aggregation -> parameters -> prompt -> pitfalls), making navigation easy; at ~175 lines with the prompt template and event-type detail inlined it stops short of the ideal split, matching the good-structure-with-minor-organization-gaps anchor.

4 / 5

Total

16

/

20

Passed

Description

61%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 clearly states what the skill does with a concrete, domain-specific framing in proper third-person voice, but it entirely lacks a 'when to use it' clause and its action coverage is incomplete. Trigger terms are good though missing common synonyms.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user mentions news, earnings, macro events, policy changes, or wants sentiment/event-driven trading signals.'

Mention the signal-aggregation capability (combining event signals with technical signals via weighted decay) so the 'what' covers the full workflow.

Add natural synonyms such as 'headlines', 'earnings reports', and 'market events' to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('event-driven strategy based on sentiment-scored signals from news, announcements, and macro events') and one or two concrete actions (LLM sentiment scoring, 'event data follows a CSV schema'), but omits core capabilities like signal aggregation and combination with technical signals, matching the anchor for domain plus 1-2 concrete actions rather than the several-specific-actions anchor above.

3 / 5

Completeness

The 'what' is clear (event-driven strategy via sentiment-scored signals with the LLM as NLP engine and a CSV data schema), but there is no 'Use when...' clause or any equivalent trigger guidance, which per the rubric caps completeness at 3.

3 / 5

Trigger Term Quality

It includes natural terms users would say — 'news', 'announcements', 'macro events', 'sentiment', 'event-driven' — giving good keyword coverage, though common synonyms like 'headlines', 'earnings', or 'press releases' are missing, fitting the good-coverage-with-a-few-gaps anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The news/sentiment event-signal niche is mostly distinct with terms unlikely to trigger unrelated skills, but without explicit trigger phrases it retains minor overlap risk with sibling technical or sentiment strategy skills, matching the 'mostly distinct' anchor rather than the clear-niche anchor.

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.