CtrlK
BlogDocsLog inGet started
Tessl Logo

documenso-migration-deep-dive

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

Quality

76%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

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.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 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'.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.