CtrlK
BlogDocsLog inGet started
Tessl Logo

apollo-upgrade-migration

Manage Apollo.io API upgrades and endpoint migrations. Use when upgrading Apollo API versions, migrating to new endpoints, or updating deprecated API usage. Trigger with phrases like "apollo upgrade", "apollo migration", "update apollo api", "apollo breaking changes", "apollo deprecation".

71

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

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 a well-sequenced, validated migration workflow, but it is longer and more redundant than necessary and fails to route detail into the existing reference file. Linking the implementation guide and de-duplicating the endpoint mappings would lift the two weaker dimensions.

Suggestions

Reference the existing bundle from the body (e.g., 'Full implementation details: see [implementation-guide.md](references/implementation-guide.md)') and move the duplicated audit/migration code there to improve progressive disclosure and reduce inline redundancy.

De-duplicate the endpoint mappings: maintain a single source of truth shared by the Step 1 audit ENDPOINT_MAP and the Step 2 MIGRATION_RULES instead of repeating people/search and organizations/search in both.

Remove or justify the 'Current State' `npm list axios` block, which does not clearly serve the migration workflow and adds noise.

DimensionReasoningScore

Conciseness

The body is mostly efficient code, but the endpoint mappings are duplicated between the Step 1 audit ENDPOINT_MAP and the Step 2 MIGRATION_RULES, and the 'Current State' `npm list axios` block adds little, so it could be tightened rather than earning the lean score-3 anchor.

2 / 3

Actionability

Every step ships complete, executable TypeScript (audit script, regex find/replace rules, feature-flag module, shadow-test function) and bash cleanup commands that are copy-paste ready, matching the fully-executable score-3 anchor.

3 / 3

Workflow Clarity

A clear five-step sequence (audit, migration map, feature flag, shadow comparison, cleanup) is anchored by explicit validation checkpoints in Steps 4 and 5 plus an error-handling table with recovery guidance, meeting the score-3 bar rather than the implicit-checkpoint score-2 bar.

3 / 3

Progressive Disclosure

A 341-line references/implementation-guide.md bundle exists but is never linked from the body, while the body inlines implementation code that overlaps that reference, fitting the score-2 anchor of content that should be separate kept inline with an unsignaled reference rather than the well-signaled score-3 pattern.

2 / 3

Total

10

/

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 cleanly answers both 'what' and 'when', uses natural trigger phrasing, and occupies a distinct niche with no voice violations. Its only weakness is cosmetic: awkward blank lines between sentences that do not affect the scored dimensions.

DimensionReasoningScore

Specificity

Names the Apollo.io API domain plus multiple concrete actions ('upgrading Apollo API versions, migrating to new endpoints, or updating deprecated API usage'), matching the multiple-specific-actions anchor rather than the single-action score-2 example.

3 / 3

Completeness

Explicitly states what it does ('Manage Apollo.io API upgrades and endpoint migrations') and when to use it ('Use when upgrading...') with explicit trigger phrases, satisfying both halves required for score 3.

3 / 3

Trigger Term Quality

Lists five natural phrases a user would actually say ('apollo upgrade', 'apollo migration', 'update apollo api', 'apollo breaking changes', 'apollo deprecation'), giving good coverage rather than the partial coverage at score 2.

3 / 3

Distinctiveness Conflict Risk

Tightly scoped to the Apollo.io API niche with distinct, product-specific triggers and third-person imperative voice, making conflict with other skills unlikely.

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.