Generate daily team intelligence brief by cross-referencing GitHub, Linear, Slack, PostHog, meetings, and braindumps with two-way Linear sync-back
44
47%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Risky
Do not use without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/team-brief/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
034af4c
Table of Contents
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.