CtrlK
BlogDocsLog inGet started
Tessl Logo

polymarket

Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.

59

Quality

70%

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 ./configs/microservice/bff-service/configs/agent-skills/clawhub/polymarket-trade/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable, verified command catalog — every documented subcommand exists in the bundled script — with a sensible setup sequence for cron-based use. Its weaknesses are redundancy (the Suggested Setup section repeats the Commands section) and junk content (a promotional telegra.ph link and mojibake from bad encoding), which waste context tokens and hurt organization.

Suggestions

Delete the promotional "# Step-by-Step Guide" heading and telegra.ph URL at the top of the body.

Merge the "After Install — Suggested Setup" section into "Commands" (or reduce it to the cron snippets) to remove the duplicated watch/alerts/digest/buy examples.

Fix the UTF-8 mojibake ("â€"", "±") and replace the elided "~/..." path in cron examples with the actual {baseDir} path used elsewhere.

DimensionReasoningScore

Conciseness

The body is mostly an efficient command catalog, but includes unnecessary padding: the promotional "Step-by-Step Guide" heading with a telegra.ph URL, an "After Install — Suggested Setup" section that duplicates ~40 lines of commands already shown in "Commands", and encoding artifacts ("â€"", "±"). This matches the anchor for mostly efficient content that could be tightened; it is not a 2 because there is no explanation of concepts Claude already knows and the commands themselves are lean.

3 / 5

Actionability

Every command is copy-paste ready with concrete arguments (e.g. `python3 {baseDir}/scripts/polymarket.py watch add bitcoin-100k --alert-change 10`), the referenced script exists in the bundle and implements all documented subcommands, and examples cover the common cases across every feature. This matches the fully-executable anchor with specific examples covering common cases.

5 / 5

Workflow Clarity

This is a single-command CLI skill where the "Suggested Setup" section gives a clear numbered adoption sequence (morning briefing → watchlist → hourly cron → weekly digests → paper trading) with runnable cron lines. It matches the clear-sequence anchor with minor gaps; it is not a 5 because the cron examples use an elided "~/..." path instead of a concrete one, and not a 3 because the operations are read-only/local so heavy validation checkpoints are not required.

4 / 5

Progressive Disclosure

Sections are clearly headed and the only bundle dependency (scripts/polymarket.py) is a real, correctly-referenced one-level-deep file, but the ~235-line body inlines a full command reference while duplicating it across two sections ("Suggested Setup" vs "Commands"), and the stray promotional heading disrupts navigation. This sits between the "could be better organized" and "good structure" anchors, so per boundary guidance it takes the even score reflecting noticeable reorganization need rather than only minor gaps.

3 / 5

Total

15

/

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.

A concise, third-person description with concrete actions and a clearly distinct niche, but it is incomplete: it lacks any explicit "when to use" trigger guidance and undersells the skill's actual feature set (watchlists, alerts, calendar, digests, paper trading). Adding a trigger clause and one more clause of capability coverage would lift it substantially.

Suggestions

Append a 'Use when...' clause, e.g. "Use when the user mentions Polymarket, prediction markets, betting odds, or wants to check market probabilities or price movement."

Reflect the fuller feature set — watchlists with price alerts, resolution calendar, category digests, and paper-trading portfolio — so the description matches what the skill actually does.

Add natural synonyms such as "betting odds" or "forecast markets" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements" — which matches the anchor for several specific actions with minor gaps. It is not a 5 because the skill also supports watchlists, alerts, resolution calendars, and paper trading, none of which are covered.

4 / 5

Completeness

The "what" is clear (query markets, check odds, search, track prices), but there is no "Use when..." clause or equivalent trigger guidance — the "when" is only weakly implied by the topic itself. Per the judging guidelines, a missing explicit 'Use when' clause caps completeness at 3, and it is not a 4 because the when-context is entirely absent rather than just imprecise.

3 / 5

Trigger Term Quality

Natural phrases users would say are present: "Polymarket", "prediction markets", "odds", "trending markets", "price movements". Not a 5 because common synonyms like "betting", "bets", "forecast", or "crypto odds" are missing, and not a 3 since multiple relevant natural terms are covered beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

"Polymarket prediction markets" names a clear niche with distinct triggers; no other plausible skill would be invoked by a request about Polymarket odds or prediction markets. This matches the anchor for a clear niche with minimal conflict risk, and there is nothing vague that would create overlap with other skills.

5 / 5

Total

16

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
UnicomAI/wanwu
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.