CtrlK
BlogDocsLog inGet started
Tessl Logo

meeting-minutes

Use meeting minutes for other workflows that need structured execution, explicit assumptions, and clear output boundaries.

15

Quality

0%

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/meeting-minutes/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

0%

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 description is extremely vague and fails to communicate what the skill actually does, when it should be used, or how it differs from other skills. It reads more like an abstract design principle than a functional skill description. The only concrete term is 'meeting minutes', but even that is not tied to specific actions.

Suggestions

Replace abstract language with concrete actions the skill performs, e.g., 'Extracts action items, decisions, and attendees from meeting minutes and formats them into structured task lists or follow-up emails.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to process meeting notes, extract action items, summarize meetings, or create follow-ups from meeting minutes.'

Clarify the specific output types and workflows this skill supports to distinguish it from general document processing or summarization skills.

DimensionReasoningScore

Specificity

The description uses vague, abstract language like 'other workflows', 'structured execution', 'explicit assumptions', and 'clear output boundaries' without naming any concrete actions or capabilities.

1 / 3

Completeness

The 'what' is extremely vague — it's unclear what the skill actually does beyond something involving meeting minutes. The 'when' is also unclear; 'for other workflows' is not an explicit trigger condition.

1 / 3

Trigger Term Quality

'Meeting minutes' is the only natural keyword, but the rest of the description uses abstract jargon ('structured execution', 'explicit assumptions', 'clear output boundaries') that users would never naturally say when requesting help.

1 / 3

Distinctiveness Conflict Risk

The description is so generic ('other workflows', 'structured execution') that it could overlap with virtually any skill that processes meeting notes, documents, or structured data. There are no distinct triggers to differentiate it.

1 / 3

Total

4

/

12

Passed

Implementation

0%

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

This skill is a heavily templated, boilerplate-driven document that fails on all dimensions. It is extremely verbose yet provides almost no actionable, domain-specific guidance on structuring meeting minutes. The circular internal references, generic workflow steps, and extensive boilerplate sections (risk assessment, security checklist, lifecycle status, evaluation criteria) consume significant tokens while adding no practical value for the stated task.

Suggestions

Remove all boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) and circular self-references ('See ## X above') to reduce token waste by ~60%.

Add a concrete example showing an actual meeting transcript snippet being transformed into the output JSON format with specific action items, decisions, and attendees extracted.

Replace the generic 5-step workflow with meeting-minutes-specific steps: e.g., 1) Parse transcript for speaker turns, 2) Identify decisions (look for 'agreed', 'decided'), 3) Extract action items (look for 'will do', 'by [date]'), 4) Validate completeness against attendee list.

Either provide the actual scripts/main.py content or remove references to it and instead give inline executable code that performs the transcript-to-minutes transformation.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Features above', 'See ## Prerequisites above', 'See ## Workflow above'). The skill explains generic concepts Claude already knows (what input validation is, what error handling means), includes boilerplate security checklists, lifecycle metadata, evaluation criteria, and risk assessment tables that add no actionable value. The 'When to Use' section literally repeats the skill description three times in slightly different words.

1 / 3

Actionability

Despite its length, the skill provides almost no concrete guidance on how to actually structure meeting minutes. The workflow steps are entirely generic ('Confirm the user objective', 'Validate that the request matches the documented scope') and could apply to any skill. There's no example of actual transcript input being converted to meeting minutes, no concrete transformation logic, and the 'scripts/main.py' is referenced but never explained. The output JSON schema is the only concrete element.

1 / 3

Workflow Clarity

The workflow section contains five generic steps that provide no meeting-minutes-specific guidance. There are no validation checkpoints for the actual content transformation (e.g., verifying action items were correctly extracted). The 'Example run plan' is also generic. No feedback loops exist for verifying the quality of extracted minutes, and the circular references ('See ## Workflow above') create confusion rather than clarity.

1 / 3

Progressive Disclosure

The document is a monolithic wall of text with 15+ sections, many of which are boilerplate. Circular self-references ('See ## Features above for related details') add no value and create confusion. References to 'references/' directory and 'scripts/main.py' exist but no bundle files are provided, making them unverifiable. Content that could be separate (security checklist, risk assessment, lifecycle status) is inlined, bloating the main skill file.

1 / 3

Total

4

/

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.