A comprehensive personal knowledge management skill for creating, linking, and analyzing Foam-based Markdown note repositories.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install foam-notes
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install foam-notes using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Foam Notes Skill?
The Foam Notes skill brings professional-grade personal knowledge management (PKM) to your AI agent workflow. Based on the Foam philosophy, this skill allows for the creation of a 'second brain' using standard Markdown files, wikilinks, and hierarchical tags. By integrating with Openclaw Skills, developers can automate the tedious aspects of note-taking, such as managing complex link structures and maintaining a consistent folder hierarchy.
This skill is designed for users who value portability and simplicity, prioritizing standard formats that remain readable in any Markdown editor while providing the power of a networked knowledge base. Whether you are tracking research, documenting codebases, or journaling daily progress, this skill ensures your information remains interconnected and easily discoverable.
Foam Notes Skill Use Cases
- Building a networked knowledge base using bidirectional wikilinks to connect related concepts.
- Automating the creation of daily notes and meeting logs using standardized Markdown templates.
- Discovering hidden relationships between notes through automated backlink analysis.
- Refactoring large note archives by renaming files and automatically updating all internal references.
- Organizing vast amounts of information using hierarchical tags and automated tag suggestions.
How Foam Notes Skill Works
- The skill identifies the Foam workspace root via configuration files, environment variables, or automatic directory detection.
- Users initialize the workspace with specialized templates for daily notes, research logs, and general entries.
- As notes are created, the skill processes text to suggest wikilinks and tags based on the existing archive context.
- Bi-directional links (backlinks) are tracked to provide a map of how different notes influence and reference each other.
- Maintenance scripts handle file deletions and renames, ensuring that the integrity of the knowledge graph remains intact by updating all affected links.
Foam Notes Skill Setup
To get started with this skill within the Openclaw Skills ecosystem, follow these steps:
# Navigate to the skill directory and copy the configuration
cp config.json.template config.json
# Edit config.json to set your foam_root path
# Initialize your workspace with starter templates
python3 scripts/init_templates.py
# Create your first note
python3 scripts/create_note.py "My First Note"
Foam Notes Skill Data Schema & Taxonomy
The skill organizes data within a standard Foam workspace structure to ensure compatibility with VS Code extensions and other Markdown tools:
| Component | Path/Format | Description |
|---|---|---|
| Templates | .foam/templates/ |
Markdown and JS files defining note structures. |
| Daily Notes | journals/ |
Chronological notes organized by date. |
| Knowledge Graph | [[wikilinks]] |
Bidirectional connections between individual .md files. |
| Metadata | Frontmatter | YAML-based tags, authors, and dates at the top of notes. |
| Configuration | config.json |
Stores stopwords, path overrides, and link logic. |
Foam Notes Skill Advanced Features
- Intelligent wikilink suggestions that scan prose to identify potential connections to existing notes.
- Automated link fixing during note deletion to prevent 'dead ends' in your knowledge graph.
- Hierarchical tag support for deep categorization of research and project data.
- Graph summary tools that provide a technical overview of your note density and connectivity.
- Multi-template support allowing for context-aware note creation (e.g., meeting vs. research templates).
SKILL.md
Loading
Related Openclaw Skills
News Daily
An automated RSS news aggregator that fetches global, tech, and AI news and delivers them as formatted cards to Feishu via Openclaw Skills.
YZTurboWebAndroid
A high-performance Android WebView container SDK featuring preloading, instance reuse, and seamless JS-Native bidirectional communication.
Self-Improvement Agent Skill
A sophisticated logging and feedback framework that enables AI coding agents to autonomously capture learnings and fix recurring errors.
Agent Audit Scanner
A robust security auditing tool designed to detect vulnerabilities, credential leaks, and unsafe code within Openclaw Skills before they are executed.
NewsAPI Search
A powerful search interface for NewsAPI that allows for deep article discovery and real-time headline tracking across thousands of global sources.
Lunar Calendar & Almanac Tool
A deterministic calculation tool for precise Chinese Lunar calendar conversion, almanac lookup, and 24 solar terms tracking.
METADATA
Featured*
