My Note Skills
half-nomad/my-note-skills
Gerencie seu Obsidian dentro do Claude com skills de criação e atualização de notas
Ver no GitHubConjunto de skills para Claude que integra gerenciamento de notas Obsidian diretamente em conversas. Permite criar, atualizar e resumir notas com templates inteligentes, detecção automática de estrutura de vault e sincronização com git.
Instalação
npx convez-ai half-nomad/my-note-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Capturar resumos de conversas como notas estruturadas no Obsidian
- Atualizar notas existentes com insights de novas conversas
- Gerar sumários estruturados em diferentes formatos (meeting, TIL, workflow)
- Manter sincronizado um segundo brain com o fluxo de trabalho em Claude
Veredito

Skill madura e bem arquitetada para quem usa Obsidian como second brain. Implementação sólida com auto-setup, suporte a templates e git — recomendado para produtivistas que querem claudificar seu fluxo de notas.
README
A tradução para o português deste README ainda está na fila.
my-note-skills
A Claude Code plugin marketplace hosting my-note-skills — four Obsidian vault note-management skills.
Skills included
| Skill | Purpose |
|---|---|
/note-setup | First-run wizard. Detects vault structure (Inbox, Templates, search folders) and saves config. Auto-runs on first use. |
/note-new [topic|file] | Save conversation summary as a new note (template-aware: Document/Card/Permanent/Reference/Project/Workflow/Meeting). |
/note-update [keyword] | Find related notes in your vault and update them with conversation insights. |
/note-summary [mode] | Structured summary in chat (no save). Modes: brief/bullet/meeting/til/decision/workflow. |
Install
Claude Code (recommended — marketplace)
/plugin marketplace add half-nomad/my-note-skills
/plugin install my-note-skills@my-note-skills
To remove later:
/plugin uninstall my-note-skills
/plugin marketplace remove my-note-skills
Claude Code (direct local)
git clone https://github.com/half-nomad/my-note-skills.git ~/.claude/plugins/local/my-note-skills
# inside Claude Code:
/plugin install ~/.claude/plugins/local/my-note-skills/plugins/my-note-skills
Claude Desktop (Cowork)
Use the bundled .plugin file from Releases or dist/my-note-skills.plugin:
- Open Claude Desktop → Settings → Extensions/Plugins
- Install from file → select
my-note-skills.plugin
Claude.ai web (chat) — individual skills
Claude.ai web requires uploading skills individually as .zip files via Settings → Features → Skills:
dist/note-setup.zipdist/note-new.zipdist/note-update.zipdist/note-summary.zip
Reference: Agent Skills - platform.claude.com "Upload your own Skills as zip files through Settings > Features."
First Run
The first time you call /note-new or /note-update, the note-setup wizard runs automatically and:
- Asks for your Obsidian vault path (defaults:
~/My_note/,~/Documents/Obsidian/,~/Obsidian/) - Scans top-level folder structure (auto-detects PARA-style layouts)
- Detects Inbox, Templates, and search folders
- Reads your vault's
CLAUDE.mdif present (for naming conventions) - Detects git config (branch, sync workflow)
- Saves config to
~/.claude/my-note-skills/config.json
Re-run any time with /note-setup.
Config
Location: ~/.claude/my-note-skills/config.json
{
"vault_path": "/Users/you/Obsidian",
"inbox_dir": "00.Inbox",
"templates_dir": "90.Settings/92.Templates",
"search_folders": [
{"priority": 1, "path": "30.Expertise", "label": "Knowledge base"}
],
"excluded_folders": ["90.Settings", ".obsidian"],
"templates": {
"default": "Document template.md",
"card": "Card template.md"
},
"git": {
"enabled": true,
"branch": "master",
"commit_prefix": "Update"
}
}
Override via env var
export OBSIDIAN_VAULT_PATH=~/another-vault
When set, this overrides vault_path from the config file.
Repository layout
my-note-skills/ ← marketplace root
├── .claude-plugin/marketplace.json ← marketplace manifest
├── plugins/my-note-skills/ ← the plugin
│ ├── .claude-plugin/plugin.json
│ └── skills/
│ ├── note-setup/SKILL.md
│ ├── note-new/SKILL.md
│ ├── note-update/SKILL.md
│ └── note-summary/SKILL.md
├── dist/ ← release artifacts
│ ├── my-note-skills.plugin ← bundled plugin (zip)
│ └── note-*.zip ← individual skills for Claude.ai
├── LICENSE
└── README.md
License
MIT — see LICENSE.