Notes
Collect and process inline editing notes from chapters. Finds %%NOTE:%%, %%EDIT:%%, %%CHECK:%%, and %%CUT:%% markers.From its SKILL.md
npx -y skills add howells/fiction --skill notesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 23 stars23 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.1 KB, as published. Nobody here has run it
Scan chapters for inline editing notes and present them for processing.
Note Format
While reading your manuscript, add inline notes using Obsidian's comment syntax:
%%NOTE: observation or question%%
%%EDIT: specific change needed%%
%%CUT: text that should be removed%%
%%CHECK: continuity or fact to verify%%
These are invisible in Obsidian's reading view but visible when editing.
What This Does
- Greps all chapter files for
%%.*%%patterns - Extracts notes with chapter name and line number
- Groups by type (EDIT, NOTE, CHECK, CUT)
- Presents them for review or processing
Usage
/fiction:notes # List all notes across chapters
/fiction:notes 5 # List notes in chapter 5 only
/fiction:notes --process # Work through notes one by one
/fiction:notes --clear # Remove all processed notes
If arguments provided: $ARGUMENTS
Output Format
## Editing Notes
### EDIT (4 items)
- **Chapter 2, line 3:** damp wool repeated
- **Chapter 7, line 45:** awkward transition
- **Chapter 12, line 88:** unclear antecedent
- **Chapter 12, line 92:** word echo "silent/silence"
### CHECK (2 items)
- **Chapter 2, line 21:** was this asked in ch1?
- **Chapter 9, line 156:** timeline - is this before or after the party?
### NOTE (1 item)
- **Chapter 15, line 200:** consider expanding this moment
### CUT (1 item)
- **Chapter 3, line 67:** this paragraph feels redundant
Processing Modes
List Mode (default)
Shows all notes grouped by type. Good for getting an overview.
Process Mode (--process)
Works through notes one at a time:
- Shows the note with surrounding context (5 lines before/after)
- Offers options: Fix it, Skip, Delete note
- For EDIT/CUT: suggests specific changes
- For CHECK: investigates and reports findings
- Removes the
%%marker%%after processing
Clear Mode (--clear)
Removes all %%.*%% markers from chapters. Use after you've addressed everything.
When to Use
- During read-throughs: add notes as you spot issues
- Before revision: collect all notes to plan your editing session
- After revision: clear processed notes
Workflow
- Read chapters, adding
%%EDIT:%%,%%NOTE:%%, etc. as you go - Run
/fiction:notesto see everything collected - Run
/fiction:notes --processto work through them systematically - Run
/fiction:notes --clearwhen done
Implementation
When executing this command:
- Find all notes:
grep -rn '%%[A-Z]*:' chapters/*.md
-
Parse each match: Extract type, content, file, line number
-
Group by type: EDIT, NOTE, CHECK, CUT (and any others)
-
For --process mode:
- Read context around each note
- Present with options
- Apply changes if requested
- Remove the marker after processing
Related Commands
/fiction:edit— Automated line-level editing/fiction:review— Story and craft feedback/fiction:continuity— Cross-chapter consistency checks