CtrlK
BlogDocsLog inGet started
Tessl Logo

meeting-recorder-assistant

Intelligent meeting recording and transcription assistant with automated minutes generation, action item extraction, and sentiment analysis. Supports audio transcription, speaker diarization, meeting summarization, and task extraction. Use when users need to record meetings, transcribe audio, generate meeting minutes, extract action items, or analyze meeting content.

66

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/meeting-recorder-assistant/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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.

A compact, actionable body with executable code examples that match the real bundle scripts. The main weakness is workflow clarity: the multi-step pipeline is implicit, the transcript handoff between recording and minutes generation is missing, and no validation checkpoints are provided.

Suggestions

Add a short 'Workflow' section that sequences the full pipeline explicitly (record → transcribe/save transcript → generate minutes → extract actions), including the step that writes /tmp/transcript.json so the minutes example's input path actually exists.

Add a validation checkpoint between steps, e.g., check that the transcript file exists and is non-empty before calling generate_minutes, and verify minutes['action_items'] is populated before exporting.

Either drop the 'Features' bullet list (it restates the description) or fold in the unsurfaced script capabilities — output_format options for minutes and export_actions_to_json / format_actions_as_markdown — so the 'Output Formats' section links to concrete usage.

DimensionReasoningScore

Conciseness

The body is efficient — short sections, tight code examples, no explanations of concepts Claude already knows. It is not the 5 anchor because the 'Features' bullet list largely restates the frontmatter description and comments like '# Initialize recorder' and '# Extract tasks from transcript' narrate what the code already says.

4 / 5

Actionability

The three code examples are executable and match the actual bundle script APIs (MeetingRecorder.start_recording/stop_and_transcribe, generate_minutes, extract_actions). It stops short of the 5 anchor because the examples do not fully connect: the recorder example never saves '/tmp/transcript.json', yet the minutes example reads from that path, leaving a gap in the common end-to-end case.

4 / 5

Workflow Clarity

The overall pipeline (record → transcribe → generate minutes → extract actions) is only implied by section order; there is no explicit sequence, no guidance on the transcript handoff between steps, and no validation checkpoints (e.g., confirming the transcript file exists before generating minutes). This matches the 'sequence present but checkpoints missing or implicit' anchor rather than the 4 anchor, which requires most checkpoints present.

3 / 5

Progressive Disclosure

The body is well organized with clear sections and its references are real: `from scripts.meeting_recorder import ...`, `scripts.meeting_minutes`, and `scripts.action_extractor` all resolve to actual files in the bundle, one level deep. It falls short of 5 because the scripts expose capabilities not surfaced in the overview (e.g., generate_minutes' output_format parameter, export_actions_to_json, format_actions_as_markdown), so the 'Output Formats' section is not navigable to concrete usage.

4 / 5

Total

15

/

20

Passed

Description

88%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.

A strong description with explicit, concrete capability statements and a well-formed 'Use when...' trigger clause. The main gaps are missing synonyms/file extensions in the trigger terms and a slightly generic 'transcribe audio' trigger that could overlap with a general transcription skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'automated minutes generation, action item extraction, and sentiment analysis', 'audio transcription, speaker diarization, meeting summarization, and task extraction' — giving comprehensive coverage of what the skill does, matching the top anchor. It is not the 4 anchor because there are no notable gaps in capability coverage.

5 / 5

Completeness

It clearly answers 'what' (recording, transcription, minutes, action items, sentiment) and explicitly answers 'when' with a concrete 'Use when users need to...' clause enumerating five trigger scenarios, mirroring the top anchor. A missing 'Use when...' clause would cap it at 3, but it is present and specific.

5 / 5

Trigger Term Quality

'Use when users need to record meetings, transcribe audio, generate meeting minutes, extract action items, or analyze meeting content' provides good natural-phrase coverage. It falls short of the 5 anchor because it omits common synonyms and file extensions users would naturally say (e.g., 'meeting notes', '.wav', '.mp3', 'take notes in a meeting').

4 / 5

Distinctiveness Conflict Risk

The meeting domain is a clear niche with distinct triggers ('record meetings', 'generate meeting minutes'), but the generic trigger 'transcribe audio' creates minor overlap risk with a general audio-transcription skill, matching the 'mostly distinct; minor overlap risk' anchor rather than the minimal-conflict 5 anchor.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
OpenBMB/PilotDeck
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.