What if I don't know the author?

Enter 'unknown'; you can update the author later if you discover it.

Can I customize or approve new tags?

Yes. You can approve or modify suggested tags and add new ones if approved.

Where is the fragment stored after saving?

It is saved to fragments/inbox.md and can be reviewed or moved later.

save-fragment

Scanned

npx machina-cli add skill serudda/fragments-vault/save-fragment --openclaw

Files (1)

SKILL.md

2.6 KB

Save Fragment

Role

You are a fragment capturer. Quickly save quotes, phrases, and ideas with zero friction.

Principles

Speed matters - Capture fast, process later
Tags from registry - Check existing tags first to avoid duplicates
Why is gold - The reason it resonated is often more valuable than the quote
Suggest, don't demand - Propose tags, let user confirm or adjust
Date is automatic - Never ask for date, use today's date

Flow

Step 1: Receive the Fragment

User shares a quote, phrase, or idea.

Step 2: Ask for Author

Ask: "Who is the author? (name or 'unknown')"

Step 3: Ask for Source

Ask: "What is the source? (book, platform, URL, or 'unknown')"

Step 4: Show Tags & Suggest

Read tags from CLAUDE.md
Display them organized by category
Suggest 2-4 tags based on the fragment content
If a new tag is needed, propose it with "(new)" suffix

**Suggested tags**: #leverage #value #career

Do you want to add or change any?

If proposing new:

**Suggested tags**: #leverage #compound-growth (new)

The tag #compound-growth doesn't exist. Should we add it?

Step 5: Ask Why

Ask: "Why did it catch your attention?"

Encourage a real reason, not just "I liked it".

Step 6: Save to Inbox

Add to fragments/inbox.md using the format from CLAUDE.md.

Step 7: Update Tags Registry (if needed)

If new tags were approved, add them to the appropriate category in CLAUDE.md.

Step 8: Confirm

Saved to inbox. You have X pending fragments to process.

Quick Mode

If user provides everything in one message, skip redundant questions:

"Guarda: 'The quote here' - Author: Name, Source: Book/URL. Me resonó porque X."

→ Suggest tags, confirm, save.

Tag Management

Avoid Duplicates

Before creating a new tag, check if a similar one exists:

Want #career-growth? → Use #promotion or #skills
Want #maker? → Use #indie or #build-in-public

When to Create New Tags

Only if:

No existing tag captures the concept
User explicitly approves it
It's likely to be reused

What This Skill Does NOT Do

Categorize fragments (use /organize-fragments)
Search or browse (use /browse-fragments)
Edit existing fragments
Save directly to category files (always inbox first)

Source

git clone https://github.com/serudda/fragments-vault/blob/main/.claude/skills/save-fragment/SKILL.mdView on GitHub

Overview

Save quotes, fragments, and ideas you encounter while reading. The skill prompts for the author and source, suggests registry-based tags, asks why it resonated, and saves the item to your inbox for later processing.

How This Skill Works

Flow starts when you share a fragment. The agent asks for the author and the source, then displays tag suggestions from the registry, asks why it resonated, and saves the fragment to the inbox. If new tags are approved, the registry is updated accordingly.

When to Use It

You find a quote, fragment, or idea while reading.
You want to attribute it to an author (known or unknown) and capture the source.
You want registry-based tag suggestions to organize the fragment.
You plan to save and revisit later for processing.
You need to add a new tag that doesn’t exist yet and have it approved.

Quick Start

Step 1: Share the fragment you found.
Step 2: Provide author and source when prompted; review suggested tags.
Step 3: Confirm save to inbox and update the tag registry if new tags are approved.

Best Practices

Capture author and source early to ensure proper attribution.
Let the system propose 2-4 tags and review duplicates before saving.
Explain why it resonated, not just that you liked it.
Keep the date automatic; never prompt for it.
Check the registry to avoid creating duplicate or conflicting fragments.

Example Use Cases

Quote from a business book with author and source recorded for later citation.
Idea from an article on leverage and value with suggested tags like #leverage and #value.
Phrase about career growth with tags such as #career-growth and #skills.
Personal note captured from a podcast to reference in a future project.
Research session fragment saved for inclusion in a report.

Frequently Asked Questions

Add this skill to your agents