CtrlK
BlogDocsLog inGet started
Tessl Logo

q-and-a-prep-partner

Predict challenging questions for presentations and prepare structured responses.

34

Quality

30%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/q-and-a-prep-partner/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 communicates a clear but narrow concept—predicting tough questions for presentations and preparing answers. However, it lacks a 'Use when...' clause, which is critical for Claude to know when to select this skill. The trigger terms are adequate but miss natural user phrasings, and the specificity could be improved with more concrete action details.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user is preparing for a presentation and wants to anticipate audience questions, practice Q&A, or prepare for tough questions.'

Include more natural trigger terms users would say, such as 'Q&A prep', 'audience questions', 'anticipate objections', 'presentation defense', 'tough questions', or 'devil's advocate'.

Expand the specificity of actions, e.g., 'Predicts challenging audience questions, categorizes them by topic and difficulty, and generates structured talking-point responses with supporting evidence.'

DimensionReasoningScore

Specificity

Names the domain (presentations) and two actions (predict questions, prepare responses), but lacks detail on what 'structured responses' entails or additional concrete capabilities like categorizing by difficulty, generating follow-up points, etc.

2 / 3

Completeness

Describes what the skill does (predict questions and prepare responses) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause caps completeness at 2, and since the 'what' is also only moderately detailed, this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant terms like 'presentations', 'questions', and 'responses', but misses common natural variations users might say such as 'Q&A prep', 'audience questions', 'tough questions', 'presentation defense', or 'anticipate objections'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'presentations' and 'challenging questions' is somewhat specific, but 'presentations' alone could overlap with presentation creation/editing skills, and 'prepare structured responses' is generic enough to conflict with general writing or Q&A skills.

2 / 3

Total

7

/

12

Passed

Implementation

27%

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

This skill is heavily padded with boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that add no task-specific value and consume significant tokens. The core task—predicting challenging Q&A questions—is poorly served because there are no concrete examples of generated questions or response frameworks. The document suffers from circular internal references and redundant sections that obscure rather than clarify the workflow.

Suggestions

Remove boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that don't add task-specific guidance, and eliminate circular 'See ## X above' references.

Add concrete examples showing sample input (e.g., an abstract) and expected output (e.g., 2-3 predicted questions with structured response frameworks) so Claude knows what good output looks like.

Consolidate the three overlapping workflow descriptions (Example Usage run plan, Implementation Details, Workflow) into a single clear numbered sequence with specific validation checkpoints.

If the skill relies on scripts/main.py, provide the actual script or at minimum describe its logic so Claude can operate without it or debug failures meaningfully.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Prerequisites above', 'See ## Usage above', 'See ## Workflow above'). Boilerplate sections like Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, and Response Template add significant token overhead without providing actionable value for the core task of Q&A preparation. The skill explains generic workflow concepts Claude already knows.

1 / 3

Actionability

Provides concrete CLI commands with parameters (--abstract, --topic, --field, --audience) and example invocations, which is useful. However, the actual Q&A preparation logic is entirely delegated to an opaque scripts/main.py with no visibility into what it does or how to use its output. The question types and output sections are listed but lack concrete examples of generated questions or response frameworks.

2 / 3

Workflow Clarity

There is a numbered workflow (steps 1-5) and an example run plan (steps 1-4), but they are generic and duplicative. The workflow lacks specific validation checkpoints tied to the Q&A preparation task—steps like 'validate that the request matches the documented scope' are abstract rather than concrete. Error handling is mentioned but the feedback loop is vague.

2 / 3

Progressive Disclosure

The document is a monolithic wall of text with many sections that could be consolidated or removed. Circular cross-references ('See ## Prerequisites above') point to sections within the same file, adding confusion rather than navigation. The single external reference (references/audit-reference.md) is not provided in the bundle, and no meaningful content splitting is achieved. Multiple redundant sections (Workflow, Example Usage run plan, Implementation Details) cover overlapping ground.

1 / 3

Total

6

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
aipoch/medical-research-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.