CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

meeting-minutes-generator

Generates structured meeting minutes from text transcripts. Use when the user provides text content and wants a structured summary with a signature.

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Other/meeting-minutes-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%Weight 40%Scale 1-5

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

The core workflow (inputs, processing steps, output template, fallback behaviors) is solid and clearly sequenced, but it is buried in a large amount of auto-generated boilerplate that adds no value, and the packaged prompt template in references/prompts.md is never actually referenced. The skill would be substantially improved by cutting the filler and wiring up the reference file.

Suggestions

Delete the generic template sections (When to Use, Key Features, Dependencies, Example Usage, Implementation Details, Quick Validation) — they are boilerplate that consumes tokens without task-specific value.

Replace the vague "Reference material available in `references/`" with an explicit link and purpose statement for references/prompts.md, e.g., "Use the prompt template in [prompts.md](references/prompts.md) for generation".

Add a short worked example (a few lines of sample transcript and the resulting minutes) so the output format and extraction rules are demonstrated rather than only described.

DimensionReasoningScore

Conciseness

Over half the body is generic template boilerplate ("Use this skill when the request matches its documented task boundary", "Prefer this skill for repeatable, checklist-driven execution"), a filler Example Usage directory listing, and an Implementation Details section pointing to a Workflow section that appears later in the file. This is noticeably verbose with several padded sections, though it stops short of explaining concepts Claude already knows.

2 / 5

Actionability

The core Inputs/Workflow/Output Format sections give concrete guidance including an explicit output template and fallback values ("Not specified", "None identified"), but there is no worked example, the packaged prompt template references/prompts.md is never named, and surrounding sections offer only vague direction like "keep results reproducible". This falls between anchors 3 and 4, closer to incomplete-with-concrete-elements.

3 / 5

Workflow Clarity

The Input Analysis → Processing → Generation sequence is clearly ordered with an explicit validation step ("Validate transcript text exists and is readable") and defined edge-case behaviors, fitting anchor 4's clear sequence with most checkpoints present. Not being a destructive or batch operation, the missing feedback-loop cap does not apply; score 5 is unwarranted since there is no error-recovery loop.

4 / 5

Progressive Disclosure

The bundle provides references/prompts.md containing the actual generation prompt, but the body only says "Reference material available in `references/`" without naming or linking the file, leaving the most useful bundled content undiscoverable. References are present but not clearly signaled, matching anchor 3.

3 / 5

Total

12

/

20

Passed

Description

62%Weight 40%Scale 1-5

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 states what the skill does and includes an explicit 'Use when...' clause, but the trigger conditions are generic and lack common synonyms like 'meeting notes'. It is serviceable but sits in the middle of the quality range rather than exemplifying best practice.

Suggestions

List the concrete deliverable components (participants, decisions, action items, next steps) in the description to raise specificity.

Add natural trigger variations such as 'meeting notes', 'meeting recap', or 'summarize a meeting' to improve trigger-term coverage.

Sharpen the when-clause to reference situations specific to this skill (e.g., 'Use when the user provides a meeting transcript and asks for minutes or a structured summary') to reduce overlap with generic summarization skills.

DimensionReasoningScore

Specificity

"Generates structured meeting minutes from text transcripts" names the domain and one concrete action, but does not enumerate the specific sub-outputs (participants, decisions, action items) that the skill actually produces, so coverage is not comprehensive as anchor 4 requires.

3 / 5

Completeness

Both what ("Generates structured meeting minutes from text transcripts") and when ("Use when the user provides text content and wants a structured summary") are explicitly present, but the when-clause is generic rather than listing concrete trigger phrases, fitting anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Natural keywords like "meeting minutes", "transcripts", and "structured summary" are present, but common user variations such as "meeting notes", "meeting recap", or "summarize a meeting" are missing, matching the anchor for some relevant keywords with missing synonyms.

3 / 5

Distinctiveness Conflict Risk

Meeting-minutes generation is a mostly distinct niche, but the trigger "wants a structured summary" creates minor overlap with general summarization skills, fitting anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Other/meeting-minutes-generator/SKILL.md

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.