import-notes

/import-notes — Import Timecoded Notes as Markers

Paste client feedback, director's notes, or review comments with timecodes and automatically create markers on the current timeline.

Arguments

The user pastes their notes directly after the command. The notes can be in any common format — the skill parses them flexibly.

Supported Formats

Parse these timecode formats (be flexible, editors use all of them):

Marker Color Mapping

Automatically assign marker colors based on note content keywords:

Workflow

1. Use resolve_get_timeline_info to get fps and timeline name
2. Parse each note line to extract:
   • Timecode (convert to frame number using timeline fps)
   • Note text (everything after the timecode)
   • Color (from keyword matching above)
3. For each note, use resolve_add_marker_at with:
   • frame: calculated frame number
   • color: auto-detected color
   • name: first ~40 chars of note text (truncated for marker name field)
   • note: full note text
   • duration: 1 frame
4. Report: "Added X markers to timeline '[name]'" with a summary by color

Example Interactions

User:

/import-notes
01:02:15 — fix this transition, too abrupt
01:05:30 — love this shot, keep it
01:08:00 — need VFX cleanup on the background
01:12:45 — audio levels drop here
01:15:00 — general note: consider a different song

→ Parses 5 notes, creates Red/Green/Purple/Cyan/Blue markers respectively.

User:

/import-notes
[00:30] cut feels slow
[01:15] great energy here
[02:00] needs a lower third

→ Parses MM:SS format, creates 3 markers.