CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

briefing

Compile daily briefing with meeting context, active deals, and citation tracking

Quality

73%

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

Quality

Content

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

This is a strong, highly actionable instruction skill: exact commands with flags, a fixed output template, and an unusually good failure-handling section. Its main weaknesses are redundancy (citation, read-only, and meeting-loading rules each stated multiple times) and a structural overlap between the Phases and GBrain-Native Context Loading sections that muddies execution order.

Suggestions

Deduplicate the citation, read-only, and gap-flagging rules: state each once in the Contract and reference it from Anti-Patterns instead of restating it.

Merge Phases step 1 with the 'Before a meeting' subsection so there is a single participant-resolution procedure, and remove or relocate the out-of-scope 'Before an email reply' section.

Clarify execution order by placing 'GBrain-Native Context Loading' before the Phases section (or explicitly numbering it within the workflow) since it claims to run 'before generating any briefing'.

DimensionReasoningScore

Conciseness

The body is skill-specific with no padding about concepts Claude already knows, but it repeats itself: the citation rule appears in the Contract ('Every fact... includes an inline [Source: slug, updated DATE] citation'), again in 'Citation in Briefings', and again in Anti-Patterns; the read-only rule is stated in the Contract, Anti-Patterns, and Back-Linking sections; and meeting-context loading is covered twice (Phases step 1 vs. 'GBrain-Native Context Loading'). The 'Before an email reply' subsection is out of scope for a briefing skill. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 4 anchor, where only minor trimming would be needed.

3 / 5

Actionability

The guidance is fully executable with copy-paste-ready commands and exact flags ('gbrain salience --days 7', 'gbrain recall --since-last-run --supersessions --pending --rollup --json', 'gbrain whois <email> --json', 'gbrain waiting --json') plus concrete query strings and a complete output format template. Specific examples cover the common cases (meeting prep, deals, open loops, people in play), matching the 'fully executable, copy-paste ready, covers common cases' anchor.

5 / 5

Workflow Clarity

The sequence is clear (pre-briefing pulls 0a-0e, then six phases, then a fixed output format) and the 'When it fails' section provides genuine error-recovery feedback loops (retry after named sync, degrade notices, ship partial briefing and name the missing section), with the exact-match identity rule acting as a validation checkpoint. It falls short of 5 because ordering is ambiguous: 'GBrain-Native Context Loading' says 'Before generating any briefing' yet appears after the Phases section, which already gives its own, weaker participant-search steps ('Search gbrain for each participant by name'), leaving it unclear which procedure governs.

4 / 5

Progressive Disclosure

Good single-file structure with clear sections and well-signaled, one-level-deep references to external rule files ('skills/_brain-filing-rules.md', '../conventions/brain-first.md#identity-exact-match', '../conventions/agent-operator-protocol.md', 'skills/google-loops/SKILL.md'); no bundle directories (references/, scripts/, assets/) exist, so everything lives in SKILL.md. It is not a 5 because at ~200 lines some content (the detailed gbrain command reference and failure-mode handling) could be split out, and the referenced external files cannot be verified within this bundle.

4 / 5

Total

16

/

20

Passed

Description

61%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 is concise and names a clear, fairly distinct niche, but it reads as a title-plus-topics rather than a capability statement with invocation guidance. It has one concrete action verb and no 'Use when' trigger clause, which limits specificity and completeness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for a daily/morning briefing, a catch-up on today's meetings and deals, or says what's happening today'.

Expand the action list beyond the single verb 'Compile' — e.g. 'Compiles daily briefings: resolves meeting participants against the brain, summarizes active deals with deadlines, flags stale pages, and cites every fact to its source page'.

Include natural trigger synonyms (morning briefing, daily digest, catch-up) in the description itself rather than only in the separate triggers field.

DimensionReasoningScore

Specificity

The description names the domain ("daily briefing") and scope components ("meeting context, active deals, and citation tracking"), but uses a single action verb ("Compile"), listing content areas rather than several distinct concrete actions. It sits at the 'names domain and 1-2 concrete actions' level, below the 'lists several specific actions' anchor which would require multiple distinct verbs/operations.

3 / 5

Completeness

The 'what' is clear ("Compile daily briefing with meeting context, active deals, and citation tracking"), but the description contains no 'Use when...' clause or equivalent explicit trigger guidance — 'daily' only weakly implies when to invoke it. Per the judging guideline, a missing 'Use when' clause caps completeness at 3; it is not a 4 because the 'when' is not present even implicitly beyond the word 'daily'.

3 / 5

Trigger Term Quality

"daily briefing" is the core natural phrase a user would say, reinforced by relevant topical keywords ("meeting context", "active deals", "citation tracking"). This is good keyword coverage rather than 'some relevant keywords' (the 3 anchor's example has only one keyword), though natural variations like 'morning briefing', 'daily digest', or 'catch-up' are missing from the description itself.

4 / 5

Distinctiveness Conflict Risk

"Compile daily briefing with meeting context, active deals, and citation tracking" carves a fairly clear niche (operational briefing compilation with deal tracking and citations) with distinct terminology. It is 'mostly distinct' rather than a 5 because a daily-briefing skill could still overlap with generic 'summarize my day / catch me up' style skills.

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

relative_links

Relative link issues: 3 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

skills/briefing/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.