Execute comprehensive Documenso migration strategies for platform switches. Use when migrating from other signing platforms, re-platforming to Documenso, or performing major infrastructure changes. Trigger with phrases like "migrate to documenso", "documenso migration", "switch to documenso", "documenso replatform", "replace docusign".
79
76%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/documenso-pack/skills/documenso-migration-deep-dive/SKILL.mdQuality
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 description excels at trigger term coverage and completeness, with explicit 'Use when' and 'Trigger with' clauses that make it easy for Claude to select appropriately. Its main weakness is the lack of specific concrete actions — it says 'comprehensive migration strategies' without detailing what those strategies entail (e.g., data migration, template conversion, API mapping). The distinctiveness is excellent due to the product-specific focus.
Suggestions
Replace 'comprehensive migration strategies' with specific concrete actions like 'migrate templates, transfer signing workflows, map API integrations, convert webhook configurations, and import user accounts'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (Documenso migration, platform switches) and mentions some actions like 'migrating from other signing platforms' and 'major infrastructure changes', but doesn't list specific concrete actions (e.g., migrate templates, transfer users, map API endpoints, convert webhooks). 'Comprehensive migration strategies' is somewhat vague. | 2 / 3 |
Completeness | Clearly answers both 'what' (execute migration strategies for platform switches) and 'when' (migrating from other signing platforms, re-platforming, major infrastructure changes) with explicit trigger phrases listed separately. | 3 / 3 |
Trigger Term Quality | Excellent trigger term coverage including natural phrases users would say: 'migrate to documenso', 'documenso migration', 'switch to documenso', 'documenso replatform', 'replace docusign'. The inclusion of a competitor name (DocuSign) as a trigger is particularly useful for real-world queries. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche — Documenso-specific migration. The combination of a specific product name and migration context makes it very unlikely to conflict with other skills. Trigger terms are precise and product-specific. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured migration guide with a clear phased approach and good workflow sequencing, but it's overly long for a SKILL.md file and the code examples are more illustrative than executable. The content would benefit from being split into sub-files (assessment, template migration, webhook migration, rollback) with the SKILL.md serving as a concise overview with navigation links.
Suggestions
Split the detailed code examples and tables into separate reference files (e.g., TEMPLATE_MIGRATION.md, WEBHOOK_MAPPING.md) and keep SKILL.md as a concise overview with links to each phase.
Make code examples more executable — for instance, provide a working script that actually calls the Documenso API to create a document rather than interface definitions and hardcoded return values.
Remove the `!npm list` current state check at the top — it adds little value and the output is unpredictable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes unnecessary verbosity — the ASCII diagrams for the Strangler Fig pattern are helpful but the overall content is quite long. Some sections like the assessment interface and template definitions are more illustrative than actionable, and the feature mapping table, while useful, could be more compact. | 2 / 3 |
Actionability | The TypeScript code examples are concrete but not truly executable — they're structural templates/interfaces rather than copy-paste-ready scripts. The assessment function returns hardcoded example data, the template migration says 'create in UI manually,' and the parallel testing code is illustrative rather than functional. The rollback procedure with bash commands is more actionable. | 2 / 3 |
Workflow Clarity | The multi-step migration process is clearly sequenced across 6 steps with a timeline table. The Strangler Fig pattern provides explicit phases, the rollback procedure is well-defined with numbered steps, and the migration timeline table includes risk levels. The parallel/shadow testing phase serves as a validation checkpoint before live traffic cutover. | 3 / 3 |
Progressive Disclosure | The content is quite long and monolithic — all migration details are inline rather than split into separate files for each phase or topic. It references external resources and a related skill (documenso-install-auth) but doesn't break its own substantial content into sub-files. The error handling and feature mapping tables could be separate reference documents. | 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.
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 | |
3e83543
Table of Contents
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.