Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Work with Foam note repositories. Create, edit, link, and tag notes. Get intelligent wikilink and tag suggestions. Skill supports backlinks discovery, daily...
Work with Foam note repositories. Create, edit, link, and tag notes. Get intelligent wikilink and tag suggestions. Skill supports backlinks discovery, daily...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Work with Foam note-taking workspaces in VS Code. Foam is a free, open-source personal knowledge management system using standard Markdown files with wikilinks.
Wikilinks: [[note-name]] โ connect notes bidirectionally Embeds: ![[note-name]] โ include content from other notes Backlinks: Automatically discovered connections to current note Tags: #tag or frontmatter tags: [tag1, tag2] Daily Notes: Alt+D or command "Foam: Open Daily Note"
Copy config.json.template to config.json and edit to taste: { "foam_root": "/path/to/your/foam-workspace", "default_template": "new-note", "default_notes_folder": "notes", "daily_note_folder": "journals", "author": "Your Name", "wikilinks": { "title_stopwords": ["home", "index", "readme", "draft", "template"], "suffixes": ["-hub"], "min_length": 3 }, "tags": { "editorial_stopwords": ["notes", "note", "foam", "markdown", "file", "page", "section"] } } Location: config.json in the skill directory (next to SKILL.md).
KeyTypeDefaultDescriptionfoam_rootstring"" (auto-detect)Path to your Foam workspacedefault_templatestring"new-note"Template for new notesdefault_notes_folderstring"notes"Subfolder for new notesdaily_note_folderstring"journals"Subfolder for daily notesauthorstring""Author name for note creationwikilinks.title_stopwordslist[]Note titles to never match as wikilinks (e.g. "home", "index", "todo"). Add any generic filenames from your workspace that produce false positives.wikilinks.suffixeslist[]Filename suffixes whose base stem should also register as a match key. For example, if you name your hub/MOC notes docker-hub.md, add "-hub" here so that "docker" in prose matches docker-hub.md.wikilinks.min_lengthint3Minimum key length to consider for wikilink matchingtags.editorial_stopwordslist[]Domain-specific words to exclude from tag suggestions (in addition to standard English stopwords).
--foam-root CLI argument FOAM_WORKSPACE environment variable foam_root in config.json Auto-detect by finding .foam or .vscode directory Current working directory See references/configuration.md for complete documentation.
All scripts support --foam-root to override the workspace path.
Initialize .foam/templates/ with starter templates from the official Foam template: python3 scripts/init_templates.py # Copy to current workspace python3 scripts/init_templates.py --foam-root ~/notes python3 scripts/init_templates.py --list # Show available templates python3 scripts/init_templates.py --force # Overwrite existing python3 scripts/init_templates.py --dry-run # Preview what would be copied Templates included: new-note.md โ Default template for new notes daily-note.md โ Template for daily notes your-first-template.md โ Example template demonstrating VS Code snippets
Create a new note from template: python3 scripts/create_note.py "My New Idea" python3 scripts/create_note.py "Meeting Notes" --template meeting python3 scripts/create_note.py "Research Topic" --dir research/
Find all notes that link to a given note: python3 scripts/find_backlinks.py "Machine Learning" python3 scripts/find_backlinks.py "ml-basics" --format json
Find notes by tag: python3 scripts/search_tags.py "#research" python3 scripts/search_tags.py machine-learning --include-frontmatter
List all tags with usage counts: python3 scripts/list_tags.py python3 scripts/list_tags.py --hierarchy --min-count 3
Analyze the knowledge graph: python3 scripts/graph_summary.py python3 scripts/graph_summary.py --format json
Create daily notes: python3 scripts/daily_note.py python3 scripts/daily_note.py --yesterday python3 scripts/daily_note.py --template custom-daily python3 scripts/daily_note.py --print-path # Just output the path
Suggest wikilinks by finding text in a note that matches existing note titles: python3 scripts/suggest_wikilinks.py my-note.md # Interactive mode python3 scripts/suggest_wikilinks.py my-note.md --apply 1,3,5 # Auto-apply python3 scripts/suggest_wikilinks.py my-note.md --auto-apply # Apply all python3 scripts/suggest_wikilinks.py my-note.md --dry-run # Preview only python3 scripts/suggest_wikilinks.py my-note.md --with-aliases # Create [[target|text]] format The script scans the note content and identifies words/phrases that match existing note titles in the archive. It presents them as a numbered list: 1. Line 12, col 8 Text: "machine learning" Link to: [[machine-learning]] Context: ...working on machine learning projects... Wikilink formats: Default: [[target]] โ clean, simple links With --with-aliases: [[target|display text]] โ preserves original text as alias Respond with: Numbers to implement (e.g., 1 3 5) all to apply all suggestions none to cancel
Suggest tags for a note based on content and existing tags in the archive: python3 scripts/suggest_tags.py my-note.md # Interactive mode python3 scripts/suggest_tags.py my-note.md --apply all # Add all suggested python3 scripts/suggest_tags.py my-note.md --apply existing # Only existing tags python3 scripts/suggest_tags.py my-note.md --frontmatter # Add to frontmatter The script: Extracts keywords from note content Finds matching existing tags (with usage counts) Suggests new tags based on content analysis Presented as numbered list with two sections: Existing Tags โ Already used in your archive New Suggestions โ Extracted from current note content Respond with: Numbers (e.g., 1 3 5) all โ all suggestions existing โ only existing tags new โ only new suggestions none โ cancel Or type custom tags: #mytag #project
Delete notes with optional backup and automatic backlink handling: python3 scripts/delete_note.py "Old Note" # Interactive deletion python3 scripts/delete_note.py "Old Note" --force # Skip confirmation python3 scripts/delete_note.py "Old Note" --backup # Move to .foam/trash/ python3 scripts/delete_note.py "Old Note" --fix-links # Remove wikilinks from other notes Features: Backup mode: Moves note to .foam/trash/ instead of permanent deletion Backlink detection: Shows which notes link to the one being deleted Link fixing: Automatically removes wikilinks from other notes Confirmation: Prompts before deletion (skip with --force)
Rename notes and automatically update all wikilinks: python3 scripts/rename_note.py "Old Name" "New Name" # Interactive rename python3 scripts/rename_note.py "Old Name" "New Name" --force # Skip confirmation Features: Automatic wikilink updates: Finds and updates all [[old-name]] references File rename: Changes filename from old-name.md to new-name.md Title preservation: Keeps note content intact, only updates links Confirmation: Shows affected notes before proceeding
Use this skill when: Creating or editing notes in a Foam workspace Working with wikilinks, backlinks, or the knowledge graph Analyzing note relationships and connections Setting up or configuring Foam templates Working with daily notes or tags Publishing Foam workspaces to static sites
foam-workspace/ โโโ .vscode/ โ โโโ extensions.json # Recommended extensions โ โโโ settings.json # VS Code settings โโโ .foam/ โ โโโ templates/ # Note templates (.md and .js) โโโ journals/ # Daily notes (default location) โโโ attachments/ # Images and files โโโ *.md # Your notes โโโ foam.json (optional) # Foam configuration
Create connections between notes using double brackets: See also [[related-concept]] for more information. Autocomplete with [[ + type note name Navigate with Ctrl+Click (or Cmd+Click on Mac) Create new notes by clicking non-existent links Link to sections: [[note-name#Section Title]] See references/wikilinks.md for complete documentation.
Backlinks show which notes reference the current note โ discovered automatically by Foam. Access via: Command palette: "Explorer: Focus on Connections" Shows forward links, backlinks, or both Use backlinks for: Finding unexpected connections between ideas Identifying hub concepts (notes with many backlinks) Building context around ideas across domains See references/backlinks.md for complete documentation.
Organize notes beyond wikilinks: # Inline tags #machine-learning #research #in-progress # Frontmatter tags --- tags: [machine-learning, research, in-progress] --- Hierarchical: #programming/python Browse in Tag Explorer panel Search: "Foam: Search Tag" See references/tags.md for complete documentation.
Quick daily journaling: Shortcut: Alt+D Command: "Foam: Open Daily Note" Snippets: /today, /yesterday, /tomorrow Template: .foam/templates/daily-note.md See references/daily-notes.md for complete documentation.
Customize note creation. Foam looks for templates in .foam/templates/. To initialize starter templates: python3 scripts/init_templates.py This copies official Foam templates to your workspace: new-note.md โ Default template daily-note.md โ Daily notes template your-first-template.md โ Example with VS Code snippets Markdown templates (.md): --- foam_template: filepath: '$FOAM_CURRENT_DIR/$FOAM_SLUG.md' --- # $FOAM_TITLE Created: $FOAM_DATE_YEAR-$FOAM_DATE_MONTH-$FOAM_DATE_DATE $FOAM_SELECTED_TEXT JavaScript templates (.js) โ for smart, context-aware templates. See references/templates.md for complete documentation.
When creating notes programmatically (not via VS Code), always read the workspace template in .foam/templates/new-note.md first and follow its structure exactly. In VS Code: Use "Foam: Create New Note" for default template Use "Foam: Create New Note From Template" to choose template Or click a non-existent wikilink [[new-note]]
Backlinks: Check Connections panel for linked notes Graph View: Command "Foam: Show Graph" for visual network Tag Explorer: Browse notes by tag
Include content from other notes: ![[glossary]] See the full definition above.
Foam can publish to static sites: GitHub Pages (built-in template) Netlify Vercel GitLab Pages Custom static site generators (Gatsby, MkDocs, etc.) See recipes in Foam documentation for publishing options.
FeatureFoamObsidianWikilinks[[note]][[note]]Embeds![[note]]![[note]]PlatformVS CodeDedicated appPlugin ecosystemMinimal (VS Code extensions)ExtensiveFile formatStandard MarkdownMarkdown with extensionsConfiguration.vscode/settings.json.obsidian/ folderPriceFreeFreemium Both use the same core linking syntax. Foam prioritizes simplicity and standard formats.
Key .vscode/settings.json options: { "foam.openDailyNote.onStartup": true, "foam.dateSnippets.format": "yyyy-mm-dd", "markdown.styles": [".foam/css/custom.css"] }
Key VS Code commands: Foam: Open Daily Note โ Create/open today's note Foam: Create New Note โ Create from default template Foam: Create New Note From Template โ Choose template Foam: Create New Template โ Create new template Foam: Show Graph โ Visualize knowledge graph Foam: Search Tag โ Search for tagged notes Explorer: Focus on Connections โ Show backlinks panel
foam-overview.md โ General Foam introduction and philosophy wikilinks.md โ Complete wikilinks guide backlinks.md โ Backlinks and knowledge discovery tags.md โ Tag organization and filtering daily-notes.md โ Daily note workflows templates.md โ Template creation (Markdown and JavaScript) Read these files for detailed information on specific features.
Official site: https://foamnotes.com GitHub: https://github.com/foambubble/foam Discord: https://foambubble.github.io/join-discord/w
Start small: Foam works best with consistent note-taking habits Link liberally: Create wikilinks even to non-existent notes (placeholders) Use the graph: Visualize your knowledge network to find gaps Trust the process: Backlinks reveal connections you didn't plan Keep it standard: Foam uses standard Markdown โ your notes remain portable
Writing, remixing, publishing, visual generation, and marketing content production.
Largest current source with strong distribution and engagement signals.