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

59%

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

Quality

Content

43%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 body is a redirect stub: it is token-lean but delegates 100% of the skill's substance to external files that are not shipped in the bundle, leaving nothing executable, no task workflow, and no in-bundle references to navigate. The skill would fail at its stated purpose if the external paths are unavailable.

Suggestions

Inline the core workflow (or move it into bundled references/ files) so the skill contains the actual meeting-processing steps — how to extract decisions, action items, and team dynamics from a transcript — instead of pointing to `.claude/skills/meeting-transcript/SKILL.md`.

Bundle `.agents/rules/cog.md` and the agent worker definitions under the skill's own directory (e.g. references/ or scripts/) and reference them with relative links so the one-level-deep disclosure pattern actually holds.

Add a sequenced workflow with at least one validation checkpoint (e.g. verify extracted action items against the transcript before presenting) to raise workflow clarity.

DimensionReasoningScore

Conciseness

The body is minimal — two short paragraphs with zero padding, no over-explanation of concepts Claude already knows, and no filler. Every token present is instruction, matching 'Lean and efficient; assumes Claude's competence; every token earns its place'. The problem is not verbosity but absence of content, which is scored by other dimensions.

5 / 5

Actionability

The body gives only pointer instructions — 'Read `.claude/skills/meeting-transcript/SKILL.md` and execute it exactly as written' and 'Then follow `.agents/rules/cog.md`' — with no concrete steps for actually processing meeting recordings (no extraction steps, output formats, or examples), and the referenced files are not part of this skill's bundle. This matches 'Minimal concrete guidance; high-level hints but missing the specific steps to execute'; it is not level 1 only because the pointers are at least specific, resolvable-style commands rather than purely abstract description.

2 / 5

Workflow Clarity

There is a rough meta-sequence — read the external playbook, then follow the rules file, with a worker-substitution rule — but no sequenced workflow for the actual meeting-processing task and no validation checkpoints at all. This fits 'Rough sequence present but many gaps; steps poorly defined; validation absent' rather than level 1, since the ordering of the two instructions is coherent.

2 / 5

Progressive Disclosure

The SKILL.md body contains no actual content — everything lives in external files (`.claude/skills/meeting-transcript/SKILL.md`, `.agents/rules/cog.md`, and `.agents/agents/<name>.md`), none of which exist in this skill's bundle (no references/, scripts/, or assets/ directories). This mirrors the bad example of chained indirection where the real instructions are always one file away, matching 'deeply nested references (2+ levels); impossible to navigate'.

1 / 5

Total

10

/

20

Passed

Description

53%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 communicates a clear 'what' with a distinct meeting-processing niche, but it is capped by the absence of any 'Use when...' trigger clause and missing common synonyms like 'transcript' or 'minutes'. Adding explicit trigger guidance and a second concrete action would lift it from adequate to strong.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user shares meeting transcripts, recordings, or notes, or asks for action items, minutes, or meeting summaries.'

Include common synonyms users actually say — 'transcripts', 'minutes', 'summarize the meeting' — to broaden natural trigger coverage.

Replace the vague 'intelligent noise filtering' with a concrete action like 'filters small talk and off-topic chatter' to raise specificity.

DimensionReasoningScore

Specificity

The description names one concrete transformation verb — 'Process meeting recordings and notes into structured decisions, action items, and team dynamics' — with a few concrete outputs, but coverage is not comprehensive and 'intelligent noise filtering' is vague padding. It lists a single action with deliverables rather than several distinct actions, matching 'Names domain and 1-2 concrete actions, but not comprehensive' better than the level-4 anchor's multiple distinct actions.

3 / 5

Completeness

The 'what' is clear — processing meeting recordings and notes into structured outputs — but there is no 'Use when...' or equivalent trigger clause, capping completeness at 3 per the judging guidelines. It matches 'Has a clear what but when is missing or only weakly implied' and cannot reach 4 without explicit 'when' guidance.

3 / 5

Trigger Term Quality

'meeting recordings', 'notes', 'decisions', 'action items' are natural phrases users would say, but common synonyms like 'transcript', 'minutes', 'meeting summary', or 'summarize the meeting' are missing. This fits 'Some relevant keywords but missing common variations or synonyms' rather than level 4's 'a few natural terms missing' since multiple high-frequency variations are absent.

3 / 5

Distinctiveness Conflict Risk

The meeting-transcript niche is fairly distinct ('meeting recordings and notes into structured decisions, action items') with only minor overlap risk against general summarization or note-taking skills. It falls short of the level-5 anchor because there are no explicit distinct trigger phrases to fully disambiguate it from related summarization skills.

4 / 5

Total

13

/

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

huytieu/COG-second-brain

Path

.agents/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.