CtrlK
BlogDocsLog inGet started
Tessl Logo

email-finder-hunter

Email finder and verifier - find emails, verify deliverability, discover companies

60

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/lead-generation/capabilities/email-finder-hunter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is a well-organized, highly actionable API reference: complete executable curl examples for all eight endpoints, clean setup with an auth fallback, and bulk details delegated to a discovery API. The main deductions are verbatim duplication between the Capabilities list and Usage intros, one malformed command in the Discover More section, and the absence of response-interpretation guidance (e.g. verifier statuses).

Suggestions

Fix the '## Discover More' code block: move 'List all endpoints' out of the command (e.g. into a comment on its own line or a lead-in sentence) so both curl commands are copy-paste executable.

Deduplicate the capability descriptions — the '## Capabilities' bullets and the intro line of each '## Usage' subsection repeat the same sentences; keep one.

Add one or two lines on interpreting Email Verifier results (e.g. treat 'accept_all'/'unknown' as unverified before outreach) to close the workflow validation gap.

DimensionReasoningScore

Conciseness

The body is dominated by lean, copy-paste curl commands with no hand-holding, assuming Claude's competence (e.g. the setup block is three lines plus a fallback instruction). Not 5 because content is duplicated: each capability is described verbatim both in the '## Capabilities' list and again as the intro sentence of its '## Usage' subsection, and line 23 repeats the description; not 3 because the padding is minor trimming, not unnecessary explanation.

4 / 5

Actionability

Every endpoint gets a complete, executable curl command with auth headers, content type, and a concrete example payload — copy-paste ready for the seven core endpoints. Not 5 because the '## Discover More' block is malformed as written: the first curl ends with trailing text "' List all endpoints" after the JSON argument (which would break execution if pasted) and an inline '#' comment placed after the payload line; this is exactly 'minor gaps' rather than 'vague guidance'.

4 / 5

Workflow Clarity

The setup sequence is explicit with a validation/fallback checkpoint ('If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login'), and each endpoint's usage is unambiguous with parameters marked as required. Not 5 because there are no checkpoints for interpreting responses — e.g. what to do with 'accept_all' or 'unknown' verifier statuses, or handling curl errors — leaving minor validation gaps; not 3 because the sequence that exists (setup → auth → call) is clear and includes an explicit error path.

4 / 5

Progressive Disclosure

The body is well-sectioned (Setup, Capabilities, Usage, Use Cases, Discover More) and pushes full endpoint details behind the search/details API calls rather than inlining complete reference documentation — a genuine progressive-disclosure mechanism. Not 5 because the ~180-line inline endpoint reference could itself be split into a references file (there are no bundle files at all), and the 'Discover More' references are only mildly signaled; not 3 because organization is clean and navigation is easy.

4 / 5

Total

16

/

20

Passed

Description

66%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 states concrete, natural-language capabilities but completely lacks a 'when to use' trigger clause, capping completeness at 3. Trigger terms are solid for the core email use cases though missing common synonyms. Distinctiveness is good with minor overlap risk from the broad 'discover companies' scope.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to find someone's email address, verify whether an email is deliverable, or research a company's contacts.'

Include common user phrasings and synonyms such as 'email lookup', 'check if an email is valid', 'bounces', or 'contact discovery' to broaden natural trigger coverage.

Either mention the enrichment and domain-search capabilities for fuller coverage, or commit to the core finder/verifier/discovery trio to tighten the scope.

DimensionReasoningScore

Specificity

"find emails, verify deliverability, discover companies" lists three specific concrete actions in a named domain (email intelligence), matching the 'several specific actions; minor gaps in coverage' anchor. Not 5 because enrichment, email counting, and domain search capabilities are omitted; not 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

The 'what' is clear (find, verify, discover) but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. Not 4 because 'when' is entirely absent rather than just weakly implied.

3 / 5

Trigger Term Quality

"Email finder and verifier", "find emails", "verify deliverability" are natural phrases users would say, giving good keyword coverage. Not 5 because common synonyms and variations like "email lookup", "check if an email is valid", "contact lookup", or "bounces" are missing; not 3 because coverage exceeds 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Email finding/verification is a clear niche with distinct triggers ('email finder', 'verifier'), though 'discover companies' is broad enough to overlap with general lead-generation or company-research skills — fitting 'mostly distinct; minor overlap risk'. Not 5 because of that company-discovery breadth; not 3 because the core email triggers are unmistakable.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
gooseworks-ai/goose-skills
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.