q-and-a-prep-partner

Predict challenging questions for presentations and prepare structured responses.

Quality

33%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

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

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 identifies a useful niche (presentation Q&A preparation) but is too brief and lacks explicit trigger guidance. It needs a 'Use when...' clause to help Claude know when to select this skill, and would benefit from more specific capability details and natural trigger terms users would actually say.

Suggestions

Add a 'Use when...' clause with trigger terms like 'prepare for Q&A', 'anticipate questions', 'presentation defense', 'tough audience questions', or 'objection handling'.

Expand the capability description to include specifics like 'identifies potential objections, prepares talking points, suggests evidence-based rebuttals'.

Include natural variations users might say such as 'Q&A prep', 'audience questions', 'defend my presentation', or 'prepare for pushback'.

Dimension	Reasoning	Score
Specificity	Names the domain (presentations) and two actions (predict questions, prepare responses), but lacks comprehensive detail about what types of questions, what 'structured responses' means, or additional capabilities.	2 / 3
Completeness	Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing explicit trigger guidance caps this at 2, but the 'what' is also weak, warranting a 1.	1 / 3
Trigger Term Quality	Includes 'presentations' as a natural keyword, but misses common variations users might say like 'Q&A prep', 'audience questions', 'presentation defense', 'tough questions', or 'anticipate objections'.	2 / 3
Distinctiveness Conflict Risk	The focus on 'challenging questions' and 'presentations' provides some specificity, but could overlap with general presentation skills or Q&A preparation tools without clearer boundaries.	2 / 3
	Total	7 / 12 Passed

Implementation

35%

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 over-engineered with boilerplate that obscures the core task. While it provides CLI parameters and basic structure, it fails to show concrete examples of question generation or response frameworks - the actual deliverable. The extensive security checklists, lifecycle status, and evaluation criteria consume tokens without helping Claude perform Q&A preparation.

Suggestions

Remove boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that don't help Claude execute the task

Add concrete input/output examples showing an abstract → generated questions → response frameworks workflow

Consolidate redundant sections and remove 'See X above' cross-references that add no value

Show actual example questions for each question type with sample response structures

Dimension	Reasoning	Score
Conciseness	Extremely verbose with excessive boilerplate, redundant sections (multiple 'See X above' references), and unnecessary meta-content like lifecycle status, security checklists, and evaluation criteria that don't help Claude perform the actual task of generating Q&A prep.	1 / 3
Actionability	Provides concrete CLI commands and parameters, but the actual core task (predicting questions and preparing responses) lacks executable examples showing input/output. The 'Question Types' section lists categories without showing how to actually generate or structure responses.	2 / 3
Workflow Clarity	Has numbered workflow steps but they are generic process steps rather than task-specific guidance. Missing concrete examples of how to analyze an abstract and generate challenging questions with response frameworks.	2 / 3
Progressive Disclosure	References external files appropriately (references/audit-reference.md) but the main document is bloated with sections that should be elsewhere or removed entirely. The structure exists but content organization is poor with redundant cross-references.	2 / 3
	Total	7 / 12 Passed

Validation

90%

Warnings & errors only

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

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: aipoch/medical-research-skills
Commit: 4a48721

Reviewed: about 10 hours ago

Table of Contents

Discovery Implementation Validation

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.