Skip to content

Commit 2940d9a

Browse files
geledekclaude
andcommitted
skills: state reference-file location in every References section
Each SKILL.md now says reference files live in references/ at the plugin root (${CLAUDE_PLUGIN_ROOT}/references/ when installed), making retrieval deterministic instead of best-effort filename hunting. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent fc8b8ca commit 2940d9a

15 files changed

Lines changed: 30 additions & 0 deletions

File tree

skills/general-idea-diagnostic/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,8 @@ See `cases/` for diagnosed examples. When diagnosing a new idea, compare against
127127

128128
## References
129129

130+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
131+
130132
- `95-5-genai-divide.md` — empirical basis for why rigorous gating matters: 95% of pilots produce zero measurable P&L impact
131133
- `european-fintech-case.md` — canonical measurement-gap failure case
132134
- `mckinsey-3-objective-mix.md` — objective-mode classification (efficiency / growth / innovation)

skills/general-maturity-assessment/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,6 +145,8 @@ CURRENT STATE SUMMARY | TARGET STATE | CAPABILITY GAPS (ordered) | BOLD GOAL | R
145145

146146
## References
147147

148+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
149+
148150
- `mit-cisr-4-stages.md` — four-stage model; performance data; Stage 3 inflection; DBS/Ping An exemplars
149151
- `accenture-maturity-archetypes.md` — Foundation × Differentiation 2×2; archetype definitions; Achiever performance premium
150152
- `mckinsey-3-objective-mix.md` — efficiency/growth/innovation objective mix

skills/general-peer-cases/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,6 +145,8 @@ PROFILE | CASE BUNDLE | CROSS-CASE LESSONS | CLOSEST-MATCH ACTION | CONFIDENCE |
145145

146146
## References
147147

148+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
149+
148150
- `stanford-51-deployments.md` — 51-deployment study; 77% invisible-cost finding; canonical retrieved-case set.
149151
- `95-5-genai-divide.md` — base-rate anchor: 95% of pilots produce zero measurable P&L impact; 5% breakthrough criteria.
150152
- `european-fintech-case.md` — canonical Replace-mode case: 700 agents replaced, CSAT -22%, hiring resumed; the measurement-gap failure mode.

skills/general-roi-gate/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -119,6 +119,8 @@ RECOMMENDATION | CONDITIONS (if any) | RED FLAGS (if any) | VERDICT RATIONALE
119119

120120
## References
121121

122+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
123+
122124
- `pwc-20-item-checklist.md` — the full 20-item Do's and Don'ts list
123125
- `pwc-roi-2026-governance.md` — 1.6× vs. 2.6× productivity gap; 1.7× RAI governance advantage
124126
- `mckinsey-3-objective-mix.md` — efficiency / growth / innovation objective classification

skills/general-use-case-discovery/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,8 @@ Default stance: if fewer than 3 candidates clear the bar, return what you have a
101101

102102
## References
103103

104+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
105+
104106
- mckinsey-3-objective-mix.md — productivity / growth / transformation portfolio balance, ~50/30/20 default.
105107
- andrew-ng-three-moats.md — proprietary data, workflow embedding, distribution as the only durable moats in applied AI.
106108
- pilot-discipline-ng.md — narrow + reversible + measurable + owned filter for first-pilot selection.

skills/people-frontline-engagement/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -169,6 +169,8 @@ VERDICT | ENGAGEMENT PLAN | FOUR-COLUMN TASK SPLIT | SAFETY CONTRACT | TRADECRAF
169169

170170
## References
171171

172+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
173+
172174
- `stanford-51-deployments.md` — 77% of deployment costs are invisible (change, trust, redesign); tradecraft preservation as first-class deliverable
173175
- `imda-4-dimensions-agentic.md` — named human accountability (Dimension 2); structural over prompt-layer controls
174176
- `bcg-manager-modeling.md` — leader-speaks-last norm; manager modeling as the unlock for frontline adoption

skills/people-literacy-curriculum/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -155,6 +155,8 @@ Verdict states:
155155

156156
## References
157157

158+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
159+
158160
- eu-ai-act-essentials.md — Art. 4 mandatory literacy duty, scope, refresh, evidence requirements.
159161
- bcg-manager-modeling.md — 88/25 finding; manager weekly use as the adoption multiplier.
160162
- deloitte-cheerleader-to-champion.md — 30% champion-level executive sponsorship as ceiling on adoption.

skills/people-readiness-conversation/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,6 +134,8 @@ Consolidate Roles 1–4. Write for CEO or CHRO audience.
134134

135135
## References
136136

137+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
138+
137139
- `70-20-10-value-split.md` — BCG 70% people value; context for why these gaps matter
138140
- `bcg-manager-modeling.md` — 88/25 role-modeling gap; specific manager behaviors
139141
- `mckinsey-3x-senior-ownership.md` — 3× CEO ownership differential

skills/process-pilot-design/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -154,6 +154,8 @@ Produce a one-page pilot brief from Roles 1–6. Write for sponsor approval. Be
154154

155155
## References
156156

157+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
158+
157159
- `95-5-genai-divide.md` — Scope × Execution Grid; 90-day timeline; narrow-scope success patterns
158160
- `stanford-51-deployments.md` — invisible-costs; workflow-redesign-first; pre-deployment metrics discipline
159161
- `european-fintech-case.md` — measurement-gap reference case

skills/process-portfolio-observability/SKILL.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,8 @@ KPI_TREE | DASHBOARD_SPEC | REVIEW_CADENCE | SUNSET_CRITERIA | STATE: Observable
8282

8383
## References
8484

85+
*All files below live in `references/` at the plugin root (`${CLAUDE_PLUGIN_ROOT}/references/` when installed as a plugin).*
86+
8587
- `pwc-roi-2026-governance.md` — net-of-oversight ROI as the disclosure-grade number; gross ROI no longer defensible.
8688
- `pwc-20-item-checklist.md` — 20-item governance audit; items 11–16 cover input/output/outcome KPI wiring.
8789
- `imda-4-dimensions-agentic.md` — Dimension 4 structural controls (bounded tools, bounded budget, kill-switch) maps to dashboard guardrails.

0 commit comments

Comments
 (0)