Create Scratch

Create organized scratch files with unique IDs and structured metadata

✨ The solution you've been looking for

Verified

Tested and verified by our team

12178 Stars

Create a new scratch file in .agents/scratches/ with a unique three-word ID, frontmatter, and formatted title

scratch-files note-taking file-organization automation workflow documentation typescript

Repository

See It In Action

Interactive preview & real-world examples

Live Demo

AI Conversation Simulator

See how users interact with this skill

User Prompt

Create a scratch file called 'meeting-notes' with the content from today's standup discussion

Skill Processing

Analyzing request...

Agent Response

A new markdown file in .agents/scratches/ with unique ID, frontmatter, and your content

Quick Start (3 Steps)

Get up and running in minutes

Install

claude-code skill install create-scratch

claude-code skill install create-scratch

Config

First Trigger

@create-scratch help

Commands

Command	Description	Required Args
@create-scratch quick-note-creation	Create a temporary note for capturing ideas or meeting notes	None
@create-scratch multi-line-documentation	Store complex documentation or code snippets for later reference	None
@create-scratch exploration-documentation	Document research findings or exploration results with automatic organization	None

Typical Use Cases

Quick Note Creation

Create a temporary note for capturing ideas or meeting notes

Multi-line Documentation

Store complex documentation or code snippets for later reference

Exploration Documentation

Document research findings or exploration results with automatic organization

Overview

What I do

I help you create new scratch files in the .agents/scratches/ directory. Each scratch file gets:

A unique three-word identifier (e.g., calm-teal-cloud)
Frontmatter with the current date and formatted title
Content you provide

How to use

Run the script with a slug and content:

1npx tsx scripts/create-scratch.ts "note-name" "Scratch content here"

Or use heredoc for multi-line content:

1npx tsx scripts/create-scratch.ts "note-name" << HEREDOC
2Multi-line
3scratch content
4goes here
5HEREDOC

File format

Files are created as: {three-word-id}-{slug}.md

Example: calm-teal-cloud-note-name.md

The file includes frontmatter:

1---
2date: 2026-01-13
3title: Note Name
4---
5
6Your content here

When to use me

Use this skill when you need to create a temporary note, exploration document, or scratch pad for ideas. The unique ID ensures no filename conflicts, and the frontmatter provides metadata for organization.