Short answer
Put important prompts in shared project files and explain when to use them. To share a prompt from the AIPM prompt library, run aipm add <prompt URL>: it saves a Markdown snapshot in .aipm/prompts/ and records the URL in aipm.package.json, so teammates restore it with aipm install.
Words used in this guide
- AIPM: a tool that installs and updates reusable AI instructions.
- Package: a named group of files that people can install and update together.
What this means
A shared prompt needs context
A prompt is not just text. It should also explain when to use it, what input it needs, and what good output looks like. Sharing skills rather than prompts? See how to share Claude skills with your team.
Files are better than chat history
A prompt is hard to reuse when it is hidden in an old chat. A shared file gives the team one clear place to find it.
Track library prompts with AIPM
aipm add https://www.aipm-registry.com/prompts/<publisher>/<slug> saves the prompt as .aipm/prompts/<publisher>--<slug>.md and tracks its URL in aipm.package.json. Commit both, and teammates run aipm install to restore the same snapshots. aipm update rewrites a snapshot only when the published prompt changed, and aipm remove deletes it. Prompts do not have version numbers, so you cannot pin an older revision.
Use a skill when you need a pinned version
If a prompt has become a repeatable task that several projects rely on, turn it into a skill. Skills are published with exact versions, and each project pins the version it uses.
Simple steps
- Pick one prompt the team uses often.
- Write the prompt in a project file, or find it in the AIPM prompt library.
- Add a short note that explains when to use it.
- Add one example input and output.
- For a library prompt, run aipm add <prompt URL> and commit aipm.package.json and .aipm/prompts/.
Where to go next
If you want to try this in a real project, start with how to use AIPM and the command reference. If you want to share your own workflow, read the publishing guide.
FAQ
Should team prompts be public?
Only publish prompts that are safe to share. Keep private business details, customer data, and secrets out of public prompts and packages.
Why not paste prompts in Slack?
Slack is useful for discussion, but a project file is easier to review, update, and restore.
Can I pin a prompt to a version?
No. Prompt snapshots are tracked by content, not version numbers, and aipm update pulls the newest content. Use a skill when you need an exact, pinned version.