CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

meeting-transcript

Process meeting recordings and notes into structured decisions, action items, and team dynamics with intelligent noise filtering

Quality

71%

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

Quality

Content

63%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 well-structured instruction skill with genuinely concrete agent prompt specifications and templates, weakened by duplicated filtering content and a monolithic single-file layout with no progressive disclosure. The main gains would come from deduplicating the two filtering sections and splitting stable templates into reference files.

Suggestions

Merge "Content Filtering Guidelines" and "Content Filtering Protocol" into a single section — they describe the same filtering behavior twice (EXCLUDE/INCLUDE lists vs. a 4-step protocol).

Move the full Metadata Template and Content Structure spec into a references/ file (e.g. templates.md) and keep a short summary inline, enabling progressive disclosure for this 230-line body.

Replace the vague "Learning Integration" section with concrete tracking instructions or remove it — "adapt filtering based on user feedback" and "learn team communication preferences" have no mechanism specified.

Resolve or explain the [CUSTOMIZE: path/to/...] save-path placeholders, or point to where the user customizes them once at install time.

DimensionReasoningScore

Conciseness

The body is mostly efficient, instructional writing rather than explanation of known concepts, but it contains clear redundancy: "Content Filtering Guidelines" (EXCLUDE/INCLUDE lists) and "Content Filtering Protocol" (4 steps) cover substantially the same ground twice, and the vague "Learning Integration" section adds little concrete instruction. It fits the 3 anchor (mostly efficient, some content that could be tightened) better than the 2 anchor, since there is no padding in the sense of teaching Claude things it already knows.

3 / 5

Actionability

For an instruction-only skill the guidance is largely executable: each of the three agent prompts is a concrete, copy-paste-ready task specification with numbered steps and an explicit "Return:" contract, and the metadata template is a fill-in YAML block. It falls short of 5 because a few directives remain high-level ("Flag urgent action items for immediate attention", "Identify competitive intelligence if competitors mentioned") without specifying the mechanism, and save paths use unresolved [CUSTOMIZE: ...] placeholders.

4 / 5

Workflow Clarity

The orchestrator flow is clearly sequenced (Phase 1 setup → Phase 2 parallel agents with explicit single-message launch instruction → Phase 3 assembly), and the QA section plus the Content Filtering Protocol's accuracy-verification step function as validation checkpoints. It is not a 5 because there is no explicit error-recovery feedback loop (e.g. what to do when a spawned agent's output fails verification standards), only the general "flag for user confirmation" guidance — though the missing-validation cap does not apply since this is not a destructive or batch-write operation.

4 / 5

Progressive Disclosure

This is a single-file skill with no references/, scripts/, or assets/ directories; the body (~230 lines) has clear section headers but inlines everything, including the full metadata template, content-structure spec, and domain-specific processing details that could live in one-level-deep reference files. It matches the 3 anchor (some structure, content that should be separate is inline) better than the 4 anchor because the document is over the simple-skill line and no detail is offloaded, but it is far from the 1-2 anchors since headers make it fully navigable.

3 / 5

Total

14

/

20

Passed

Description

66%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 solidly specific description that clearly states what the skill does and outputs, but it omits any "when to use" trigger guidance, which caps its completeness. Adding an explicit "Use when..." clause and natural synonyms like "transcript" and "minutes" would bring it in line with the reference good examples.

Suggestions

Add an explicit 'when' clause, e.g. "Use when the user shares a meeting transcript, recording notes, or asks to extract action items or decisions from a meeting."

Include natural trigger synonyms users actually say — "meeting transcript", "meeting minutes", "summarize this meeting" — alongside the current wording.

Replace the buzzword-adjacent "intelligent noise filtering" with a more concrete phrase like "filtering out side chatter and technical interruptions".

DimensionReasoningScore

Specificity

The description names the domain ("meeting recordings and notes") and several concrete outputs ("structured decisions, action items, and team dynamics with intelligent noise filtering"). It falls just short of the 5 anchor because "intelligent noise filtering" is mildly buzzwordy and the individual processing steps (extraction, classification, summarization) are implied rather than enumerated — but it clearly exceeds the 3 anchor (only 1-2 concrete actions).

4 / 5

Completeness

The "what" is clear (process recordings/notes into decisions, action items, team dynamics), but there is no "Use when..." clause or equivalent trigger guidance — the rubric explicitly caps completeness at 3 in that case. It is not a 2 because the "what" half is specific and well-stated rather than vague.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "meeting recordings", "notes", "decisions", "action items". However, common variations like "transcript", "minutes", or "summarize this meeting" are absent from the description (ironic given the skill name is meeting-transcript), so it sits between the 3 anchor (missing common synonyms) and the 5 anchor (comprehensive synonym coverage).

4 / 5

Distinctiveness Conflict Risk

Meeting-transcript processing is a fairly clear niche with distinct triggers (decisions, action items, team dynamics) that is unlikely to fire for unrelated skills. Minor overlap risk remains with generic note-summarization or journaling skills, keeping it below the 5 anchor's "clear niche with minimal conflict risk".

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

huytieu/COG-second-brain

Path

.claude/skills/meeting-transcript/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.