feat: Add /organize slash command for knowledge graph maintenance

User-invoked command to complement the knowledge-organize skill.

Actions:
- /organize health - Quick overview of KB status (default)
- /organize orphans - Find notes with no relations
- /organize duplicates - Find similar/overlapping notes
- /organize relations [note] - Suggest connections for a note
- /organize tags - Review and normalize tag consistency

Always confirms before modifying notes.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: phernandez <paul@basicmachines.co>
This commit is contained in:
phernandez
2025-11-28 13:58:19 -06:00
parent 68ee310a55
commit 5fcbae3fdb
2 changed files with 108 additions and 1 deletions
+21 -1
View File
@@ -101,6 +101,25 @@ Show recent activity in Basic Memory.
/recent today specs
```
### `/organize [action] [project]`
Organize and maintain your knowledge graph.
```
/organize # Quick health check
/organize orphans # Find unlinked notes
/organize duplicates # Find similar notes
/organize relations "Note" # Suggest links for a note
/organize tags # Review tag consistency
```
Actions:
- `health` - Overview of knowledge base status (default)
- `orphans` - Find notes with no relations
- `duplicates` - Find overlapping notes
- `relations` - Suggest connections
- `tags` - Review tag consistency
---
## Skills
@@ -232,7 +251,8 @@ basic-memory/
│ ├── remember.md # /remember command
│ ├── continue.md # /continue command
│ ├── context.md # /context command
── recent.md # /recent command
── recent.md # /recent command
│ └── organize.md # /organize command
├── skills/
│ ├── knowledge-capture/
│ ├── continue-conversation/
+87
View File
@@ -0,0 +1,87 @@
---
description: Organize and maintain your Basic Memory knowledge graph
argument-hint: [health|orphans|duplicates|relations|tags] [project]
allowed-tools: mcp__basic-memory__search_notes, mcp__basic-memory__read_note, mcp__basic-memory__list_directory, mcp__basic-memory__edit_note, mcp__basic-memory__write_note
---
# Organize
Help organize, link, and maintain your Basic Memory knowledge graph.
## Arguments
- `$1` - Action (optional): `health`, `orphans`, `duplicates`, `relations`, `tags` (default: `health`)
- `$2` - Project (optional): defaults to "main"
## Actions
### `/organize` or `/organize health`
Run a quick health check:
1. Count total notes
2. Identify orphan notes (no relations)
3. Check for potential duplicates
4. Show folder distribution
5. Report any issues found
### `/organize orphans`
Find and address orphan notes:
1. Search for notes with empty Relations sections
2. List orphans found
3. For each orphan, suggest potential relations based on content
4. Offer to add relations or create index notes
### `/organize duplicates`
Find potentially duplicate notes:
1. Search for notes with similar titles
2. Compare content for overlap
3. Suggest: merge, differentiate, or link with `supersedes`
### `/organize relations [note-title]`
Suggest relations for a specific note (or recent notes if not specified):
1. Read the target note
2. Search for related content
3. Suggest relation types:
- `relates-to` - General connection
- `extends` - Builds upon
- `implements` - Realizes concept
- `depends-on` - Requires understanding of
4. Offer to add selected relations
### `/organize tags`
Review tag consistency:
1. Gather all tags across notes
2. Find similar/duplicate tags (e.g., `arch` vs `architecture`)
3. Identify over-used or under-used tags
4. Suggest normalization
## Your Task
Execute: `/organize $ARGUMENTS`
Based on the action requested:
1. **Gather data** using search and list tools
2. **Analyze** for the specific issue (orphans, duplicates, etc.)
3. **Present findings** clearly with counts and examples
4. **Offer solutions** - ask before making changes
5. **Apply fixes** using edit_note or write_note when user approves
Always confirm before modifying notes. Show what will change and get approval.
## Examples
```
/organize # Quick health check
/organize health # Same as above
/organize orphans # Find unlinked notes
/organize duplicates # Find similar notes
/organize relations # Suggest links for recent notes
/organize relations "My Note" # Suggest links for specific note
/organize tags # Review tag consistency
/organize health specs # Health check on specs project
```