From 170b66f623561b20e1d8e0da07e0b3bbcff6c564 Mon Sep 17 00:00:00 2001 From: Alex Newman Date: Sun, 9 Nov 2025 18:55:09 -0500 Subject: [PATCH] feat: Add documentation for project-level skills and their distinction from plugin skills --- .claude/skills/CLAUDE.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 .claude/skills/CLAUDE.md diff --git a/.claude/skills/CLAUDE.md b/.claude/skills/CLAUDE.md new file mode 100644 index 00000000..0867c6ba --- /dev/null +++ b/.claude/skills/CLAUDE.md @@ -0,0 +1,29 @@ +# Project-Level Skills + +This directory contains skills **for developing and maintaining the claude-mem project itself**, not skills that are released as part of the plugin. + +## Distinction + +**Project Skills** (`.claude/skills/`): +- Used by developers working on claude-mem +- Not included in the plugin distribution +- Project-specific workflows (version bumps, release management, etc.) +- Not synced to `~/.claude/plugins/marketplaces/thedotmack/` + +**Plugin Skills** (`plugin/skills/`): +- Released as part of the claude-mem plugin +- Available to all users who install the plugin +- General-purpose memory search functionality +- Synced to user installations via `npm run sync-marketplace` + +## Skills in This Directory + +### version-bump +Manages semantic versioning for the claude-mem project itself. Handles updating all four version files (package.json, marketplace.json, plugin.json, CLAUDE.md), creating git tags, and GitHub releases. + +**Usage**: Only for claude-mem maintainers releasing new versions. + +## Adding New Skills + +**For claude-mem development** → Add to `.claude/skills/` +**For end users** → Add to `plugin/skills/` (gets distributed with plugin)