CtrlK
BlogDocsLog inGet started
Tessl Logo

clay-upgrade-migration

Navigate Clay plan changes, pricing migrations, and feature upgrades. Use when upgrading Clay plans, migrating to the 2026 pricing model, or adapting integrations to new Clay features. Trigger with phrases like "upgrade clay", "clay migration", "clay pricing change", "clay plan upgrade", "clay new pricing".

74

Quality

70%

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-upgrade-migration/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 solid skill description with explicit trigger guidance, a clear 'Use when' clause, and distinct Clay-specific terminology that minimizes conflict risk. The main weakness is that the capabilities described are somewhat high-level—terms like 'navigate' and 'adapt integrations' could be more concrete with specific actions (e.g., 'update API endpoints', 'reconfigure webhook settings').

Suggestions

Add more specific concrete actions to improve specificity, e.g., 'reconfigure API integrations, update billing settings, map deprecated features to new equivalents' instead of the vague 'navigate' and 'adapt integrations'.

DimensionReasoningScore

Specificity

The description names the domain (Clay plan changes, pricing migrations, feature upgrades) and some actions (navigate, upgrade, migrate, adapt integrations), but the actions are somewhat general and not deeply concrete—e.g., it doesn't specify what exactly is done during migration or what integrations are adapted.

2 / 3

Completeness

The description clearly answers both 'what' (navigate Clay plan changes, pricing migrations, feature upgrades) and 'when' (explicit 'Use when...' clause plus a 'Trigger with phrases like...' section with concrete examples).

3 / 3

Trigger Term Quality

The description explicitly lists natural trigger phrases like 'upgrade clay', 'clay migration', 'clay pricing change', 'clay plan upgrade', 'clay new pricing', which are terms users would naturally say. Good coverage of variations.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to Clay platform pricing and plan migrations, which is a clear niche unlikely to conflict with other skills. The trigger terms are all Clay-specific.

3 / 3

Total

11

/

12

Passed

Implementation

50%

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

This skill provides a solid informational guide to Clay's 2026 pricing migration with useful decision matrices and concrete TypeScript examples. Its main weaknesses are that the audit step lacks executable actions (just dashboard navigation comments), validation checkpoints are missing from the migration workflow, and the content is somewhat verbose for what could be a more concise decision-and-action guide. The time-sensitive pricing information (specific dates, plan prices) risks becoming stale.

Suggestions

Replace the bash-comment audit step with an actionable checklist or script that queries Clay's API for current usage data, rather than instructions to visually inspect a dashboard.

Add explicit validation checkpoints after migration — e.g., 'After switching plans: 1. Verify HTTP API columns respond, 2. Test webhook delivery, 3. Confirm credit tracking matches expected model' — integrated into the workflow steps rather than a separate error table.

Trim the pricing tables to essential decision-relevant columns and move detailed legacy plan information to a separate reference file to improve conciseness and progressive disclosure.

Add a note or section header flagging the time-sensitive nature of the pricing dates (April 10, 2026 cutoff) so it's clear when this information may be outdated.

DimensionReasoningScore

Conciseness

The skill includes some unnecessary commentary (e.g., explaining what Data Credits and Actions are in multiple places, the bash comments that are just instructions to look at a dashboard rather than executable commands). The tables are efficient, but the TypeScript credit tracker class is somewhat over-engineered for what is essentially a conceptual guide, and the 'Old model vs New model' comments are explanatory rather than actionable.

2 / 3

Actionability

The TypeScript code is concrete and executable, and the decision matrix is helpful. However, the 'audit' step is just bash comments telling you to look at a dashboard (not executable), the curl webhook test is reasonable but lacks verification of the response, and much of the guidance is informational rather than directly actionable (pricing tables, provider credit comparisons).

2 / 3

Workflow Clarity

Steps are clearly numbered and sequenced, and the decision matrix provides good branching logic. However, there are no explicit validation checkpoints — after migrating plans, there's no 'verify your integrations still work' checklist or feedback loop for error recovery. The error handling table is helpful but separate from the workflow rather than integrated as validation steps.

2 / 3

Progressive Disclosure

The content is reasonably well-structured with clear sections and headers. However, it's somewhat monolithic — the pricing tables, integration code, and optimization strategies could benefit from being split into separate referenced files. The 'Next Steps' reference to 'clay-ci-integration' is good but there are no bundle files to support progressive disclosure. External resource links are provided but minimal.

2 / 3

Total

8

/

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.