CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reddit-reading

Read Reddit: subreddits, search, threads, users. No browser.

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 skill body: fully executable commands verified against the bundled script, a numbered operational procedure with pre-flight validation and error-recovery paths, and pitfall guidance restricted to non-obvious, environment-specific facts. The only weakness is mild redundancy — the Prerequisites table and repeated rate-limit commentary could be trimmed without losing information.

DimensionReasoningScore

Conciseness

The body is dense with Reddit- and environment-specific facts Claude cannot know (403s from datacentre IPs, feed throttling, client_credentials grant) and avoids generic concept explanations. Minor trimming is possible: the Prerequisites comparison table restates the adjacent prose (rate limit, thread data, "Acts as a user | no"), and rate-limit guidance recurs across Prerequisites, Procedure ②, and Pitfalls, so it sits at anchor 4 rather than a fully lean 5.

4 / 5

Actionability

Every operation ships as a copy-paste-ready command with real arguments ("python3 scripts/reddit.py sub LocalLLaMA --sort hot --limit 15", "search ... --sub NAME", "thread URL --limit 40", "user spez", "--json"), the Quick Reference table maps each need to its command and flags, and the Verification section gives exact commands with expected outputs ("anonymous_feed: ok", "active_backend: oauth"). All commands match the bundled script's argparse. This matches anchor 5.

5 / 5

Workflow Clarity

The Procedure is a clearly numbered sequence (① doctor → ② plan calls against the rate budget → ③ read thread bodies → ④ cite permalinks → ⑤ escalate to app credentials for sustained use) with an explicit pre-flight validation checkpoint (①) and error-recovery guidance (429 → script waits and retries once; more than one 429 means credentials are needed). The separate Verification section supplies concrete expected outputs, satisfying anchor 5's explicit-validation and feedback-loop bar; the skill is read-only, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The bundle is a single script (scripts/reddit.py), which the body references by the correct relative path and whose commands/flags match the actual argparse implementation. At ~115 lines the SKILL.md is an appropriately sized overview (when to use, prerequisites, commands, procedure, pitfalls, verification) with implementation detail correctly pushed into the script, and all sections are well-signaled and flat — matching the simple-skill exception for well-organized content with no nested references.

5 / 5

Total

19

/

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 concise, concrete, and tightly scoped to a distinct Reddit-reading niche with good natural trigger keywords. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which both caps completeness and leaves the headless/no-browser use case merely implied rather than stated as a trigger.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions Reddit, r/subreddits, or shares a reddit.com link, or when browser-based extraction of Reddit fails" — this would lift completeness from 3 to 4-5.

Include natural synonyms users actually say — "posts", "comments", "r/...", "u/..." — to raise trigger-term coverage toward comprehensive.

Optionally name one more concrete action per area (e.g. "read full comment threads", "list posts by hot/new/top") to close the specificity gap toward anchor 5.

DimensionReasoningScore

Specificity

"Read Reddit: subreddits, search, threads, users" lists several concrete capabilities (subreddit listings, site/subreddit search, threads, user activity) with only minor gaps. It exceeds the 1-2 actions of anchor 3 but falls short of anchor 5's comprehensiveness since comments, sorting, and limits are not mentioned and everything hangs off the single verb "Read".

4 / 5

Completeness

The "what" is clear (read subreddits, search, threads, users), but there is no explicit "Use when..." trigger clause; "No browser" is a constraint statement that only weakly implies when. Per the guideline, a missing explicit trigger clause caps completeness at 3, and anchor 4 requires a present-if-rough 'when' that this lacks.

3 / 5

Trigger Term Quality

Natural keywords users would say are present: "Reddit", "subreddits", "search", "threads", "users". Common variations like "posts", "comments", "r/", "u/", or "browse" are missing, keeping it below anchor 5's synonym-and-extension coverage.

4 / 5

Distinctiveness Conflict Risk

"Read Reddit: subreddits, search, threads, users. No browser." occupies a clear niche with distinct triggers (Reddit, subreddits, threads, users) and explicitly disclaims browser-based reading, so it is unlikely to fire for the wrong skill. It matches anchor 5's clear-niche example.

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

NousResearch/hermes-agent

Path

optional-skills/social-media/reddit-reading/SKILL.md

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.