create-scratch

Create scratch notes with unique IDs in the .agents/scratches directory.

1.8k|62|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/LibPDF-js/core --skill create-scratch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-scratch
Source: https://github.com/LibPDF-js/core/tree/main/.opencode/skills/create-scratch
Command: npx skills add https://github.com/LibPDF-js/core --skill create-scratch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps you quickly create organized scratch notes in the .agents/scratches directory, reducing friction for ideas, explorations, and temporary draft content.

Core Features & Use Cases

  • Automatic frontmatter: Generates a frontmatter block with the current date and a properly formatted title.
  • Unique ID + slug naming: Produces a unique three-word ID and saves files as {id}-{slug}.md.
  • Flexible content input: Accepts direct content, multi-line heredoc, or piped input to populate the scratch file.
  • Use Case: Capture quick ideas during conversations and store them for later reference without clutter.

Quick Start

To create a scratch file, run bun scripts/create-scratch.ts "<slug>" "<Your scratch content here>" Option 2: Multi-line Content: bun scripts/create-scratch.ts "<slug>" << HEREDOC Your multi-line scratch content HEREDOC Option 3: Pipe Content: echo "Your content" | bun scripts/create-scratch.ts "<slug>"

Frequently Asked Questions about create-scratch

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

FAQPage Schema
How do I create ephemeral markdown notes with auto-generated frontmatter?

To create ephemeral markdown notes with auto-generated frontmatter, run the create-scratch script. It automatically adds the current date and a formatted title to the frontmatter block before saving the file in the .agents/scratches/ directory.

Can I use a heredoc or pipe to pass multi-line content to a markdown scratch file?

Yes, you can use a heredoc or pipe to pass multi-line content to a markdown scratch file. The script accepts direct content, multi-line heredoc, or piped input to populate the scratch file seamlessly.

What is the best way to generate unique IDs for temporary draft files?

The best way to generate unique IDs for temporary draft files is using an automated script that produces a unique three-word ID. It formats the title from the slug and saves the file as {id}-{slug}.md to ensure consistent naming.

Does this scratch file automation require any external dependencies to run?

No, this scratch file automation does not require any external dependencies to run. The script operates independently to create organized scratch notes, reducing friction for ideas, explorations, and temporary draft content.

Why use a dedicated .agents/scratches/ directory for quick drafts?

Using a dedicated .agents/scratches/ directory for quick drafts prevents clutter by isolating ephemeral notes. This ensures temporary exploration logs and ideas are stored consistently for later reference without disorganizing your main workspace.