harmonic

Harmonic Patterns signal engine. Identifies XABCD five-point structures such as Gartley/Bat/Butterfly/Crab based on Fibonacci geometry, and generates trading signals in the PRZ (Potential Reversal Zone).

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./agent/src/skills/harmonic/SKILL.md

Quality

Content

47%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 concise, well-sectioned reference for harmonic pattern ratios and signal conventions, but it reads as a specification rather than a usable skill file: it never tells the reader how to run the signal engine, and it fails to link the two existing reference files, instead duplicating their content. Fixing navigation and adding a minimal usage example would address the two weakest dimensions.

Suggestions

Add a minimal executable example showing how to invoke the signal engine (CLI or Python call) so actionability reaches copy-paste readiness, including how the bundled-detector fallback is selected.

Link the existing reference files explicitly, e.g. "**Pattern ratios**: See [XABCD形态.md](references/XABCD形态.md)" and "**PRZ trading rules**: See [PRZ交易.md](references/PRZ交易.md)", and move the duplicated ratio table out of SKILL.md.

Add a short numbered workflow (install extra → set is_stock → run engine → interpret 1/-1/0 signal) so the operating sequence is explicit.

Dimension	Reasoning	Score
Conciseness	The body is lean — ratio tables, a one-line install command, and terse signal conventions with no padding — but the "Core Concepts" bullets restate PRZ/XABCD definitions that duplicate the bundled references, so it is efficient with minor trims possible rather than anchor 5's every-token-earns-its-place.	4 / 5
Actionability	There is one executable command ("pip install \"vibe-trading-ai[harmonic]\"") plus a concrete parameter and signal-convention table, but no runnable example showing how to actually invoke the signal engine or where the "bundled detector" fallback lives, leaving the guidance concrete-but-incomplete per anchor 3.	3 / 5
Workflow Clarity	No sequence is presented at all — nothing walks through install → configure (is_stock) → run the engine → interpret the 1/-1/0 signal, and the skill is not a single unambiguous action, matching anchor 2's rough-fragments-with-many-gaps rather than anchor 3's listed steps.	2 / 5
Progressive Disclosure	Bundle files references/XABCD形态.md and references/PRZ交易.md exist but are never mentioned or linked from the body, and the body's ratio table duplicates the XABCD reference's content inline — references are effectively buried/undiscoverable, which matches anchor 2 rather than anchor 3's "present but not clearly signaled".	2 / 5
	Total	11 / 20 Passed

Description

70%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 distinctive, naming concrete capabilities (XABCD identification, PRZ signal generation) with strong domain keywords that map naturally to user requests. Its main weakness is the complete absence of any "when to use" trigger guidance, which caps completeness. Adding a short "Use when..." clause would lift it to the top band.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about harmonic patterns, Gartley/Bat/Butterfly/Crab setups, Fibonacci reversal zones, or PRZ trading signals."

Include common synonyms such as "technical analysis" or "reversal patterns" to broaden natural trigger coverage.

Dimension	Reasoning	Score
Specificity	"Identifies XABCD five-point structures such as Gartley/Bat/Butterfly/Crab" and "generates trading signals in the PRZ" name concrete actions with specific pattern names, giving broader coverage than the 1-2-action anchor but stopping short of the comprehensive multi-action list of anchor 5.	4 / 5
Completeness	The "what" is clearly stated (identify XABCD structures, generate PRZ signals), but there is no "Use when..." clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3 rather than 4.	3 / 5
Trigger Term Quality	Terms like "Harmonic", "Gartley/Bat/Butterfly/Crab", "Fibonacci", "PRZ", and "trading signals" are exactly what a user requesting harmonic analysis would say, but common synonyms such as "technical analysis", "reversal patterns", or "price patterns" are absent, so it falls short of anchor 5's comprehensive synonym coverage.	4 / 5
Distinctiveness Conflict Risk	The harmonic/Fibonacci-geometry trading niche with named patterns (Gartley, Bat, Butterfly, Crab) is highly distinct from generic analysis skills, so trigger overlap risk is minimal — a clean match for anchor 5, not merely the "minor overlap" of anchor 4.	5 / 5
	Total	16 / 20 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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: HKUDS/Vibe-Trading
Path: agent/src/skills/harmonic/SKILL.md
Commit: 251b094

Reviewed: 3 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.