Several skills in the plugin point at references/*.md or docs/*.md paths that do not exist inside their own skill directory. Progressive disclosure breaks at that point — the body tells the model to read a file that is not there.
The plugin's own working-with-skills skill lists this exact failure as a quality gate:
Link hygiene — every relative link in the body (references/x.md, ./y.md) exists in the files manifest; every manifest file is reachable from the body. Dead links break progressive disclosure.
Version: 1.1.56 (installed from claude-plugins-official, confirmed latest via claude plugin update posthog@claude-plugins-official)
What is missing
Two different shapes. Three files exist in some skills but were not copied into others that reference them; two are not present anywhere in the plugin.
references/report-contract.md — missing in 11 skills
Present in: authoring-scouts, signals-scout-anomaly-detection
Missing in: exploring-scouts, signals-scout-apm, signals-scout-csp-violations, signals-scout-customer-analytics, signals-scout-error-tracking, signals-scout-health-checks, signals-scout-inbox-validation, signals-scout-insight-alerts, signals-scout-observability-gaps, signals-scout-replay-vision, signals-scout-session-replay
The eleven are the ones that most need it — they are the scouts whose output is supposed to follow the report contract.
references/dedupe-and-memory.md — missing in 1 skill
Present in authoring-scouts, referenced by exploring-scouts.
references/changing-distribution-after-launch.md — missing in 1 skill
Present in configuring-experiment-rollout, referenced by diagnosing-experiment-results.
references/primer.md — not present anywhere
Referenced by skills-store and working-with-skills. Both have an empty (or absent) references/ directory.
docs/support-mcp-tools.md — not present anywhere
Referenced by testing-mcp-tools-locally.
How to reproduce
From the installed plugin root:
cd ~/.claude/plugins/cache/claude-plugins-official/posthog/1.1.56/skills
for d in */; do
grep -oE '(references|docs)/[A-Za-z0-9_./-]+\.md' "$d/SKILL.md" 2>/dev/null | sort -u | while read -r ref; do
[ -e "$d/$ref" ] || echo "$d -> $ref"
done
doneNot included in the counts above
Two paths that a naive scan flags are legitimate prose examples, not defects — they are excluded here deliberately:
references/x.md in working-with-skills, from the link-hygiene rule quoted at the topreferences/rollback.md in signals-scout-skills-store, inside a sample memory entry describing another skill's dead link
Impact
15 skills are affected. Nothing crashes; the model simply cannot open the file it was told to read, and the guidance those files carry — the report contract in particular — silently does not reach it.
Found while auditing skill references across all installed plugins. Happy to send a PR that copies the three shared files into the skills that reference them, if that matches how you would rather fix it.
Several skills in the plugin point at
references/*.mdordocs/*.mdpaths that do not exist inside their own skill directory. Progressive disclosure breaks at that point — the body tells the model to read a file that is not there.The plugin's own
working-with-skillsskill lists this exact failure as a quality gate:Version: 1.1.56 (installed from
claude-plugins-official, confirmed latest viaclaude plugin update posthog@claude-plugins-official)What is missing
Two different shapes. Three files exist in some skills but were not copied into others that reference them; two are not present anywhere in the plugin.
references/report-contract.md— missing in 11 skillsPresent in:
authoring-scouts,signals-scout-anomaly-detectionMissing in:
exploring-scouts,signals-scout-apm,signals-scout-csp-violations,signals-scout-customer-analytics,signals-scout-error-tracking,signals-scout-health-checks,signals-scout-inbox-validation,signals-scout-insight-alerts,signals-scout-observability-gaps,signals-scout-replay-vision,signals-scout-session-replayThe eleven are the ones that most need it — they are the scouts whose output is supposed to follow the report contract.
references/dedupe-and-memory.md— missing in 1 skillPresent in
authoring-scouts, referenced byexploring-scouts.references/changing-distribution-after-launch.md— missing in 1 skillPresent in
configuring-experiment-rollout, referenced bydiagnosing-experiment-results.references/primer.md— not present anywhereReferenced by
skills-storeandworking-with-skills. Both have an empty (or absent)references/directory.docs/support-mcp-tools.md— not present anywhereReferenced by
testing-mcp-tools-locally.How to reproduce
From the installed plugin root:
Not included in the counts above
Two paths that a naive scan flags are legitimate prose examples, not defects — they are excluded here deliberately:
references/x.mdinworking-with-skills, from the link-hygiene rule quoted at the topreferences/rollback.mdinsignals-scout-skills-store, inside a sample memory entry describing another skill's dead linkImpact
15 skills are affected. Nothing crashes; the model simply cannot open the file it was told to read, and the guidance those files carry — the report contract in particular — silently does not reach it.
Found while auditing skill references across all installed plugins. Happy to send a PR that copies the three shared files into the skills that reference them, if that matches how you would rather fix it.