create-scratch
Create a new scratch file in .agents/scratches/ with a unique three-word ID, frontmatter, and formatted title
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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:
npx tsx scripts/create-scratch.ts "note-name" "Scratch content here"
Or use heredoc for multi-line content:
npx tsx scripts/create-scratch.ts "note-name" << HEREDOC
Multi-line
scratch content
goes here
HEREDOC
File format
Files are created as: {three-word-id}-{slug}.md
Example: calm-teal-cloud-note-name.md
The file includes frontmatter:
---
date: 2026-01-13
title: Note Name
---
Your 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.
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-28
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!