CW-201c · Module 2
Shared Skills & Organizational Knowledge
4 min read
Prompts are single-use. Skills persist. The difference is critical for team operations. A prompt lives in a conversation and dies when the session ends. A skill lives in the skills directory and fires automatically whenever the context matches its trigger conditions. When you share a skill across a team, every team member gets the benefit of the skill's encoded knowledge without having to know the skill exists.
The organizational knowledge management challenge is this: your company has hard-won knowledge locked in people's heads. Your best salesperson knows exactly how to position against Competitor X. Your best analyst knows which metrics actually matter for board reporting. Your best project manager knows the specific risk patterns that predict project failure. None of that knowledge is documented. When those people leave, the knowledge leaves with them.
Skills are an extraction mechanism for institutional knowledge. Work with your subject matter expert, have them walk Claude through their process, and capture it as a skill. "When someone asks about positioning against Competitor X, here is what matters: they win on feature breadth, we win on depth in our core domain. Their pricing is opaque, ours is transparent. Their support is ticket-based, ours includes a dedicated CSM. Position the comparison on depth + transparency + support, never on feature breadth."
That knowledge, encoded as a skill, now fires for every team member who asks Claude about Competitor X positioning. The expert's knowledge is no longer locked in one person's head. It is operational intelligence that the whole team benefits from. And when the expert refines their approach — "actually, their new pricing page makes their pricing transparent now, so drop that point" — the skill updates and every future invocation reflects the new reality.
Do This
- Extract institutional knowledge from experts into skills — it is the most durable form of documentation
- Share skills via your project's .claude/skills directory or a team-wide skills repository
- Update skills when reality changes — stale skills are worse than no skills because they spread outdated information
- Test shared skills in fresh sessions to verify they trigger correctly for users who did not create them
Avoid This
- Keep expert knowledge in people's heads — it walks out the door when they leave
- Share skills without testing — a skill that works in the creator's environment may fail in others
- Create skills that are too company-specific to ever update — the market changes, your skills must too
- Assume everyone will voluntarily contribute skills — assign skill creation as a deliverable to your experts