Doctor report: request

[conikeec]

Public GitHub skill URL

https://github.com/PostHog/skills

Notes

Submitted from the public SkillSpec Doctor page.

[github-actions]

SkillSpec Doctor report

Target: github.com/PostHog/skills

Shape: plugin_workspace - plugin-shaped workspace with 8 plugin namespace(s); preserve namespaces before import

Status: workspace

Remote: github.com/PostHog/skills.git

What This Measures

Doctor estimates how likely an agent is to miss, reorder, improvise, use the wrong surface, or finish without proof because of the current skill shape.

Assessment scope: plugin workspace plus full per-package raw skill profiles; plugin namespace and skill path remain part of identity

Risk interpretation: Plugin workspace risk is the maximum of plugin-shape risk and per-package raw skill risk. Preserve plugin namespace/path identity and inspect package drift rows before import, compile, or install.

This is a baseline of the current skill shape at doctor time. It is not a grade of domain knowledge, human usefulness, author effort, or legal/medical correctness.

Higher risk means a higher chance the agent skips, reorders, or improvises load-bearing instructions.

Current Skill Baseline

• Verdict: workspace risk: critical
• Follow-through readiness: very low
• Agent follow-through risk: critical (100/100, workspace aggregate)
• Package risk rollup: max critical (100/100) at skills/omnibus/analyzing-experiment-session-replays/SKILL.md; critical=249, high=5, medium=0, low=0

Shape Contract

• Kind: plugin_workspace
• Kind handling: plugin-shaped workspace; preserve plugin parent, namespace, shared files, and skills/ folder shape
• Analysis status: workspace
• Skill files: 254
• Packages: 254
• Namespaces: 1
• Plugin roots: 8

Plugin Root Details

• plugin at `` with 254 skill file(s)
• all at skills/posthog/all with 79 skill file(s)
• error-tracking at skills/posthog/error-tracking with 16 skill file(s)
• feature-flags at skills/posthog/feature-flags with 18 skill file(s)
• integration at skills/posthog/integration with 33 skill file(s)
• llm-analytics at skills/posthog/llm-analytics with 2 skill file(s)
• logs at skills/posthog/logs with 8 skill file(s)
• tools-and-features at skills/posthog/tools-and-features with 1 skill file(s)

Next command

skillspec workspace map github.com/PostHog/skills --out <build-dir>/skillspec.workspace.yml

Surface

• Activation body: 29108 line(s), 0 byte(s), approximately 401833 token(s)
• Deferred resources: 254 file(s), 0 byte(s)
• Frontmatter: 0 line(s), 0 byte(s)
• Activation-loaded surface: 0%
• Unmapped package files: 0
• Instruction signals: 0 modal obligation(s), 0 late obligation(s), 0 numbered step(s), 0 dependency mention(s)
• Code in active skill: 0 block(s), 0 unlabeled

Shape Details

Plugin Roots

• plugin at `` with 254 skill file(s)
• all at skills/posthog/all with 79 skill file(s)
• error-tracking at skills/posthog/error-tracking with 16 skill file(s)
• feature-flags at skills/posthog/feature-flags with 18 skill file(s)
• integration at skills/posthog/integration with 33 skill file(s)
• llm-analytics at skills/posthog/llm-analytics with 2 skill file(s)
• logs at skills/posthog/logs with 8 skill file(s)
• tools-and-features at skills/posthog/tools-and-features with 1 skill file(s)

Negative Signals

• plugin markers require namespace-preserving workspace processing

Workspace Identity

• Source files: 1983 total
• Namespaced packages: 254 package(s) across 1 namespace(s)
• Skill content: 254 SKILL.md file(s), 176 unique byte content item(s), 78 repeated occurrence(s) in 78 referentiable group(s)
• Estimated source tokens: approximately 423992 total if copied byte-for-byte, 372441 unique if referenced, 51551 repeated
• Frontmatter names: 78 repeated name group(s), 78 repeated occurrence(s)

Referentiable Repeated Content

• 01f345c024f3: canonical skills/posthog/all/skills/integration-react-react-router-7-data/SKILL.md; 1 alias(es), approximately 758 repeated token(s)
• 04d84942f519: canonical skills/posthog/all/skills/feature-flags-api/SKILL.md; 1 alias(es), approximately 336 repeated token(s)
• 053f5374d054: canonical skills/posthog/all/skills/integration-nextjs-pages-router/SKILL.md; 1 alias(es), approximately 764 repeated token(s)
• 059bcb04611b: canonical skills/posthog/all/skills/error-tracking-react-native/SKILL.md; 1 alias(es), approximately 462 repeated token(s)
• 09cac86411ac: canonical skills/posthog/all/skills/integration-react-tanstack-router-file-based/SKILL.md; 1 alias(es), approximately 849 repeated token(s)
• 73 more repeated content group(s) omitted. Use --json for all source_content_refs.

Repeated Frontmatter Names

• error-tracking-android: 2 occurrence(s) across skills/posthog/all/skills/error-tracking-android/SKILL.md, skills/posthog/error-tracking/skills/android/SKILL.md
• error-tracking-angular: 2 occurrence(s) across skills/posthog/all/skills/error-tracking-angular/SKILL.md, skills/posthog/error-tracking/skills/angular/SKILL.md
• error-tracking-flutter: 2 occurrence(s) across skills/posthog/all/skills/error-tracking-flutter/SKILL.md, skills/posthog/error-tracking/skills/flutter/SKILL.md
• error-tracking-go: 2 occurrence(s) across skills/posthog/all/skills/error-tracking-go/SKILL.md, skills/posthog/error-tracking/skills/go/SKILL.md
• error-tracking-hono: 2 occurrence(s) across skills/posthog/all/skills/error-tracking-hono/SKILL.md, skills/posthog/error-tracking/skills/hono/SKILL.md
• 73 more repeated frontmatter name group(s) omitted. Use --json for all frontmatter_name_refs.

Recommendation: Keep namespace/path as package identity and make repeated byte-identical SKILL.md content referentiable through source_content_ref aliases instead of copying the same bytes as independent source material.

Packages

plugin:skills/omnibus/analyzing-experiment-session-replays

• Path: skills/omnibus/analyzing-experiment-session-replays/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/assessing-heatmaps

• Path: skills/omnibus/assessing-heatmaps/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/auditing-endpoints

• Path: skills/omnibus/auditing-endpoints/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/auditing-experiments-flags

• Path: skills/omnibus/auditing-experiments-flags/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/auditing-warehouse-data-health

• Path: skills/omnibus/auditing-warehouse-data-health/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/authoring-log-alerts

• Path: skills/omnibus/authoring-log-alerts/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/authoring-signals-scouts

• Path: skills/omnibus/authoring-signals-scouts/SKILL.md
• Role: plugin_skill
• Drift risk: high
• Discovery risk: low

plugin:skills/omnibus/cleaning-up-stale-feature-flags

• Path: skills/omnibus/cleaning-up-stale-feature-flags/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/configuring-experiment-analytics

• Path: skills/omnibus/configuring-experiment-analytics/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/configuring-experiment-rollout

• Path: skills/omnibus/configuring-experiment-rollout/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/consuming-endpoints-from-client-code

• Path: skills/omnibus/consuming-endpoints-from-client-code/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

plugin:skills/omnibus/copying-flags-across-projects

• Path: skills/omnibus/copying-flags-across-projects/SKILL.md
• Role: plugin_skill
• Drift risk: critical
• Discovery risk: low

242 more package(s) omitted. Use --json for the full list.

Findings

1. MEDIUM: Plugin-shaped workspace requires namespace preservation

Location: github.com/PostHog/skills

Evidence: Detected 8 plugin root(s) and 254 SKILL.md package(s).

Basis: contract_trace_static_well_formedness

Fix: Run skillspec workspace map; do not flatten skill names across plugin namespaces.

2. MEDIUM: Repeated skill content should be referentiable

Location: github.com/PostHog/skills

Evidence: 254 namespaced skill package file(s) contain 176 unique byte-identical SKILL.md content item(s); 78 repeated occurrence(s) across 78 group(s) account for approximately 51551 repeated source token(s).

Basis: skillspec_local_reliability_gap, skillspec_local_contract_trace

Fix: Preserve every namespace/path package identity, but store one canonical source-content artifact per SHA and make each repeated package refer to that content instead of copying bytes as independent source.

3. MEDIUM: Frontmatter names repeat across distinct package identities

Location: github.com/PostHog/skills

Evidence: 78 frontmatter name group(s) repeat across 78 extra package occurrence(s). This is valid when namespace/path is the identity, but it is load-bearing for agents unless displayed explicitly.

Basis: claude_skill_frontmatter_discovery, skillspec_local_reliability_gap

Fix: Use namespace/path identity in workspace maps and show repeated names as referentiable aliases rather than duplicate package errors.

Next Actions

Recommended next action

skillspec workspace map github.com/PostHog/skills --out <build-dir>/skillspec.workspace.yml

• Map the workspace before import: skillspec workspace map github.com/PostHog/skills --out <build-dir>/skillspec.workspace.yml.
• From the harness, ask /skillspec map this repo and import the packages safely when you want the agent to preserve package shape, plugin namespaces, and dependencies.
• After fanout import, read the converge/alignment reports: decision replay should pass, required package steps should be proven, and missing proof should be explicit.
• Optionally publish the doctor baseline, generated skill.spec.yml files, and alignment reports with the source repo so reviewers can see what changed.
• Restart the harness after install, then use the SkillSpec-backed skills normally rather than invoking internal CLI steps by hand.
• Do not flatten the repo into one skill; process each discovered SKILL.md as an atomic package and converge dependencies before install.

Research Basis

17 cited basis item(s) are attached to this report.

• reliability_gap_instruction_density - Large, dense activation bodies increase dropped-step risk and later instructions suffer primacy bias. (SkillSpec Skills Reliability Gap)
• reliability_gap_metadata_context_pressure - Skill frontmatter metadata and activated bodies consume context; broad surfaces degrade routing and adherence. (SkillSpec Skills Reliability Gap)
• reliability_gap_implicit_environment_contract - Scripts and snippets carry dependency contracts whether or not the skill declares them. (SkillSpec Skills Reliability Gap)
• reliability_gap_no_execution_guarantees - Prose instructions and embedded snippets are guidance unless moved into checkable or enforced surfaces. (SkillSpec Skills Reliability Gap)
• reliability_gap_unfilled_requirement - Reliable skills need a portable, machine-checkable account of intended behavior, dependencies, and proof. (SkillSpec Skills Reliability Gap)
• contract_trace_activation_adherence_enforcement - Activation, adherence, and enforcement are separate gates; static prose mostly influences adherence, not enforcement. (SkillSpec Contract Trace Methodology)
• 11 more basis item(s) omitted. Use --json for the full basis registry.

Use --html for a shareable review page or --json for machine evidence.

Full artifacts: https://github.com/modiqo/skillspec/actions/runs/28494310991/artifacts/8000431248

The artifact contains:

• doctor-report.txt
• doctor-report.md
• doctor-report.html
• doctor-report.json
• target.txt