guide-from-screenshots

Generate a Notion-compatible markdown guide from screenshots and narrative.

2|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/mostafa-drz/claude-skills --skill guide-from-screenshots
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guide-from-screenshots
Source: https://github.com/mostafa-drz/claude-skills/tree/main/code/guide-from-screenshots
Command: npx skills add https://github.com/mostafa-drz/claude-skills --skill guide-from-screenshots

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert scattered screenshots and narrative into a cohesive, Notion-friendly markdown guide, saving time and ensuring a polished presentation.

Core Features & Use Cases

  • Automatically reads a directory of screenshots and narrative to assemble a logical guide.
  • Filters out duplicates and irrelevant captures, organizing images by flow.
  • Generates a Notion-compatible markdown document with image placeholders and structured sections for product guides, demos, or tool overviews.

Quick Start

Supply the folder of screenshots and run the guide-from-screenshots skill to generate a Notion-friendly markdown guide.

Frequently Asked Questions about guide-from-screenshots

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a folder of screenshots into a Notion-compatible markdown guide?

You can generate a markdown guide by supplying a directory of screenshots and narrative, which automatically detects image files, filters duplicates, and outputs a Notion-ready GUIDE.md with structured sections.

What is the best way to organize scattered product screenshots into a structured document?

Organizing screenshots into a structured document is done by reading a directory of images, filtering irrelevant captures, sequencing them by flow, and generating a markdown file with image placeholders for product demos or tool overviews.

Can I customize the output filename when generating a Notion-ready markdown guide from images?

Yes, you can customize the output filename when generating a markdown guide; the skill defaults to creating a file named GUIDE.md but supports optional output customization for your Notion-compatible document.

Does the markdown guide generation process filter out duplicate screenshots automatically?

Yes, the markdown guide generation process automatically filters out duplicate screenshots and irrelevant captures, organizing the remaining valid images by logical flow before embedding references into the Notion-ready document.

How do I create a step-by-step product demo guide using markdown and screenshots?

Creating a step-by-step product demo guide involves pointing the generator at a folder of screenshots and narrative, which then reads the images, sequences them, and writes a polished markdown guide with image placeholders.

What limitations exist when converting screenshots to markdown for Notion?

Limitations when converting screenshots to markdown include relying on sequential image detection via Glob and Read, meaning narrative context must be supplied alongside images to ensure accurate logical flow and section structuring.