Name: diffbot
Rating: 59.2 (1 reviews)
Author: membranedev

diffbot

Diffbot integration. Manage Articles, Products, Images, Discussions, Videos. Use when the user wants to interact with Diffbot data.

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/diffbot/SKILL.md

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 highly actionable with executable commands throughout and a well-sequenced connection workflow, but it leans verbose and inlines reference material (a long actions table, connection-state details) that would be better split into separate files.

Suggestions

Move the large Popular actions table and the detailed connection-state reference into separate reference files (e.g. ACTIONS.md, CONNECTIONS.md) and link to them from a concise overview, improving progressive disclosure.

Remove the introductory paragraph explaining what Diffbot is and who uses it — Claude already knows this — to tighten conciseness.

Add an explicit validation/checkpoint step after running actions or proxy requests (e.g. check the `output`/error fields before proceeding) to push workflow clarity higher.

Dimension	Reasoning	Score
Conciseness	It is mostly efficient with executable command blocks, but the opening paragraph explains what Diffbot is and who uses it — concepts Claude already knows — and the long Popular actions table plus inline connection-state reference add padding that could be trimmed.	3 / 5
Actionability	Every section provides copy-paste-ready, executable CLI commands with flags and JSON examples, and the Popular actions table gives concrete action keys covering the common cases.	5 / 5
Workflow Clarity	The connection flow is clearly sequenced with state-based branching (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and polling guidance, but validation/verification checkpoints after running actions or proxy requests are only implicit rather than explicit.	4 / 5
Progressive Disclosure	It has clear section structure but no bundle files exist, so all content — including the lengthy Popular actions table and the inline connection-state reference — is inlined in SKILL.md rather than split into one-level-deep referenced files.	3 / 5
	Total	15 / 20 Passed

Description

67%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 identifies the integration and includes an explicit 'Use when' trigger, but the trigger terms are limited to the brand name rather than natural user phrases. It is mostly distinct and reasonably specific.

Suggestions

Broaden trigger terms beyond the brand name to natural phrases users would say, e.g. 'web data extraction', 'extract products/articles from web pages', or 'search the Diffbot Knowledge Graph'.

Tighten the 'when' clause with more concrete scenarios (e.g. 'Use when extracting structured data from web pages or searching the Diffbot Knowledge Graph').

Dimension	Reasoning	Score
Specificity	Names the domain (Diffbot) and lists several concrete data types to manage ('Articles, Products, Images, Discussions, Videos'), giving multiple specific capabilities with only minor gaps in coverage.	4 / 5
Completeness	It has a clear 'what' ('Manage Articles, Products, Images, Discussions, Videos') and an explicit 'when' clause ('Use when the user wants to interact with Diffbot data'), though the 'when' is fairly generic and could be more specific.	4 / 5
Trigger Term Quality	It relies on the proper noun 'Diffbot' and 'Diffbot data' as the primary trigger; it lacks the common natural synonyms or surface variations (e.g. 'web scraping', 'extract from web pages', 'Knowledge Graph') a user might actually say.	3 / 5
Distinctiveness Conflict Risk	Scoping to 'Diffbot' and 'Diffbot data' gives it a clear niche with minimal overlap risk against other skills, though the surrounding capabilities are broad enough to risk minor overlap with general web/scraping skills.	4 / 5
	Total	15 / 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: membranedev/application-skills
Path: skills/diffbot/SKILL.md
Commit: f484c82

Reviewed: ~17 hours 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.