reddit-api

Reddit API with PRAW (Python) and Snoowrap (Node.js)

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Advisory

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/reddit-api/SKILL.md

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable multi-language code and useful tables, but it is monolithic and somewhat redundant across parallel implementations, and lacks validation checkpoints for destructive operations, holding conciseness, workflow clarity, and progressive disclosure at 2.

Suggestions

Move the OAuth2 web flow, Pydantic models, and full endpoint reference into separate reference files (e.g., OAUTH.md, MODELS.md) and link them from SKILL.md to improve progressive disclosure and conciseness.

Add explicit validation/verification steps around posting, voting, and batch operations (e.g., confirm the submission was created, re-fetch to verify state) to lift workflow clarity.

Reduce redundancy by consolidating the Quick Reference or pruning one of the parallel raw-HTTP implementations unless the direct-API path is genuinely needed.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean executable code without concept-explaining fluff, but it repeats the same operations across four parallel implementations (PRAW, Snoowrap, raw httpx, raw fetch) and a "Quick Reference" that re-states installation commands, so it could be tightened (anchor 2) rather than fully token-efficient (anchor 3).	2 / 3
Actionability	Code is fully executable and copy-paste ready across Python and TypeScript, backed by concrete endpoint and scope tables and explicit environment-variable examples, matching the anchor 3 "fully executable, specific examples" benchmark.	3 / 3
Workflow Clarity	Setup is sequenced (create app, env vars, install, use) but destructive/batch operations like posting and voting have no validation checkpoints beyond a single auth print check; the guidelines cap workflow clarity at 2 when validation is missing for such operations.	2 / 3
Progressive Disclosure	The skill is a monolithic ~580-line file with no references/scripts/assets bundle files and no external file pointers; sections are well-organized but content that could be split (API reference, OAuth web flow, Pydantic models) is all inline, matching anchor 2 and failing the under-50-line simple-skill exception.	2 / 3
	Total	9 / 12 Passed

Description

57%

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 distinct but incomplete: it names the domain and libraries without listing concrete actions and lacks an explicit "Use when..." trigger clause, which caps several dimensions at 2.

Suggestions

Add an explicit "Use when..." clause (e.g., "Use when building Reddit bots, scraping posts/comments, or integrating Reddit data") to lift completeness and trigger quality.

Enumerate concrete actions (fetch posts/comments, search, submit, vote, stream) so specificity reaches the action-rich anchor 3.

Include common user phrasings like "Reddit bot" and "scrape Reddit" to broaden natural trigger-term coverage.

Dimension	Reasoning	Score
Specificity	Names the domain ("Reddit API") and concrete tooling ("PRAW (Python) and Snoowrap (Node.js)") but lists no concrete actions like fetching posts or comments, so it is not comprehensive (anchor 2) rather than vague (anchor 1) or action-rich (anchor 3).	2 / 3
Completeness	It answers what the skill does but the description field contains no "Use when..." or equivalent trigger guidance; per the guidelines a missing explicit trigger caps completeness at 2.	2 / 3
Trigger Term Quality	"Reddit API" and the library names are natural terms, but common variations users would say ("Reddit bot", "scrape Reddit", "fetch Reddit posts", "Reddit integration") are missing, matching anchor 2.	2 / 3
Distinctiveness Conflict Risk	"Reddit API with PRAW (Python) and Snoowrap (Node.js)" carves a clear, library-specific niche that is unlikely to trigger for the wrong skill, matching anchor 3.	3 / 3
	Total	9 / 12 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (592 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: alinaqi/claude-bootstrap
Path: skills/reddit-api/SKILL.md
Commit: bb6195f

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