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

44

Quality

47%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/team-brief/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 identifies a clear, distinctive capability with specific tool integrations, making it unlikely to conflict with other skills. However, it lacks an explicit 'Use when...' clause, which is critical for Claude to know when to select this skill, and could benefit from more natural trigger terms that users might actually say (e.g., 'standup summary', 'daily digest'). The single-action focus limits its specificity score.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks for a daily standup summary, team status update, daily digest, or cross-tool intelligence brief.'

Include natural trigger term variations users might say, such as 'standup', 'status update', 'daily summary', 'team digest', 'what happened today', or 'cross-team update'.

Consider listing additional concrete actions beyond generating the brief, such as 'identifies blockers, surfaces key decisions, highlights PRs needing review, and syncs action items back to Linear'.

DimensionReasoningScore

Specificity

It names a specific action ('Generate daily team intelligence brief') and lists specific data sources (GitHub, Linear, Slack, PostHog, meetings, braindumps) plus mentions 'two-way Linear sync-back', but it doesn't enumerate multiple distinct concrete actions beyond generating the brief and syncing back.

2 / 3

Completeness

The description answers 'what does this do' reasonably well but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'daily', 'team intelligence brief', 'GitHub', 'Linear', 'Slack', 'PostHog', 'meetings', 'braindumps', and 'sync-back', which are somewhat natural but quite specific/niche. Missing common variations a user might say like 'standup', 'status update', 'team summary', 'daily digest', or 'cross-team visibility'.

2 / 3

Distinctiveness Conflict Risk

This is a very specific niche — generating a daily intelligence brief by cross-referencing multiple named tools with Linear sync-back. It is highly unlikely to conflict with other skills due to its unique combination of data sources and specific output format.

3 / 3

Total

8

/

12

Passed

Implementation

55%

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

This skill is impressively thorough and highly actionable — every agent has executable commands, specific tool names, and concrete query patterns. The workflow is well-sequenced with proper safety checks and validation steps. However, it is massively over-engineered as a single file: at 700+ lines with 6 full agent prompt templates, 23 cross-referencing rules, extensive Slack templates, and detailed metadata schemas all inline, it would consume a huge portion of the context window. This content desperately needs to be split across multiple files with SKILL.md serving as an overview.

Suggestions

Split agent prompts into separate files (e.g., agents/github-analyst.md, agents/linear-tracker.md) and reference them from SKILL.md — each agent prompt is 30-60 lines that only needs to be loaded when executing

Move the 23 cross-referencing rules and synthesis logic into a separate CROSS-REFERENCE-RULES.md file, keeping only a 2-3 line summary in the main skill

Move Slack message templates into a separate SLACK-TEMPLATES.md file — they're reference material, not core workflow

Trim explanatory prose throughout — e.g., the Voice & Tone section's 'Don't' examples and the Purpose section's 'This is NOT an industry news report' are unnecessary context for Claude; reduce to bullet-point rules only

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~700+ lines. It over-explains every detail of every agent's queries, includes full Slack message templates for both Monday and regular days, exhaustive cross-referencing rules (23 numbered rules), priority ordering lists, and extensive metadata templates. Much of this could be condensed or split into reference files. Claude doesn't need explanations of what cross-referencing means or why it matters — it needs the rules.

1 / 3

Actionability

The skill provides highly concrete, executable guidance: specific gh CLI commands with exact flags and JSON output formats, specific MCP tool names (mcp__claude_ai_Linear__list_issues), exact HogQL queries, curl commands for HackMD API, specific file paths and glob patterns, and detailed Slack message templates with formatting. Nearly everything is copy-paste ready with only [CUSTOMIZE] placeholders needing replacement.

3 / 3

Workflow Clarity

The multi-phase workflow is clearly sequenced (Phase 1 → 2 → 3 → 3.5 → 3.7 → 4) with explicit validation and safety rules throughout. Phase 3.5 includes safety rules for status transitions (never transition backward, check for duplicates before creating attachments), error handling is explicit per phase, and there are feedback loops (user confirms Slack message before posting, validate before sync-back). The Phase 4 preview-before-posting pattern is a good checkpoint.

3 / 3

Progressive Disclosure

This is a monolithic wall of text with no bundle files and no references to external files for detailed content. The 23 cross-referencing rules, 6 full agent prompts, Slack message templates, metadata templates, and synthesis rules are all inline. The agent prompts alone could each be separate files. With no bundle files provided, all content is crammed into a single massive SKILL.md that would consume enormous context window space.

1 / 3

Total

8

/

12

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

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.