Moldavite Skills

Agent Skills for Moldavite

Give your agent the Moldavite manual.

Five focused skills help agents work with Moldavite Markdown, Forges, MCP, daily notes, and portability.

Install with npx skills 
npx skills add https://github.com/mauropereiira/moldavite-skills
Meet the skills Read the repository
local agent setup ready
AI client Work in my Forge
01 Agent Skills Context in SKILL.md
02 Moldavite MCP Tools from the app
  • MDmoldavite-markdown
  • FSmoldavite-forges
  • MCmoldavite-mcp
  • DNmoldavite-daily-notes
  • PXmoldavite-portability
5 skill folders 7 MCP tools

Start here

What a skill actually is

An Agent Skill is a folder with a SKILL.md file. The file gives your AI client product rules, safe workflows, and the exact behavior it should expect.

Install the folder once. Compatible clients load its instructions when your request matches the skill.

moldavite-mcp
  • moldavite-mcp/
  • SKILL.md instructions
  • references/
  • TOOLS.md details

Five skills

One clear job for each skill

Each folder covers one part of Moldavite. Use the full pack so your client can choose the matching instructions.

01

moldavite-markdown

Create and edit Moldavite-compatible Markdown, frontmatter, wiki links, and tags

Open skill
02

moldavite-forges

Work safely with Forge layout, paths, locked notes, and direct file edits

Open skill
03

moldavite-mcp

Read, search, create, and update notes through Moldavite's MCP server

Open skill
04

moldavite-daily-notes

Maintain daily notes, ISO weekly notes, and Moldavite templates

Open skill
05

moldavite-portability

Back up, export, restore, and migrate Obsidian vaults into Moldavite

Open skill

Install

Add the skills to your client

Choose the method your client supports. Every method installs the same five skill folders.

01

Claude Code marketplace

Add the marketplace, then install the pack.

Claude Code 
/plugin marketplace add mauropereiira/moldavite-skills
/plugin install moldavite@moldavite-skills
02

npx skills

Install directly from the repository.

Terminal 
npx skills add https://github.com/mauropereiira/moldavite-skills
03

OpenCode

Clone the repository into the global skills directory, then restart OpenCode.

Terminal 
mkdir -p ~/.config/opencode/skills && git clone https://github.com/mauropereiira/moldavite-skills.git ~/.config/opencode/skills/moldavite-skills
04

Manual

Copy each directory under skills/ into your client's skills directory. Keep every SKILL.md beside its references/ directory.

Browse the folders

Connect MCP

Give the agent the note tools

Skills give your agent Moldavite context. MCP gives it the note tools. Use both for work inside a Forge.

The Homebrew cask puts moldavite on your PATH, so Claude Code can start the server with the short command below.

01

Install Moldavite with Homebrew

The cask adds the app and command to your Mac.

Terminal 
brew install --cask mauropereiira/moldavite/moldavite
02

Add Moldavite MCP to Claude Code

Use this command after a Homebrew install.

Terminal 
claude mcp add moldavite -- moldavite --mcp
03

Use the app path after a DMG install

The full path starts the same local MCP server.

Terminal fallback 
claude mcp add moldavite -- "/Applications/Moldavite.app/Contents/MacOS/moldavite" --mcp
Claude Code Pin a connection to one Forge

Use --forge when one connection should stay on a named Forge.

Terminal 
claude mcp add moldavite-work -- moldavite --mcp --forge "Work"
OpenCode Add the local MCP configuration

Save this entry in ~/.config/opencode/opencode.json.

JSON 
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "moldavite": {
      "type": "local",
      "command": ["moldavite", "--mcp"],
      "enabled": true
    }
  }
}

Restart the client after changing MCP configuration.

Read and write

You choose when agents can write

Four read tools are on by default. Three write tools stay off until you enable them in Settings → AI & Agents.

On by default

Read tools

4
  • search_notes Find notes by concept or keyword
  • read_note Read complete Markdown
  • list_notes List notes in a Forge folder
  • get_backlinks Find links pointing to a note
Enabled in Settings

Write tools

3
  • create_note Create one new note
  • write_note Replace one existing note
  • append_to_daily_note Add content to a daily note

Switching writes off removes these tools from the list during the session.

Locked notes

Locked notes are excluded from all seven tools.

Ready to install

Put Moldavite context in your client.

Choose an install method