Apply production-ready Documenso SDK patterns for TypeScript and Python. Use when implementing Documenso integrations, refactoring SDK usage, or establishing team coding standards for Documenso. Trigger with phrases like "documenso SDK patterns", "documenso best practices", "documenso code patterns", "idiomatic documenso".
80
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/saas-packs/documenso-pack/skills/documenso-sdk-patterns/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 is a solid skill description with excellent trigger terms and completeness. Its main weakness is that the specific capabilities are described at a high level ('SDK patterns', 'integrations') rather than listing concrete actions the skill enables (e.g., document creation, template management, signer configuration). The niche focus on Documenso makes it highly distinctive.
Suggestions
Add concrete SDK operations to improve specificity, e.g., 'creating documents, managing signers, configuring templates, handling webhooks' rather than just 'SDK patterns'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (Documenso SDK) and mentions some actions like 'implementing integrations', 'refactoring SDK usage', and 'establishing team coding standards', but these are fairly high-level and don't describe concrete SDK operations (e.g., creating documents, managing signers, handling webhooks). | 2 / 3 |
Completeness | Clearly answers both 'what' (apply production-ready Documenso SDK patterns for TypeScript and Python) and 'when' (implementing integrations, refactoring SDK usage, establishing coding standards) with explicit trigger phrases provided. | 3 / 3 |
Trigger Term Quality | Includes explicit trigger phrases like 'documenso SDK patterns', 'documenso best practices', 'documenso code patterns', 'idiomatic documenso', plus natural terms like 'Documenso integrations' and mentions both TypeScript and Python. These are terms users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Documenso is a specific product/SDK, making this highly distinctive. The repeated use of 'Documenso' as a qualifier and the specific trigger phrases make it very unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, highly actionable skill with production-ready code patterns covering the full Documenso SDK lifecycle. Its main weaknesses are length (could benefit from splitting patterns into separate files) and missing workflow composition guidance showing how the patterns chain together with validation checkpoints. The code quality is high but the skill reads more like a reference library than a concise instructional guide.
Suggestions
Add a brief 'Composing Patterns' section showing how to chain withRetry + withErrorHandling + createAndSendDocument together, with explicit validation checkpoints between multi-step operations.
Move patterns 3-6 (error handling, retry, Python, testing) into separate reference files and link from the main SKILL.md to reduce its size and improve progressive disclosure.
Remove the prerequisites about 'Familiarity with async/await and TypeScript generics' — Claude already knows these concepts.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient with executable code examples, but is quite long (~250 lines of code patterns). Some patterns could be more concise — the prerequisites section mentions things Claude already knows ('Familiarity with async/await and TypeScript generics'), and the Python pattern largely duplicates the TypeScript pattern. The error handling table is a nice compact format though. | 2 / 3 |
Actionability | Every pattern provides fully executable, copy-paste ready code with proper imports, file paths, type definitions, and complete implementations. The code covers client initialization, document creation, error handling, retry logic, Python equivalent, and testing mocks — all concrete and specific. | 3 / 3 |
Workflow Clarity | While individual patterns are clear, there's no explicit sequencing of how these patterns compose together (e.g., 'wrap createAndSendDocument with withErrorHandling and withRetry'). The createAndSendDocument function is a multi-step process (create → upload → add recipients → add fields → send) but lacks validation checkpoints between steps — if field creation fails mid-loop, there's no recovery guidance. | 2 / 3 |
Progressive Disclosure | The content is structured with clear pattern headings and an error table, but all six patterns are inline in a single file making it quite long. The patterns for error handling, retry, testing, and Python could reasonably be split into separate reference files with the SKILL.md providing a quick-start overview and links. The Resources section and Next Steps provide some navigation. | 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.