gpsaggese/helpers / .claude/skills/bookmark.add
bookmark.add
VerifiedFind the research idea or blog file related to given links and add a TODO
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/*.mdwebsite/docs/blog/posts/*.md
// TODO(gp): incorporate the link <LINK> to <TOPIC>
Workflow
Collect Material
- Read the title and content of each link in
<LINKS>(useWebFetchif 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:
where// TODO(gp): incorporate the link <LINK> to <TOPIC><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
- If the file has a top-of-file
- 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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 114k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| 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: 114k | Updated | Claude CodeCodex | Verified | Install |
| 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: 114k | Updated | Claude CodeCodex | Verified | Install |