Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Added detailed configuration section with all available config keys and descriptions. - Explained new options for customizing wikilink and tag suggestion logic using stopwords, suffixes, and minimum lengths. - Clarified location and usage of `config.json` for workspace setup. - No changes to scripts or core functionality; documentation improvements only.
What This Skill Does
Foam is a free, open-source personal knowledge management system built on VS Code using standard Markdown files with wikilinks. This skill provides tools to create and link notes, discover backlinks, suggest wikilinks and tags, manage daily notes, analyze the knowledge graph, and handle note renaming and deletion with automatic link updates.
Notes stay in standard Markdown files with no proprietary format, so they remain portable across any editor or tool.
When to use it
- Finding all notes that reference a specific concept via backlink search
- Creating today's daily journal entry from a template
- Scanning a note and applying suggested wikilinks to existing note titles
- Renaming a note and automatically updating all references across the workspace
- Listing all tags with usage counts to audit and clean up note organization
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: suggest and apply wikilinks for my machine-learning.md note
- 1Read config.json to determine the foam_root workspace path
- 2Run suggest_wikilinks.py on machine-learning.md to scan content against existing note titles
- 3Present numbered suggestions showing matched text, target note, and line context
- 4Accept user selection (e.g. '1 3 5') or apply all with --auto-apply
- 5Confirm which wikilinks were written into the file
machine-learning.md updated with [[neural-networks]], [[gradient-descent]], and [[python-basics]] inserted at the matched locations