add-scrap

# Add Scrap

Create a new scrap with Wiki-link notation.

## Arguments

- **title**: `$ARGUMENTS` - Title of the scrap to create
- **max-lines**: (optional) - Maximum number of lines for the generated scrap

## Workflow

1. **Understand the Request**
   - Ask clarifying questions if the content is unclear
   - Identify the context folder if applicable

2. **Research the Topic**
   - Use `WebSearch` to gather information about the topic

3. **Research Existing Tags**
   - Use `list_tags` to get available tags
   - Identify tags relevant to the topic

4. **Search Related Scraps**
   - Use `search_scraps` to find related content
   - **NEVER create Wiki-links that were not returned by `search_scraps`. If a scrap is not in the results, it does not exist.**
   - Identify scraps that should link to the new scrap

5. **Create the Scrap**
   - **Only use Wiki-links to scraps found in step 4. Do not link to anything else.**
   - Write well-structured Markdown content following the syntax below

6. **Suggest Backlinks**
   - List existing scraps that should add links to this new scrap

## Wiki-Link Syntax

- `[[Page Name]]` - Normal link. Use `title` from `search_scraps` results.
- `[[Page Name|Display Text]]` - Alias link with custom display text.
- `[[Context/Page Name]]` - Context link. Use `ctx/title` from `search_scraps` results.
- `#[[Tag Name]]` - Tag. Use tags from `list_tags` results only.

## Markdown Features

- CommonMark specification
- GitHub-flavored Markdown (tables, task lists, strikethrough)
- Mermaid diagrams with `mermaid` code blocks
- Autolinks for OGP cards: `<https://example.com>`