CtrlK
BlogDocsLog inGet started
Tessl Logo

team-brief

Generate daily team intelligence brief by cross-referencing GitHub, Linear, Slack, PostHog, meetings, and braindumps with two-way Linear sync-back

60

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and clearly sequenced with validation checkpoints for its destructive operations. Its weaknesses are verbosity from duplicated cross-reference logic and a monolithic single-file structure that would benefit from splitting agent prompts and templates into reference files.

Suggestions

Consolidate the duplicated cross-referencing logic: Phase 3's eight cross-reference steps and the 23-rule 'Synthesis Rules' overlap heavily — merge into a single authoritative section to cut length.

Move the six per-agent prompt blocks, the Slack message templates, and the metadata template into separate reference files under references/ and link to them from the main body to enable true progressive disclosure.

Trim the large metadata template and Slack templates to the essential fields a user must fill, keeping the [CUSTOMIZE] placeholders but reducing boilerplate.

DimensionReasoningScore

Conciseness

The body is mostly efficient operational detail (specific commands, queries, rules), but at ~890 lines it carries clear redundancy — Phase 3's eight cross-reference steps overlap heavily with the 23-rule 'Synthesis Rules / Cross-Referencing Logic', and the Slack templates and metadata template are long. It is not a 1 because it does not explain concepts Claude already knows; it is not a 3 because the length and duplicated cross-reference logic could be tightened considerably.

2 / 3

Actionability

The skill provides fully executable guidance: concrete 'gh' CLI commands, HogQL queries, named Linear MCP tools (e.g. mcp__claude_ai_Linear__list_issues), and copy-paste HackMD curl/Python snippets with [CUSTOMIZE] placeholders. It is not a 2 because the examples are real commands, not pseudocode or abstract descriptions.

3 / 3

Workflow Clarity

The work is sequenced into explicit phases (1, 2, 3, 3.5, 3.7, 4) with timing estimates, and the destructive Linear sync-back and Slack posting have validation checkpoints: safety rules ('only auto-transition where the link is unambiguous', 'never transition backward'), duplicate-prevention checks, and a human-in-the-loop confirmation gate before posting. It is not a 2 because validation/verification for the destructive batch operations is present rather than missing.

3 / 3

Progressive Disclosure

The body is well-organized into clear headed sections, but it is a single monolithic ~890-line file with no bundle files, so content that should be split out (the six agent prompts, Slack message templates, metadata template) is all inline. It is not a 1 because organization is good with clear navigation headers; it is not a 3 because there is no file-level progressive disclosure and the skill far exceeds the under-50-line simple-skill exception.

2 / 3

Total

10

/

12

Passed

Description

67%

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 specific and highly distinctive, clearly stating what the skill does and naming its concrete data sources. Its main weakness is the missing explicit 'Use when...' trigger guidance and the absence of natural conversational trigger phrasing in the description itself.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for a team brief, standup prep, a daily team update, or wants to know what the team shipped.'

Include natural phrasings a user would actually say ('team brief', 'what did we ship', 'standup prep') directly in the description rather than only in the body.

DimensionReasoningScore

Specificity

Lists multiple concrete actions and data sources: 'Generate daily team intelligence brief by cross-referencing GitHub, Linear, Slack, PostHog, meetings, and braindumps with two-way Linear sync-back' — 'Generate', 'cross-referencing', and 'sync-back' are distinct concrete verbs, matching the 'lists multiple specific concrete actions' anchor. It is not a 2 because it goes well beyond naming a single domain/action.

3 / 3

Completeness

It clearly answers what the skill does but contains no 'Use when...' clause or equivalent explicit trigger guidance, so per the rubric completeness is capped at 2. It is not a 1 because the 'what' is explicit and specific; it is not a 3 because 'when' is absent (only implied by 'daily').

2 / 3

Trigger Term Quality

The description surfaces source tool names (GitHub, Linear, Slack, PostHog) a user might say, but the natural conversational triggers ('team brief', 'standup prep', 'what did we ship') appear only in the body, and 'team intelligence brief' reads as product jargon rather than a phrase a user naturally utters. It is not a 3 because common natural-language variations are missing from the description itself.

2 / 3

Distinctiveness Conflict Risk

The combination of a daily team intelligence brief cross-referencing six named sources plus two-way Linear sync-back is a distinct niche unlikely to trigger for unrelated skills. It is not a 2 because the named integrations and sync-back behavior make overlap with similar skills unlikely.

3 / 3

Total

10

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (893 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
huytieu/COG-second-brain
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.