Pack No. 31 · Learn

Second Brain

Notes your agent can write, link and find again.

Who it's forPeople who keep their notes in Obsidian or in a plain Markdown folder and want an agent to work in it without breaking links or inventing syntax. Two cards need the Obsidian desktop app, the web clipper needs Node.js, and the three format cards are plain instructions. If your notes live in Notion, read the first note below.
Install the "Second Brain" skill collection from starterdeck.dev. It is a set of agent skills, each fetched from its author's GitHub repository at a pinned commit with the open-source skills CLI.

Check first that Node.js 22.20 or newer is installed (node --version). If it is not, stop and tell me.

Then run these commands exactly as written, one after another. Do not change them and do not add others. If one fails, stop and show me the error.

npx skills add obsidianmd/obsidian-skills@b110b2f8e9eb1f287892f937050dfd40af862cbb --skill obsidian-markdown obsidian-cli defuddle obsidian-bases json-canvas -g -y
npx skills add coreyhaines31/makerskills@402942cc80d7cf8d51b500e431f9177e4b7160bc --skill second-brain -g -y

When they have finished, list the skills that were installed.

Paste it into Claude Code, Codex, Cursor, Gemini CLI or any other agent with a terminal. It fetches 6 skills from 2 author repos, each pinned to the version we reviewed, with the commands on the Terminal tab. Nothing runs until you send the message.

What's inside

6 skills. Each card links to its author's repository at the exact version we reviewed.

  1. Obsidian Markdown 1/6 Official Note format Ready Writes notes in Obsidian's own Markdown: properties, wikilinks, embeds, callouts, tags, block links and comments, with the rules that keep links and tables from breaking. @obsidianmd MIT

    Obsidian Markdown

    Notes an agent writes only help if Obsidian can link them. This is Obsidian's own guide to wikilinks, properties, embeds and callouts, so new notes join your graph without stray syntax.

    Works right away Official · Obsidian MIT
    Source obsidianmd/obsidian-skills at b110b2f
  2. Obsidian CLI 2/6 Official Vault control Needs app Works inside your open Obsidian app through its own command line: reads, searches, creates, appends, renames and moves notes, sets properties, lists tasks, tags and backlinks. @obsidianmd MIT

    Obsidian CLI

    Lets the agent work through the running app: search the vault, append to today's daily note, set properties, and rename or move notes so that Obsidian updates every link to them.

    Needs an app or CLI Official · Obsidian MIT
    Source obsidianmd/obsidian-skills at b110b2f
  3. Second brain wiki 3/6 Knowledge base Ready Keeps a Markdown vault in three folders: saves sources to raw, compiles them into linked wiki pages with an index, answers questions from the wiki alone and checks it for gaps. @coreyhaines31 MIT

    Second brain wiki

    Gives the vault a routine: drop sources into a raw folder, have the agent compile them into linked wiki pages, then ask questions that are answered from your own notes with the pages named.

    Works right away Community · Corey Haines MIT
    Source coreyhaines31/makerskills at 402942c
  4. Defuddle 4/6 Web clipping Needs app Runs the Defuddle command line on a URL to pull the main text of a web page out as clean Markdown, without navigation and ads. Can save it to a file or read the page's metadata. @obsidianmd MIT

    Defuddle

    Clips an article into the vault as clean Markdown without menus and ads, so what you save is the text you wanted to keep and not a copy of the whole page.

    Needs an app or CLI Community · Obsidian MIT
    Source obsidianmd/obsidian-skills at b110b2f
  5. Obsidian Bases 5/6 Official Database views Ready Writes Obsidian .base files: views of your notes as tables, cards, lists or kanban boards, with filters, formulas and summaries, plus fixes for the usual YAML and formula errors. @obsidianmd MIT

    Obsidian Bases

    Turns a pile of notes into a reading list, a project board or a task table. The .base syntax is young and easy to get wrong, and this is the reference from the people who built it.

    Works right away Official · Obsidian MIT
    Source obsidianmd/obsidian-skills at b110b2f
  6. JSON Canvas 6/6 Official Visual canvas Ready Creates and edits .canvas files, the open format behind Obsidian Canvas: text, file, link and group nodes, edges, colours and layout, then checks every ID and edge reference. @obsidianmd MIT

    JSON Canvas

    For when a topic needs a map. The agent lays out notes and ideas as cards with labelled connections on a canvas that you can keep rearranging by hand.

    Works right away Official · Obsidian MIT
    Source obsidianmd/obsidian-skills at b110b2f

Good to know

What you bring

  • Obsidian desktop app, installer 1.12.7 or newer, open while the agent works
  • Command line interface switched on in Obsidian's settings, under General
  • Node.js with npm
  • Defuddle CLI (free, installed from npm)

Pick one, not both

  • Notion: if your notes live there, take notion-knowledge-capture by Notion in place of this pack. It saves a conversation as a how-to, FAQ or decision record in the page you name, and needs a Notion account and Notion's MCP server.
  • Vault folder: second-brain works in Documents/SecondBrain in your home folder unless you set SECOND_BRAIN_VAULT to your own vault. Set it first, or you get a second folder next to your notes.
  • Saved answers: second-brain writes every answer to an outputs folder in the vault. If the vault is a git repository with a remote, it pulls before it works and pushes after it commits.
  • Obsidian CLI: it comes with the desktop app from installer 1.12.7. Switch it on under Settings, General, and keep the app open. Do not install the unrelated npm package of the same name.
  • Deleting: obsidian-cli can rename, move and delete notes. Deleted notes go to the trash unless you ask for a permanent delete.
  • Clipping: defuddle fetches a page with a plain request, so pages that only render with JavaScript can come back empty. For PDFs and Office files, the summarize skill in Armin Ronacher's pack converts them to Markdown.
  • Left out: Obsidian's obsidian-headless skill for Sync and Publish. It works with your account login and needs a paid subscription.
Review slipPack No. 31
  • Every skill file read in full
  • Pinned to a reviewed version
  • Author and licence on every card
  • Requirements and costs disclosed
  • No sponsored skills inside
Last reviewed
Nov 2026
Reviewed