foam-notes

What This Skill Does

The foam-notes skill is a powerful automation wrapper designed to interact with Foam, the popular open-source personal knowledge management system for VS Code. It bridges the gap between your AI agent and your markdown-based workspace, enabling seamless creation, management, and intelligence-driven organization of your notes. By leveraging the skill's capabilities, you can programmatically create, edit, rename, and delete notes, while utilizing advanced features like bidirectional wikilinks, tag management, and automatic backlink discovery. The skill simplifies workspace management by providing structured templates, daily note automation, and intelligent suggestion engines that filter out noise via configurable stopword lists. It empowers you to maintain a complex 'second brain' with minimal friction, treating your markdown files as a dynamic database.

Installation

To integrate foam-notes into your environment, follow these steps:

1. Ensure you have your Foam workspace initialized in VS Code.
2. Execute the command clawhub install openclaw/skills/skills/hegghammer/foam-notes in your terminal.
3. Locate the config.json file in the skill directory.
4. Update the foam_root field to point to your local markdown repository path.
5. Customize the default_template and folder structures to match your preferred organization scheme.

Use Cases

This skill is ideal for knowledge workers, researchers, and developers who use Markdown as their primary documentation format. You can use it to maintain a technical Zettelkasten, manage daily journals with linked insights, or build a personal library of project documentation. It is especially useful for batch-processing large numbers of notes, cleaning up unstructured content, or automatically interlinking research topics based on keyword matches.

Example Prompts

1. "Create a new daily note in my journals folder titled 'Project Alpha Update' and add a section for today's blockers."
2. "Search for all backlinks to 'Architecture' and generate a summary list of these connections."
3. "Refactor my note structure by renaming 'meeting-notes-2023' to 'Q4-sync' and ensure all incoming wikilinks are updated accordingly."

Tips & Limitations

The skill relies on the file system, so ensure your path permissions are correctly set. For large repositories, the initial indexing of wikilinks may take a moment. Use the title_stopwords configuration to prevent generic words like 'readme' or 'home' from cluttering your suggestion engine. Note that this skill directly manipulates files on your local drive; always maintain a Git repository backup of your workspace to revert any unintended bulk changes or automated refactoring errors.