instantly-upgrade-migration
Migrate Instantly.ai integrations from API v1 to v2. Use when upgrading from deprecated v1 endpoints, updating authentication, or migrating endpoint paths and request formats. Trigger with phrases like "instantly v1 to v2", "instantly api migration", "instantly upgrade", "instantly deprecated", "migrate instantly api".
68
83%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
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 with clear 'what' and 'when' clauses, explicit trigger phrases, and a highly distinctive niche. The main weakness is that the specific capabilities could be more detailed — listing concrete actions like specific endpoint changes, authentication method differences, or payload format transformations would strengthen the specificity dimension.
Suggestions
Add more concrete actions such as 'updates OAuth headers, remaps /api/v1/ paths to /api/v2/, transforms request/response payloads' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Instantly.ai API migration v1 to v2) and mentions some actions like 'updating authentication' and 'migrating endpoint paths and request formats', but doesn't list comprehensive specific actions (e.g., specific endpoints, specific field mappings, specific breaking changes). | 2 / 3 |
Completeness | Clearly answers both 'what' (migrate Instantly.ai integrations from API v1 to v2) and 'when' (upgrading from deprecated v1 endpoints, updating authentication, migrating endpoint paths). Includes explicit 'Use when' and 'Trigger with' clauses. | 3 / 3 |
Trigger Term Quality | Explicitly lists natural trigger phrases like 'instantly v1 to v2', 'instantly api migration', 'instantly upgrade', 'instantly deprecated', 'migrate instantly api'. These cover common variations a user would naturally say when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — targets a very specific product (Instantly.ai) and a specific migration path (v1 to v2). Extremely unlikely to conflict with other skills due to the narrow, product-specific niche. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable migration skill with excellent concrete code examples, a comprehensive endpoint mapping table, and a clear sequential workflow. Its main weakness is that it's somewhat monolithic—the detailed adapter code, pagination examples, and new v2 features section could be split into separate files for better progressive disclosure. Minor conciseness issues exist with some explanatory content Claude wouldn't need, but overall the skill provides genuine, hard-to-know migration-specific information.
Suggestions
Split the migration adapter class, pagination migration, and v2 new features into separate referenced files to reduce the main SKILL.md size and improve progressive disclosure.
Remove the Prerequisites section—Claude already understands Bearer auth and can infer the need for dashboard access from the migration steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient with good use of tables and code examples, but includes some unnecessary content like the Prerequisites section (Claude knows what Bearer auth is), explanatory comments that are redundant with the migration table, and the 'New v2 Features to Adopt' section which goes beyond migration scope. The v1 code examples with 'DEPRECATED' comments add useful context but some could be trimmed. | 2 / 3 |
Actionability | Excellent actionability with fully executable TypeScript code examples, a complete migration adapter class, concrete bash commands for auditing, a comprehensive endpoint migration table, and specific request/response body transformations. The code is copy-paste ready and covers the full migration lifecycle. | 3 / 3 |
Workflow Clarity | Clear 4-step sequential workflow (Audit → Adapter → Pagination → New Features) with a comprehensive migration checklist that serves as validation checkpoints. The error handling table provides a feedback loop for common migration failures, and the checklist ensures nothing is missed. The audit step explicitly starts with discovery before making changes. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and headers, but it's quite long for a single file with no bundle files to offload detailed content. The migration adapter class, pagination examples, and v2 new features could each be separate referenced files. The reference to 'instantly-ci-integration' at the end is good but the main file is monolithic. | 2 / 3 |
Total | 10 / 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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
- Commit
a04d1a2
- 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.