CtrlK
BlogDocsLog inGet started
Tessl Logo

recipe-draft-email-from-doc

Read content from a Google Doc and use it as the body of a Gmail message.

64

Quality

56%

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 ./skills/recipe-draft-email-from-doc/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 clearly identifies a specific cross-service workflow between Google Docs and Gmail, giving it good distinctiveness. However, it lacks an explicit 'Use when...' clause, covers only a single narrow action, and misses common user phrasings that would help Claude select it appropriately.

Suggestions

Add a 'Use when...' clause such as 'Use when the user wants to send a Google Doc as an email, email document content via Gmail, or compose a Gmail message from a Doc.'

Include natural trigger term variations like 'send doc as email', 'email a Google Doc', 'compose Gmail from document', '.gdoc to email'.

Expand the capability description to cover related actions if applicable, such as formatting preservation, attachment options, or selecting specific sections of the doc.

DimensionReasoningScore

Specificity

Names two specific services (Google Doc, Gmail) and describes a concrete workflow (read content, use as email body), but only describes one narrow action rather than listing multiple capabilities.

2 / 3

Completeness

Describes what the skill does but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric should cap completeness at 2, and the 'what' is also fairly narrow. The absence of any 'when' guidance caps this at 2, but the 'what' is also minimal, placing it closer to 1.

1 / 3

Trigger Term Quality

Includes natural keywords like 'Google Doc', 'Gmail', and 'email message', but misses common variations users might say such as 'send doc as email', 'email a document', 'Google Docs to email', or 'compose email from doc'.

2 / 3

Distinctiveness Conflict Risk

The combination of Google Doc reading and Gmail sending is a very specific niche workflow that is unlikely to conflict with other skills. The cross-service integration (Docs → Gmail) creates a distinct trigger profile.

3 / 3

Total

8

/

12

Passed

Implementation

72%

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

This is a concise, well-structured recipe that clearly communicates the high-level workflow. However, it falls short on actionability in the critical middle step (extracting text from the document response) and lacks validation before the irreversible email send operation. The skill would benefit from showing how to parse the document response and confirming content before sending.

Suggestions

Clarify step 2 by showing how to extract plain text from the Google Docs API response (which returns structured JSON with paragraphs/elements, not raw text).

Add a validation checkpoint before sending the email, such as confirming the extracted content is non-empty and reviewing it before proceeding with the send command.

DimensionReasoningScore

Conciseness

Very lean and efficient. The prerequisite note is necessary context, and the steps are minimal without explaining what Google Docs or Gmail are. Every token earns its place.

3 / 3

Actionability

Provides concrete CLI commands with specific syntax, but step 2 ('Copy the text from the body content') is vague—it doesn't explain how to extract text from the structured document response (which returns JSON with nested structural elements, not plain text). The placeholder 'CONTENT_FROM_DOC' lacks guidance on how to actually extract and format the content.

2 / 3

Workflow Clarity

Steps are sequenced clearly, but there's no validation—no check that the document was retrieved successfully, no handling of empty documents, and no verification that the email was sent. For an operation that sends email (a non-reversible action), a validation checkpoint before sending would be important.

2 / 3

Progressive Disclosure

For this simple, short skill (under 50 lines, single task), the structure is appropriate. It references prerequisite skills clearly and keeps the content concise without needing external files.

3 / 3

Total

10

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

Passed

Repository
googleworkspace/cli
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.