CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

analyzing-insights-across-teams

Analyze PostHog insights, dashboards, or teams beyond the current project by querying the prod Postgres replicas synced into the dogfood data warehouse (US project 2, "PostHog App + Website"). Use when asked to analyze insights across all teams or projects, another team's insights, or fleet-wide insight/dashboard usage — cases where `system.insights` only returns the current project's rows and the agent would otherwise report the data as inaccessible. Covers the synced table names for US and EU and the column-verification workflow.

78

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent content: lean and dense with environment-specific knowledge the agent cannot infer, fully executable SQL with validation and failure paths built into the workflow, and a clean single-file structure with a required data-handling section. The read-only nature of the task means the permission-error stop path is the correct validation posture.

DimensionReasoningScore

Conciseness

Every section carries non-derivable, repo-specific knowledge (synced table names, underscore aliases, sync lag, output rules) with no explanation of concepts Claude already knows; directives like "Do not stop at `system.insights` when the question spans teams" earn their tokens. This matches anchor 5 (lean, every token earns its place); it is not 4 because there is no over-explanation to trim.

5 / 5

Actionability

Three copy-paste-ready SQL blocks (catalog check via system.information_schema, column verification, a full example aggregate query), exact table names for US and EU, explicit `team_id` grouping, join guidance, and the concrete tool name `posthog:execute-sql`. This matches anchor 5 (fully executable, covers the common cases); it is not 4 because no key detail or executable step is missing.

5 / 5

Workflow Clarity

A numbered workflow with a pre-flight validation step ("Confirm columns before projecting — synced schemas drift with the Django models"), explicit failure handling ("If a query fails with a permissions error, report it and stop — do not look for another route"), a catalog-check fallback before declaring data inaccessible, and a sync-lag caveat. This matches anchor 5 (clear sequence, explicit validation, error-recovery paths); it is not 4 because checkpoints and failure behavior are explicit rather than implied.

5 / 5

Progressive Disclosure

No bundle files exist and nothing that belongs in a separate file is inlined; sections are well-organized (Synced tables, Workflow, Output handling, Related) and the one cross-reference (querying-production-databases-via-metabase) is clearly signaled. Per the simple-skill scoring note, a self-contained well-organized SKILL.md matches anchor 5; it is not 4 because there is no organization gap or buried content.

5 / 5

Total

20

/

20

Passed

Description

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

A strong description: concrete third-person capability statement, an explicit and natural 'Use when' trigger clause covering team/project/fleet-wide variations, and a well-delimited niche. The only weakness is minor overlap risk with the closely related Metabase cross-team analytics skill, which the description does not explicitly boundary against.

DimensionReasoningScore

Specificity

"Analyze PostHog insights, dashboards, or teams beyond the current project by querying the prod Postgres replicas synced into the dogfood data warehouse" names concrete actions with their mechanism, and "Covers the synced table names for US and EU and the column-verification workflow" completes the coverage. It matches anchor 5 (multiple specific concrete actions, comprehensive coverage); it is not 4 because no capability is left as a generic hint.

5 / 5

Completeness

The what is explicit ("Analyze PostHog insights, dashboards, or teams... by querying the prod Postgres replicas") and the when is an explicit trigger clause ("Use when asked to analyze insights across all teams or projects, another team's insights, or fleet-wide insight/dashboard usage"). Both answered with concrete triggers matches anchor 5; the when is fully explicit, so 4 does not fit.

5 / 5

Trigger Term Quality

Natural user phrasings are all present: "analyze insights across all teams or projects", "another team's insights", "fleet-wide insight/dashboard usage", covering both region scopes. Comprehensive synonym coverage matches anchor 5; it is not 4 because no commonly used variation is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and delimited ("cases where `system.insights` only returns the current project's rows"), but a closely related sibling skill exists for cross-team analytics (querying-production-databases-via-metabase) and the description does not state the entity-metadata vs event-data boundary. That is anchor 4 (mostly distinct, minor overlap risk); not 5 because that boundary omission leaves a small chance of triggering the wrong skill.

4 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

PostHog/posthog

Path

.agents/skills/analyzing-insights-across-teams/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.