Skip to content

gpsaggese/helpers / .claude/skills/bookmark.add

bookmark.add

Verified

Find the research idea or blog file related to given links and add a TODO

FileKindSize
SKILL.mdskill md2.0 KB
---
description: Find the research idea or blog file related to given links and add a TODO
model: haiku
---

# Goal
- Given one or more links `<LINKS>`, find the file(s) among the following that are
  related to each link, and add a TODO to the most related file:
  - `research/ideas/*.md`
  - `website/docs/blog/posts/*.md`
  ```text
  // TODO(gp): incorporate the link <LINK> to <TOPIC>
  ```

# Workflow

## Collect Material
- Read the title and content of each link in `<LINKS>` (use `WebFetch` if the URL
  alone is not descriptive enough to judge the topic)
- List all candidate files in the two dirs above

## Match Links to Files
- For each link, compare its topic with each candidate's title, headers, and first
  paragraph. Rank candidates by relevance
- Pick the single best match for each link
  - If several files are close, list them and ask the user which to use
  - If no file plausibly matches, do not force a match. Report it instead

## Add the TODO
- In the matched file, add one line:
  ```text
  // TODO(gp): incorporate the link <LINK> to <TOPIC>
  ```
  where `<TOPIC>` is a short description (under 15 words) of the relevant part of
  the link, e.g., a technique, a result, or a quote
- Placement:
  - If the file has a top-of-file `// TODO(gp): ...` block, add the new line as an
    adjacent line in that block
  - Otherwise, put it near the most related section, e.g., right above the relevant
    bullet point or paragraph
- Change no other content in the file
- If several links map to one file, add one TODO line per link

## Report
- For each link, print the file it was added to and the exact TODO line inserted
- Report any unmatched link explicitly. Do not skip it silently

# Verification
- [ ] Each link matches at most one file, with no forced or guessed match
- [ ] Each inserted line follows the exact `// TODO(gp): incorporate the link <LINK>
  to <TOPIC>` format
- [ ] No content other than the new TODO line(s) changed in the matched file
- [ ] The report lists every link with its target file or "not matched" status
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall