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

59

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

50%

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

The content is a clear, mostly-efficient migration guide with concrete code, but it is held back by an orphaned reference file whose content is duplicated inline, illustrative/stub code rather than fully executable scripts, and the absence of explicit validation checkpoints for a destructive cutover workflow.

Suggestions

Link the existing references/implementation-guide.md from the body (e.g., a '## Implementation details' section pointing to it) and move the duplicated phase/code material there instead of restating it inline.

Replace hardcoded sample values and undefined stubs (sendViaLegacy, onDocumentCompleted) with executable, parameterized code or clearly mark them as interfaces to implement.

Add explicit validation checkpoints between migration phases (e.g., verify shadow-send parity before pilot, validate template recreation before cutover) so the destructive cutover has a validate->fix->retry loop.

DimensionReasoningScore

Conciseness

The body is mostly efficient, letting code and tables carry the content with little concept-explanation, but it repeats material (Strangler Fig diagram plus a separate timeline) and duplicates much of the unreferenced implementation-guide.md, with some padded commentary ("Instructions: create each template in the Documenso UI using these specs"). Not a 1 (not padded with concepts Claude knows), not a 3 (the duplication and comments mean not every token earns its place).

2 / 3

Actionability

It provides concrete, near-executable TypeScript (event mapping, dual-write router, shadow-send) and a bash rollback, but key blocks are illustrative with hardcoded sample data ("activeTemplates: 15", "documentsPerMonth: 200"), templates are UI-only with no executable path, and functions like sendViaLegacy/onDocumentCompleted are undefined stubs. Not a 1 (real code and commands exist), not a 3 (not fully copy-paste executable due to stubs and sample data).

2 / 3

Workflow Clarity

A clear 6-step sequence with a phase diagram, timeline, and rollback procedure is present, but for a destructive cutover/batch migration the rubric requires explicit validation checkpoints between phases; validation is only loose (shadow-send "compare results", a reactive error table) with no validate->fix->retry gate. Per the rubric, missing validation gates for destructive/batch ops caps this at 2. Not a 1 (sequence is clearly laid out).

2 / 3

Progressive Disclosure

A well-structured bundle file exists (references/implementation-guide.md, ~16KB with phases and rollback), but the SKILL.md body never links or signals it, instead duplicating much of the same material inline; the reference is effectively orphaned with no one-level-deep navigation. Not a 1 (sections are organized, not a monolithic wall), not a 3 (references are not clearly signaled and content that should be separate is inline).

2 / 3

Total

8

/

12

Passed

Description

90%

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 is strong: it states what and when clearly, supplies five natural trigger phrases, and is tightly scoped to Documenso migration with low conflict risk. The only weakness is mild abstraction/fluff ("comprehensive") in the capability statement rather than enumerated concrete actions.

DimensionReasoningScore

Specificity

Names the domain and action class ("Execute comprehensive Documenso migration strategies for platform switches", "re-platforming", "major infrastructure changes"), but the actions are abstract rather than a list of concrete operations; "comprehensive" is mild fluff. It is above a 1 (domain and actions are named) but not a 3 (no enumeration of concrete operations like webhook mapping or template recreation).

2 / 3

Completeness

It answers both what ("Execute comprehensive Documenso migration strategies for platform switches") and when ("Use when migrating from other signing platforms, re-platforming to Documenso, or performing major infrastructure changes") with explicit trigger guidance. Not a 2 because the when-clause is explicit, not merely implied.

3 / 3

Trigger Term Quality

An explicit "Trigger with phrases like" clause lists five natural phrases a user would actually say ("migrate to documenso", "documenso migration", "switch to documenso", "documenso replatform", "replace docusign"). This matches the anchor for good coverage of natural terms; it is not a 2 because multiple genuine variations are present rather than a single generic term.

3 / 3

Distinctiveness Conflict Risk

It occupies a clear niche (Documenso migration) with distinct, platform-specific triggers including "replace docusign", making it unlikely to fire for unrelated skills. Matches the clear-niche-with-distinct-triggers anchor.

3 / 3

Total

11

/

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.

Validation13 / 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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

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.