$ ~/registry/skill/microsoft-agency-plugins-nori-skills-using-screenshots

SKILL

using-screenshots

Name: using-screenshots
Author: microsoft

Capture screen context so AI can better understand your current interface.

Stars

★ 4,934

Source

GitHub

Updated

2026-07-14

// securityLow risk

Prompt only, no code
Open source
Community-trusted· 4.9k

Running security audit…

Credentials
Network egress
Code execution
Data access
Supply chain

// install

Copy the install command and let the AI configure it · recommended for beginners

Please install the "using-screenshots" skill from askskill:
1. Download https://raw.githubusercontent.com/microsoft/FluidFramework/main/.agency/plugins/nori/skills/using-screenshots/SKILL.md
2. Save it as ~/.claude/skills/using-screenshots/SKILL.md
3. Reload skills and tell me it's ready

// download

Download SKILL.mdInstall manifest ↗

// examples

Report a UI issue

Prompt

I will provide a screenshot of the current page. Identify the UI issues from the screenshot and summarize possible causes and improvement suggestions.

Expected

An analysis of UI issues from the screenshot, with likely causes and improvement recommendations.

Explain an error screen

Prompt

I will upload an error screenshot. Extract the key details, explain what the error means, and tell me what to check next.

Expected

An explanation of the error shown in the screenshot and clear troubleshooting steps.

Summarize page content

Prompt

I will provide a screenshot of a page. Summarize the main content, layout, and actions the user can take.

Expected

A concise summary of the page content, layout, and available actions shown in the screenshot.

// docs

Taking and Analyzing Screenshots

Overview

You CAN take screenshots by combining the Bash tool with platform-specific screenshot commands. Screenshots are saved as image files, then loaded into your context using the Read tool for visual analysis.

When to Use

Use this skill when I ask you to:

"Take a screenshot"
"Look at my screen"
"Analyze this UI bug visually"
"Review what's currently displayed"
"Capture and examine the interface"

Quick Reference

Platform	Command	Interactive Selection
macOS	`screencapture`	`-i` flag (area selection)
Linux	`gnome-screenshot`, `scrot`, or `import`	`-a` or `-s` flag

Standard workflow:

Detect platform with uname -s
Check for available screenshot tool
Capture to /tmp/screenshot_$(date +%s).png
Use Read tool with the file path
Analyze the image
Optionally clean up temp file

Step-by-Step Instructions

1. Detect Platform

uname -s

Returns Darwin for macOS
Returns Linux for Linux

2. Check Available Tools

macOS: screencapture is always available (built-in)

Linux: Check in priority order:

which gnome-screenshot || which scrot || which import || echo "none"

Priority order (best compatibility):

gnome-screenshot - works on both X11 and Wayland
scrot - lightweight, X11 only
import - part of ImageMagick

3. Capture Screenshot

Use timestamped filename to avoid conflicts:

macOS:

screencapture -i /tmp/screenshot_$(date +%s).png

-i enables interactive area selection
User clicks and drags to select region

Linux with gnome-screenshot:

gnome-screenshot -af /tmp/screenshot_$(date +%s).png

-a for area selection
-f specifies filename

Linux with scrot:

scrot -s /tmp/screenshot_$(date +%s).png

-s enables selection mode

Linux with import:

import /tmp/screenshot_$(date +%s).png

Provides crosshair for click-and-drag selection

4. Load Image into Context

Read tool: file_path="/tmp/screenshot_12345.png"

The Read tool displays images visually. You'll see the screenshot and can analyze it.

5. Analyze the Image

Once loaded, you can:

Identify UI elements
Spot visual bugs
Review design elements
Read text content
Examine layout issues

6. Optional Cleanup

rm /tmp/screenshot_12345.png

Only remove if I won't need the file again.

Handling Missing Tools

If no screenshot tool is available on Linux:

Inform me which tool is missing
Suggest installation:
- Ubuntu/Debian: sudo apt install gnome-screenshot
- Fedora: sudo dnf install gnome-screenshot
- Arch: sudo pacman -S gnome-screenshot
- ImageMagick: sudo apt install imagemagick (or equivalent)
Alternative: Ask user to manually take screenshot and provide path

Common Mistakes

❌ Saying "I cannot take screenshots"

Reality: You CAN via Bash + screenshot CLI tools

❌ Forgetting to use Read tool after capture

Reality: The screenshot file must be loaded with Read tool to see it

❌ Using relative paths

Reality: Always use absolute paths (/tmp/...) for Read tool

❌ Not checking for available tools on Linux

Reality: Must detect which tool is installed before attempting capture

Example Workflow

User: "Take a screenshot and help me debug this UI bug"

1. Check platform:
   uname -s → Linux

2. Check available tools:
   which gnome-screenshot → /usr/bin/gnome-screenshot

3. Capture screenshot:
   gnome-screenshot -af /tmp/screenshot_1729012345.png
   → User selects area, file saved

4. Load into context:
   Read: file_path="/tmp/screenshot_1729012345.png"
   → Image displays visually

5. Analyze:

…

View full docs ↗