CtrlK
BlogDocsLog inGet started
Tessl Logo

clay-reference-architecture

Design production Clay enrichment pipelines with table schemas, waterfall patterns, and CRM sync. Use when architecting new Clay integrations, reviewing data flow design, or establishing enrichment pipeline standards. Trigger with phrases like "clay architecture", "clay best practices", "clay pipeline design", "clay reference", "clay data flow".

71

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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 concrete Clay formulas and configs and a clear step sequence, but it is somewhat verbose and, critically, fails to surface its two reference files via links and omits validation checkpoints for the batch/destructive CRM operations. Tightening prose and adding explicit validate-fix-retry steps would lift it.

Suggestions

Add a 'Validate before CRM push' checkpoint in Step 5 — e.g., verify dedup_key resolution and email presence, then retry on failure — to satisfy the validate->fix->retry loop expected for batch/destructive operations.

Link the two reference files from the body with clear signals (e.g., '## Advanced implementation — See [implementation-guide.md](references/implementation-guide.md)') so progressive disclosure is one level deep and navigable.

Trim explanatory prose Claude already knows (e.g., 'fast, provides context for later columns' annotations and the Prerequisites bullets) and consider condensing the ASCII diagrams to reduce token cost.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete schemas, formulas, and configs that earn their place, but it includes explanation Claude already knows (e.g., 'Clearbit) ─ fast, provides context for later columns' commentary and prerequisites like 'Clear understanding of data volume') and the ASCII diagrams are verbose. Not a 3 because some prose and the large diagrams could be tightened; not a 1 because it is not padded with generic concept explanations like the 'PDF is a common format...' anchor.

2 / 3

Actionability

Provides concrete, copy-paste-ready artifacts: a full Clay LET formula for ICP scoring, YAML waterfall and CRM-sync configs with exact field mappings, and a column execution order. Not below 3 because the examples are specific and executable rather than pseudocode; the formula and field_mapping blocks are directly usable, matching the 'fully executable code/commands' anchor.

3 / 3

Workflow Clarity

Steps are clearly sequenced (Step 1–5) and the Error Handling table acts as a partial recovery guide, but batch/destructive CRM push operations lack explicit validation checkpoints — the rubric caps workflow clarity at 2 when validation is missing for batch/destructive operations. Not a 3 because there is no 'validate -> fix -> retry' feedback loop for the CRM sync or enrichment runs; not a 1 because the multi-step sequence is clearly laid out rather than unclear or missing.

2 / 3

Progressive Disclosure

Two bundle files exist (references/implementation-guide.md, references/implementation.md) but the body never links or signals them — the only pointer is the unrelated 'clay-multi-env-setup' Next Steps line — so content that should be offloaded (the layered client/DI patterns in implementation.md) is absent from navigation while inline content is dense. Not a 3 because references are not clearly signaled/linked one level deep; not a 1 because the body itself is reasonably sectioned rather than a monolithic wall with nested references.

2 / 3

Total

9

/

12

Passed

Description

100%

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 strong: it names concrete capabilities, supplies explicit 'Use when' triggers with natural user phrases, and occupies a distinct Clay-architecture niche. It fully satisfies the what/when requirement with minimal padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'table schemas, waterfall patterns, and CRM sync' and 'architecting... reviewing data flow design... establishing enrichment pipeline standards' — naming specific capabilities rather than vague language. Not below 3 because it enumerates several distinct concrete actions like the 'Extract text and tables... fill forms, merge documents' anchor; not a 2 because it goes beyond naming only a domain plus some actions.

3 / 3

Completeness

Clearly answers both 'what' ('Design production Clay enrichment pipelines with table schemas, waterfall patterns, and CRM sync') and 'when' ('Use when architecting new Clay integrations, reviewing data flow design, or establishing enrichment pipeline standards'). Not below 3 because it has an explicit 'Use when...' clause matching the highest anchor; a missing 'Use when' would cap it at 2, but it is present.

3 / 3

Trigger Term Quality

Provides explicit natural trigger phrases — 'clay architecture', 'clay best practices', 'clay pipeline design', 'clay reference', 'clay data flow' — that a user would plausibly say when needing this skill. Not below 3 because the coverage of natural terms matches the 'PDF files, PDFs, forms' anchor; these are domain-appropriate terms a Clay user would actually invoke.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (Clay-specific architecture/pipeline design) with distinct clay-prefixed triggers unlikely to fire for unrelated skills. Not below 3 because the specialized 'clay architecture'/'clay pipeline design' triggers are distinct from generic data or enrichment skills, matching the clear-niche anchor.

3 / 3

Total

12

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 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

14

/

16

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.