CtrlK
BlogDocsLog inGet started
Tessl Logo

meeting-brief

Daily meeting preparation system that checks your calendar each morning, deeply researches external attendees (LinkedIn, company info, GitHub, past notes), and sends you personalized briefs via email (1 per person). Use when you want automated preparation for upcoming meetings with context about each person you're meeting.

64

Quality

80%

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

Quality

Content

67%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 well-structured and largely actionable, with a clearly sequenced workflow mapped to real scripts and meaningful validation for the batch-send operation. Its weaknesses are redundancy across three overlapping workflow descriptions, a broken script reference (send_brief.sh vs. send_slack.sh), and an undocumented bundle script (format_for_slack.sh).

Suggestions

Collapse 'What It Does', 'How It Works', and 'Research Process' into a single workflow section — they describe the same pipeline three times and account for most of the excess tokens.

Fix the Manual Usage example to reference the real script (scripts/send_slack.sh with its actual arguments '<person_name> <brief_text_file> <webhook_url>') and document or remove the unreferenced format_for_slack.sh.

Move the example brief and the research-output JSON schema into a references/ file (e.g. references/brief-format.md), keeping only a short inline sample in SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly information-dense (config keys, commands, JSON schemas), but the same workflow is described three times — 'What It Does' (steps 1-6), 'How It Works / Main Workflow' (steps 1-7), and 'Research Process' — which is unnecessary duplication, and the 30-line example brief plus the Privacy & Security section pad further. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); not 2 because most sections carry concrete, non-redundant content.

3 / 5

Actionability

Guidance is mostly executable: './scripts/run_daily.sh', 'node scripts/research_person.js "Jane Doe" "jane@example.com" "Example Corp"', 'gcalcli agenda today tomorrow', and a complete config.json block. Not 5 because the Manual Usage section invokes './scripts/send_brief.sh brief.html "Jane Doe"' — a script that does not exist in the bundle (the actual file is send_slack.sh with a different argument order) — and 'research_output.json meeting_context.json' are referenced without showing how to produce them.

4 / 5

Workflow Clarity

The 7-step main workflow is clearly numbered with each step mapped to a specific script, and the batch-send risk (1 email per person) is covered by checkpoints: DRY_RUN preview, data/sent duplicate tracking, logs/run.log, and a Troubleshooting section keyed to failure modes. This matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'); not 5 because validation (dry-run, sent-log check) lives in Tips/Troubleshooting rather than being explicit checkpoints inside the step sequence itself, and not 3 because feedback paths for the batch operation are genuinely present.

4 / 5

Progressive Disclosure

Structure is good: well-labeled sections, all six bundle scripts live one level deep in scripts/ and most are clearly referenced from the workflow steps, matching the 'good structure; references mostly clear; minor organization gaps' anchor. Not 5 because of real bundle-structure mismatches: send_brief.sh is referenced but doesn't exist, format_for_slack.sh exists but is never mentioned, and the example brief and research-output JSON schema (~70 lines combined) are inlined where a references/ file could carry them.

4 / 5

Total

15

/

20

Passed

Description

82%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 concrete capabilities, an explicit and situation-specific 'Use when' trigger, and a distinct niche. Its main weaknesses are the second-person voice (which the rubric penalizes on specificity) and slightly incomplete capability coverage (Slack delivery and research-depth options are not mentioned).

Suggestions

Rewrite in third person to avoid the voice penalty: 'Checks the calendar each morning, researches external attendees, and sends personalized briefs via email' instead of 'checks your calendar... sends you'.

Mention the Slack output channel (and configurable research depth) so the capability list covers all delivery modes a user might ask about.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'checks your calendar each morning', 'deeply researches external attendees (LinkedIn, company info, GitHub, past notes)', 'sends you personalized briefs via email (1 per person)' — which matches anchor 4 ('lists several specific actions; minor gaps', e.g. Slack delivery is omitted). However, the voice guideline penalizes second-person phrasing ('checks your calendar', 'sends you personalized briefs', 'you want') by reducing the specificity score by 1, bringing it to 3.

3 / 5

Completeness

It explicitly answers both questions: the 'what' is concrete ('checks your calendar... researches external attendees... sends you personalized briefs via email') and the 'when' is an explicit trigger clause ('Use when you want automated preparation for upcoming meetings with context about each person you're meeting'), matching anchor 5. Not 4 because the 'when' clause is specific about the situation rather than the generic 'Use when working with PDF files' pattern.

5 / 5

Trigger Term Quality

Natural keywords are well covered: 'meeting', 'calendar', 'attendees', 'briefs', 'preparation', 'upcoming meetings' — terms a user would plausibly say. A few natural variations are missing ('meeting prep', 'who am I meeting', 'meeting notes/research'), matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The combination of morning calendar checks, external-attendee research, and per-person email briefs is a clear niche with distinct triggers ('meeting preparation', 'briefs', 'attendees'), so it is unlikely to fire for unrelated skills — anchor 5. Not 4 because the 'Use when' clause is tightly scoped to upcoming-meeting preparation, minimizing overlap even with generic research or calendar skills.

5 / 5

Total

17

/

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
gooseworks-ai/goose-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.