SkillAgentSearch skills...

team-brief

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

Install / Use

npx skills add huytieu/COG-second-brain --skill team-brief

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Supported Platforms

Universal

Our assessment of team-brief

team-brief scores 86/100 on our quality scale, 280th of 394 Communication skills we index.

Its SKILL.md is 30 KB long, well organised into 48 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 1,216 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so team-brief is actively maintained.
  • Our last check on 2026-11-03 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

team-brief compared with similar skills

All 4 of these similar skills score higher than team-brief; compare them before choosing.

SkillScoreStarsUpdatedFormat
team-brief (this skill)by huytieu861.2k59d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

How do I install team-brief?
Run npx skills add huytieu/COG-second-brain --skill team-brief. The install tabs above show the steps for each supported agent.
Which AI agents does team-brief work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is team-brief safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is team-brief still maintained?
The repository was last updated about 2 months ago, so team-brief is actively maintained.

name: team-brief description: Generate daily team intelligence brief by cross-referencing GitHub, Linear, Slack, PostHog, meetings, and braindumps with two-way Linear sync-back roles: [product-manager, engineering-lead, founder] integrations: [github, linear, slack, posthog, hackmd]

COG Team Intelligence Brief Skill

When to Invoke

  • User says "team brief", "team update", "what did we ship", "standup prep"
  • User wants to know what the dev team is working on
  • User needs cross-referenced GitHub + Linear + Slack intelligence
  • Morning routine for product/engineering leads

Agent Mode Awareness

Check agent_mode in 00-inbox/MY-PROFILE.md frontmatter:

  • If agent_mode: team — use the full parallel agent execution strategy below (6 agents)
  • If agent_mode: solo — run data collection sequentially in the main conversation. Skip Phase 3.5 (Linear sync-back) and Phase 3.7 (HackMD publish) to keep it fast.

Purpose

Generate a concise daily team intelligence brief focused on what we're doing, what needs attention, and what's falling through the cracks. Cross-references Linear work tracking, Slack discussions, GitHub activity, PostHog product analytics, braindumps, and recent meetings to surface insights, flag mismatches, and keep the team aligned.

Monday = Week Start Brief: If today is Monday, the brief covers Friday through Sunday (the full weekend window). All date ranges, queries, and language should reflect "since Friday" / "over the weekend" instead of "yesterday." This captures anything that happened Friday afternoon, weekend deploys, or async discussions.

This is NOT an industry news report. News/market intelligence belongs in the weekly brief.

Command: /team-brief

Voice & Tone

You're not a reporting tool — you're a teammate who happens to have read every Slack thread, every PR, and every meeting note. Write like someone who genuinely cares about the team succeeding.

Do:

  • Be direct and opinionated. If something looks off, say it plainly.
  • Celebrate wins. When the team ships something great, acknowledge it.
  • Connect the dots. Don't just list facts — explain why they matter together.
  • Use natural language. "We shipped v1.2.0 with 11 PRs — solid day" not "11 PRs were merged across the reporting period."
  • Be concise but warm. Short sentences, clear thinking, no fluff.
  • Flag risks honestly. "This worries me" or "worth keeping an eye on" — not corporate hedging.
  • Show you understand the business context. Reference growth targets, customer feedback, strategy when relevant.

Don't:

  • Write like a project management dashboard. No "REPORT_GENERATED_AT" energy.
  • Be overly formal. No "It is recommended that the team consider..."
  • Add filler. If there's nothing to say, don't pad it.
  • Be passive. "The PR remains unreviewed" → "Nobody's reviewed this yet — it's been 3 days."
  • Use unnecessary labels or tags. Let the writing speak for itself.

Example tone:

Good day yesterday — we cut v1.2.0 with the new workflow, caching fix, and a bunch of UX polish. 11 PRs merged by 4 people. The team is shipping.

But we have a problem: two discovery calls in a row ended with the prospect unable to log in. The onboarding flow just doesn't work. We're building features for users who can't get through the front door.


Parallel Agent Team Execution Strategy

The daily brief MUST use parallel agents to maximize speed and efficiency.

When /daily-brief is invoked, the orchestrator (main agent) should:

Phase 1: Setup (Orchestrator — Sequential, Fast)

  1. Determine today's date and the lookback start date:
    • If today is Monday: lookback = last Friday (3 days ago). Set LOOKBACK_DATE to Friday's date. This is a Week Start Brief.
    • Any other day: lookback = yesterday. Set LOOKBACK_DATE to yesterday's date. This is a standard Daily Brief.
    • All dates in YYYY-MM-DD format.
  2. Check available integrations via ToolSearch ("slack"), ToolSearch ("linear"), and ToolSearch ("posthog")
  3. Check for meeting notes in [CUSTOMIZE: path/to/meetings/] matching dates from LOOKBACK_DATE through today
  4. Check for recent braindumps in [CUSTOMIZE: path/to/braindumps/] matching dates from LOOKBACK_DATE through today

Phase 2: Parallel Data Collection (Spawn 6 Agents Simultaneously)

Launch ALL of these agents in a single message using the Task tool with run_in_background: true:

Agent 1: "github-analyst" (subagent_type: general-purpose)

Prompt: see references/agent-prompts.md § github-analyst.

Agent 2: "slack-monitor" (subagent_type: general-purpose)

Only spawn if Slack MCP is available Prompt: see references/agent-prompts.md § slack-monitor.

Agent 3: "meeting-reviewer" (subagent_type: general-purpose)

Prompt: see references/agent-prompts.md § meeting-reviewer.

Agent 4: "linear-tracker" (subagent_type: general-purpose)

Only spawn if Linear MCP is available Prompt: see references/agent-prompts.md § linear-tracker.

Agent 5: "braindump-reviewer" (subagent_type: general-purpose)

Prompt: see references/agent-prompts.md § braindump-reviewer.

Agent 6: "posthog-analyst" (subagent_type: general-purpose)

Only spawn if PostHog MCP is available Prompt: see references/agent-prompts.md § posthog-analyst.

Phase 3: Assembly & Cross-Reference Synthesis (Orchestrator — After All Agents Complete)

This is the most critical phase. The orchestrator must:

  1. Collect results from all background agents using Read on their output files

  2. Cross-reference Linear ↔ GitHub (the core alignment check):

    • Match Linear issues to corresponding PRs/commits (by title, description, or explicit references)
    • Flag Linear issues marked "In Progress" with NO corresponding PR or commit (work claimed but not started in code)
    • Flag PRs that have NO corresponding Linear issue (untracked work — could be fine, just note it)
    • Flag Linear issues marked "Done" but PR still open or unmerged (status mismatch)
    • Note issues where Linear priority doesn't match PR urgency (e.g., Urgent in Linear but PR unreviewed for days)
  3. Cross-reference Slack ↔ GitHub ↔ Linear:

    • Match Slack discussion topics to related PRs/commits AND Linear issues
    • Combine related insights into unified items (e.g., "Credit system: [CUSTOMIZE: PROJ]-45 in progress + discussed in Slack 22 replies + PR #930 has CHANGES_REQUESTED")
    • Flag if Slack discussions mention work that has NO corresponding PR, commit, OR Linear issue
    • Flag if PRs exist that were NOT discussed in Slack (silent work — could be fine, just note it)
  4. Cross-reference Meetings ↔ GitHub ↔ Linear:

    • Check if action items from yesterday's meetings/standups have corresponding PRs, commits, OR Linear issues
    • Flag any discussed changes with NO GitHub or Linear activity
    • Note completed action items (discussed AND shipped AND tracked)
    • Check if meeting-assigned priorities match Linear priority settings
  5. Cross-reference Braindumps ↔ Current Work:

    • Connect strategic thinking from braindumps to active Linear issues and GitHub PRs
    • Surface braindump concerns that aren't reflected in any current tracked work
    • Flag if braindumps mention direction changes that contradict current sprint priorities
  6. Cross-reference Linear Cycle ↔ Overall Progress:

    • Report cycle health (% complete, days remaining, pace)
    • Flag if scope is creeping (new issues added mid-cycle)
    • Highlight blocked items that are holding up cycle completion
  7. Cross-reference Initiatives ↔ Projects ↔ Issues:

    • For each initiative, roll up project and issue data to compute real health:
      • Count completed vs total issues across all linked projects
      • Check if milestones are on track or overdue
      • Identify which projects are driving progress vs. stalled
    • Flag initiatives where computed health differs from reported health
    • Flag initiatives approaching target date with low completion %
  8. Cross-reference PostHog ↔ GitHub ↔ Slack:

    • Feature Releases ↔ Metrics: Correlate recently merged PRs with PostHog metric changes. Did a feature ship and usage go up? Or did it ship and nothing changed (adoption problem)?
    • Error Spikes ↔ Deployments: Match PostHog error spikes to recently merged PRs. If errors increased after a specific merge, flag it as a potential regression.
    • Slack Complaints ↔ PostHog Data: If Slack discussions mention user issues, check if PostHog error data or funnel drop-offs confirm the problem.
    • Metric Anomalies ↔ Known Changes: If visitors/sign-ups changed significantly, cross-reference with GitHub activity and Slack.
    • Feature Adoption ↔ Initiative Goals: Map PostHog feature usage data to Linear initiative KPIs. Flag gaps.
    • Activation Funnel ↔ Onboarding Work: If the funnel is leaking, check if any PRs or Linear issues address it. Flag the gap if nothing is being worked on.
  9. Generate the brief following the Content Structure below, with insights FIRST and details LAST. Use the Voice & Tone guidelines — write like a teammate, not a dashboard.

  10. Save to [CUSTOMIZE: path/to/briefs/]daily-brief-YYYY-MM-DD.md with proper metadata

  11. Present a concise summary to the user

Phase 3.5: Linear Sync-Back (Orchestrator — After Cross-Reference, Before Slack)

This phase writes data BACK to Linear to keep it up-to-date with reality from GitHub, Slack, and meetings.

Use ToolSearch to load the necessary Linear update tools: "+linear update issue", "+linear update initiative", "+linear update project", "+linear create comment", "+linear create attachment", "+linear save status update", "+linear update milestone".

Step 1: PR ↔ Issue Linkage

For each merged or open PR found in the GitHub data:

  1. Extract Linear issue references from PR title/body/branch (patterns: [CUSTOMIZE: PROJ]-123)
  2. For each matched Linear issue:
    • Use mcp__claude_ai_Linear__create_attachment to attach the PR URL to the issue (if not already linked). Use format:
      • url: https://github.com/[CUSTOMIZE: your-org/your-repo]/pull/XXX
      • title: "PR #XXX: [PR title]"
    • Check if the issue already has this PR attached (via get_issue attachments) — skip if already linked to avoid duplicates

Step 2: Issue Status Sync from GitHub

Based on the cross-reference data from Phase 3:

  1. PR merged → Issue still "In Progress": Use mcp__claude_ai_Linear__update_issue to transition the issue to "Done" state. Add a comment: "Automatically marked done — PR #XXX merged on [date]."
  2. PR opened → Issue still "Todo"/"Backlog": Use mcp__claude_ai_Linear__update_issue to transition to "In Progress". Add a comment: "Marked in progress — PR #XXX opened."
  3. PR has CHANGES_REQUESTED → Issue marked "In Review": Keep issue status, but add a comment noting the review feedback if not already commented.

Safety rules:

  • Only auto-transition issues where the PR-to-issue link is unambiguous (exact issue prefix match)
  • Never transition issues backward (e.g., don't move "Done" back to "In Progress")
  • If multiple PRs reference the same issue, only mark "Done" when ALL related PRs are merged
  • Log every status change made for the brief summary

Step 3: Initiative Status Updates

For each active initiative, compose and post a status update using mcp__claude_ai_Linear__save_status_update:

  1. Gather from the cross-reference:
    • What shipped since lookback (merged PRs mapped to this initiative's projects)
    • Current blockers across the initiative's projects
    • Cycle progress for the initiative's issues
    • Key Slack discussions relevant to this initiative
  2. Compose a concise status update (3-5 bullet points):
    **[DATE] Daily Update**
    • Shipped: [list key PRs/features merged]
    • In Progress: [key items being worked on]
    • Blocked: [any blockers, or "None"]
    • Health: [On Track / At Ri
    

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryCommunication
Updated1mo ago
Forks144

Languages

HTML

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions