CtrlK
BlogDocsLog inGet started
Tessl Logo

clay-known-pitfalls

Identify and avoid the top Clay anti-patterns, gotchas, and integration mistakes. Use when reviewing Clay integrations for issues, onboarding new team members, or auditing existing Clay table configurations. Trigger with phrases like "clay mistakes", "clay anti-patterns", "clay pitfalls", "clay what not to do", "clay gotchas", "clay code review".

80

Quality

77%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/saas-packs/clay-pack/skills/clay-known-pitfalls/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-structured skill description that clearly communicates its purpose and includes explicit trigger guidance. Its main weakness is that the 'what' portion could be more specific about the concrete anti-patterns or actions it covers, staying somewhat at the category level rather than listing specific capabilities. The trigger terms and use-when clauses are strong.

Suggestions

Add 2-3 specific examples of the anti-patterns or mistakes covered (e.g., 'incorrect webhook configurations, duplicate enrichment calls, missing rate limiting') to improve specificity.

DimensionReasoningScore

Specificity

The description names the domain (Clay anti-patterns/mistakes) and some actions (identify, avoid, review, audit), but doesn't list specific concrete anti-patterns or detailed actions like 'detect missing webhook configurations' or 'flag incorrect enrichment column mappings'. The actions remain somewhat high-level.

2 / 3

Completeness

The description clearly answers both 'what' (identify and avoid top Clay anti-patterns, gotchas, and integration mistakes) and 'when' (reviewing Clay integrations for issues, onboarding new team members, auditing existing Clay table configurations), with explicit trigger phrases provided.

3 / 3

Trigger Term Quality

The description explicitly lists natural trigger phrases users would say: 'clay mistakes', 'clay anti-patterns', 'clay pitfalls', 'clay what not to do', 'clay gotchas', 'clay code review'. These cover good variations of how users would naturally phrase requests.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to Clay platform anti-patterns and integration mistakes, creating a clear niche. The trigger terms are all Clay-specific and unlikely to conflict with other skills unless there are multiple Clay-related skills.

3 / 3

Total

11

/

12

Passed

Implementation

64%

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

This is a solid reference skill with highly actionable content — each pitfall has specific symptoms, causes, and concrete fixes including code, settings paths, and formulas. The main weaknesses are its monolithic length (10 detailed pitfalls inline without progressive disclosure to sub-files) and the lack of verification steps after applying fixes for costly operations. The quick reference checklist at the end is a strong addition for scanning.

Suggestions

Add brief verification steps to critical pitfalls (e.g., 'After rotating webhook, send a test payload to confirm the new endpoint is receiving data' for Pitfall 1, or 'Verify auto-update is off by checking the table settings icon shows no refresh indicator' for Pitfall 4).

Reference or link the 'clay-load-scale' WebhookRotator pattern mentioned in Pitfall 1 — currently it's an unresolvable reference that could confuse Claude.

Consider trimming the prerequisites section entirely (Claude doesn't need to be told to have an active Clay account) and removing obvious comments in code examples to improve conciseness.

DimensionReasoningScore

Conciseness

Generally efficient with clear symptom/cause/fix structure, but some sections include unnecessary explanation (e.g., prerequisites listing basic knowledge Claude already has, some verbose descriptions). The code examples in Pitfall 5 are somewhat padded with comments that don't add much. The overall length is reasonable for 10 pitfalls but could be tightened.

2 / 3

Actionability

Each pitfall provides concrete, specific fixes with exact settings to toggle, code snippets, specific thresholds (45K, 30 seconds), formula examples (ISEMPTY, ICP Score >= 60), and navigation paths (Settings > Connections). The good vs bad Claygent prompt example is particularly actionable.

3 / 3

Workflow Clarity

Each pitfall follows a clear symptom → root cause → fix pattern which is well-structured. However, for pitfalls involving potentially destructive or costly operations (like webhook rotation, auto-update changes), there are no explicit validation/verification steps or feedback loops to confirm the fix was applied correctly.

2 / 3

Progressive Disclosure

The content is well-organized with a summary checklist table and references at the end. However, with 10 detailed pitfalls inline, the file is quite long and monolithic. Some pitfalls could be grouped or split into referenced files. The reference to 'clay-advanced-troubleshooting' and 'clay-load-scale' WebhookRotator pattern are good but the latter isn't linked or explained.

2 / 3

Total

9

/

12

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-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.