agentleFS
tejask0tejask0/agent-skills/obsidian-notes-from-images/SKILL.md

obsidian-notes-from-images

Skill0 starsChanged 4 months agoMITView on GitHub

Create comprehensive, structured Obsidian notes from images of slides, whiteboards, or handwritten notes. Use this skill when the user uploads or provides photos from a workshop, lecture, class, meeting, or conference and wants to turn them into organized Obsidian markdown notes. Trigger on phrases like "create notes from these images", "make obsidian notes from my photos", "turn these slides into notes", "I have photos from a workshop/class/lecture/meeting", or whenever the user provides multiple images of educational or meeting content alongside any mention of Obsidian, notes, or a vault. Also trigger when the user shares images and asks for "structured notes", "comprehensive notes", or "reference notes" even without explicitly mentioning Obsidian.

The file

Show its rules and text

We split this skill into the rules it gives an agent

15 rules. About 0 are common, 13 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask these questions upfront (all in one message, not one at a time):

    line 12
  2. Distinctive:

    If the user already answered any of these in their message, don't re-ask.

    line 19
  3. Distinctive:

    Read ALL uploaded images simultaneously in one turn (use parallel Read tool calls, up to 8 at a time).

    line 23
  4. Very specific:

    Use numbered sections (## 1.

    line 94
  5. Distinctive:

    Use tables for comparisons, pros/cons, step-by-step processes with multiple attributes

    line 95
  6. Distinctive:

    Use blockquotes for direct quotes, key rules, and memorable one-liners

    line 96
  7. Distinctive:

    Use bold for terms being defined or concepts being introduced

    line 97
  8. Very specific:

    Use [[wikilinks]] to link to other notes in the vault when referencing related concepts

    line 98
  9. Distinctive:

    When embedding images, use Obsidian's syntax and reference the assets subfolder you'll create:

    line 102
  10. Distinctive:

    If the user asked for multiple notes (e.g.

    line 132
  11. Distinctive:

    Write the note directly to the vault path using the Write tool.

    line 151
  12. Distinctive:

    After saving, tell the user:

    line 155
  13. Distinctive:

    Don't create orphan sections: Every section should have actual content.

    line 164
  14. Distinctive:

    Don't make up content: If an image is blurry or unreadable, say so briefly and move on.

    line 165
  15. Distinctive:

    Do ask if you're unsure about structure: If the images span what looks like multiple distinct topics or sessions, quickly confirm with the …

    line 166

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Obsidian Notes from Images

You are helping the user turn images (photos of slides, whiteboards, handwritten notes) into dense, comprehensive Obsidian-formatted markdown notes saved directly into their vault.

Step 1 — Gather context before reading anything

Ask these questions upfront (all in one message, not one at a time):

  1. Topic / Title — What is this content about? (e.g. "Startup Cohort Day 1", "Team Strategy Meeting", "ML Lecture 4")
  2. Save location — Where in the Obsidian vault should the notes go? (e.g. Workshops/<event name>/ or just Inbox/) — remind them the vault root is shown in the project instructions if they're unsure
  3. Structure — Should this be one note or multiple notes? If they have images from distinct sessions/days, one note per session is usually cleaner
  4. Image embedding — Should slide/whiteboard images be embedded inline in the notes with ![[...]] syntax? (Handwritten notes are almost always worth embedding; slides are useful only if the slide itself is hard to summarise in text)

If the user already answered any of these in their message, don't re-ask. Use good judgment — if they gave you 20 photos from a single workshop, propose one note unless the content clearly spans multiple distinct topics.

Step 2 — Read all images in parallel

Read ALL uploaded images simultaneously in one turn (use parallel Read tool calls, up to 8 at a time). Don't read them one by one — it's slow and you lose the big picture.

As you read, mentally categorise each image:

  • Slide photo — projected presentation slides (usually clean, text-heavy)
  • Whiteboard photo — diagrams, frameworks drawn live
  • Handwritten notes — personal notes, often dense with arrows and abbreviations
  • Room/context photo — wide shots of the room, not useful for content

Slides and whiteboards are your primary content source. Handwritten notes often contain insights, personal reactions, and connections that aren't in the slides — capture these too, clearly attributed. Room photos can be skipped.

Step 3 — Synthesise, don't transcribe

Your job is to produce dense reference notes, not a raw transcript. This means:

  • Synthesise slide content + handwritten notes into unified sections. Don't list them separately.
  • Extract the frameworks — if a slide shows a 3-step model, present it as a structured table or numbered list, not "the slide said step 1 is X"
  • Preserve specific data points — statistics, formulas, names, book titles, company examples. These are the things the user will actually look up later.
  • Flag key insights using Obsidian blockquotes (> key insight here) — especially for contrarian or memorable points
  • Skip filler — don't include slide titles that just say "Agenda" or photos of the presenter if they contain no information

The goal: a cohesive expert write-up of the session, as if written by a knowledgeable participant who was there and wants to remember everything.

Step 4 — Write the Obsidian note(s)

Note structure

---
date: YYYY-MM-DD
tags: [relevant, tags, here]
---

# [Title]
**Date:** [date] | **Presenter(s):** [names if visible/mentioned]

---

## Overview
[2-4 sentence summary of what this session covered]

---

## 1. [First major topic]

[Content...]

---

## 2. [Second major topic]

[Content...]

...

---

## Resources
[Books, tools, links mentioned]

---

## Key Takeaways
[5-8 bullet points — the most important things to remember]

---

*See also: [[linked note]] | [[other note]]*

Formatting rules

  • Use numbered sections (## 1. Topic) so the structure is scannable
  • Use tables for comparisons, pros/cons, step-by-step processes with multiple attributes
  • Use blockquotes for direct quotes, key rules, and memorable one-liners
  • Use bold for terms being defined or concepts being introduced
  • Use [[wikilinks]] to link to other notes in the vault when referencing related concepts

Image embedding

When embedding images, use Obsidian's syntax and reference the assets subfolder you'll create:

![[Note Name assets/IMG_filename.jpg]]

Embed images inline, at the END of the section they illustrate — after the text and tables, not before. The text comes first so the reader has context before seeing the image. Never place an image at the very top of a section before any explanatory content.

Embed an image when:

  • It's a diagram, framework, or whiteboard drawing that's hard to fully describe in text
  • It's a data-rich slide (charts, tables, complex layouts)
  • It's handwritten notes that supplement the typed content meaningfully

Skip embedding:

  • Blurry or low-information photos
  • Slides that are fully captured in the text already
  • Wide room shots

Step 5 — Set up files and assets in the vault

File structure to create

[vault root]/[save location]/
├── [Note Title].md          ← the note(s)
└── [Note Title] assets/     ← images folder (only if embedding images)
    ├── IMG_xxx.jpg
    └── IMG_yyy.jpg

If the user asked for multiple notes (e.g. Day 1, Day 2), create:

[save location]/
├── Day 1 - [Topic].md
├── Day 1 assets/
├── Day 2 - [Topic].md
└── Day 2 assets/

Copying images to the vault

Uploaded images arrive at the uploads path (visible in your system environment). Copy only the images you're embedding to the assets folder using bash. Do NOT copy every image — only the ones that appear in the note with ![[...]].

cp "/path/to/uploaded/IMG_xxx.jpg" "/path/to/vault/Note assets/IMG_xxx.jpg"

Saving the note

Write the note directly to the vault path using the Write tool. The workspace folder path is shown in your system instructions — use it.

Step 6 — Confirm and offer next steps

After saving, tell the user:

  • Which files were created and where
  • How many images were embedded vs skipped
  • Offer to create a PDF export (text-only or with images) if they want to share the notes

Common pitfalls to avoid

  • Don't describe images, extract from them. "The slide shows a blue chart with three bars" is useless. "Revenue grew 3× from 2022 to 2024" is useful.
  • Don't lose handwritten notes. They often contain the most valuable insights — personal reactions, connections to other ideas, questions raised. Capture them.
  • Don't create orphan sections. Every section should have actual content. If a slide was just a title card, skip it.
  • Don't make up content. If an image is blurry or unreadable, say so briefly and move on. Don't guess at text you can't make out.
  • Do ask if you're unsure about structure. If the images span what looks like multiple distinct topics or sessions, quickly confirm with the user before writing.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.