paste

Parse macOS clipboard contents into structured text, image, file, and URL data.

Updated Sep 4, 2025
One-click install
npx skills add https://github.com/ykai55/dotfiles --skill paste
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paste
Source: https://github.com/ykai55/dotfiles/tree/main/opencode/skills/paste
Command: npx skills add https://github.com/ykai55/dotfiles --skill paste

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires clipboard-read.

What problem does it solve?

It helps you turn uncertain clipboard contents into actionable, structured data without manually copying, guessing formats, or risking unintended sensitive exposure.

Core Features & Use Cases

  • Secure clipboard reading with explicit user intent: Reads the current macOS clipboard only when the user explicitly asks to check or use what they copied.
  • Multi-format parsing into structured JSON: Detects and returns clipboard items as text, images, files/folders, or URLs for downstream analysis.
  • Image export for later analysis: Exports clipboard images to a temporary directory so the image can be analyzed by subsequent tools.

Quick Start

Ask the AI to check what is currently in your clipboard and summarize the detected text, files, image path, or URL.

Frequently Asked Questions about paste

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

FAQPage Schema
How do I parse macOS clipboard contents into structured JSON?

You can parse macOS clipboard contents into structured JSON by running clipboard-read with pretty output, which detects and returns items categorized as text, image paths, file lists, or URLs.

Can I extract image paths from a Mac clipboard screenshot?

Yes, you can extract image paths from a Mac clipboard screenshot. The tool exports clipboard images to a temporary directory, generating an accessible file path so the image can be analyzed by subsequent tools.

Does clipboard parsing work with Finder file and folder selections?

Yes, clipboard parsing works with Finder file and folder selections. It detects copied Finder selections and parses them into structured file lists, making them immediately available for analysis.

How do I safely read sensitive URLs from the clipboard without unintended exposure?

To safely read sensitive URLs from the clipboard, the tool applies explicit user intent checks, ensuring it only reads clipboard contents when you explicitly request to view or use what you just copied.

What happens when I try to parse an empty macOS clipboard?

When you try to parse an empty macOS clipboard, the tool safely handles the empty state by returning a structured response indicating no clipboard contents were detected, preventing processing errors.