Menu
Use when cleaning up a specific note or before promoting it — runs atomicity, link, and title checks. Load with `nn skills get nn-refine`.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Use when you need to look up an nn command, flag, or usage pattern. Load with `nn skills get nn-guide`.
Use when after nn new or nn update to discover notes that should be linked to the modified note. Load with `nn skills get nn-link-suggester`.
Use when ending a session to consolidate captures, assess promotion eligibility, and update the daily page. For weekly review use --weekly; for daily page only use --daily; for lightweight mid-session capture use --partial. Load with `nn skills get nn-session-debrief`.
Use when asked to organise, capture, or link notes in the Zettelkasten. Load with `nn skills get nn-workflow`.
Use when about to take any action that introduces new information not already in the conversation. Load with `nn skills get nn-capture-discipline`.
Use when running a hygiene pass across multiple notes at once — drafts, orphans, long notes, or a topic cluster. Load with `nn skills get nn-refine-workflow`.
| name | nn-refine |
| description | Use when cleaning up a specific note or before promoting it — runs atomicity, link, and title checks. Load with `nn skills get nn-refine`. |
| when_to_use | After nn show <id> when you want to clean up a specific note, or before considering a note for promotion. Invoke with /nn-refine. |
Single-note hygiene: atomicity check, link suggestions, promotion eligibility, and title check.
Invoke after nn show <id> when you want to clean up a specific note. Run this skill on any draft note before considering it for promotion, or on any note that has grown stale.
Does the note body contain more than one independent claim?
nn show <id>
If yes — the note is not atomic. Propose a split:
nn new --title "<claim 2>" --type <type> --content "<extracted body>" --no-editnn link <new-id> <original-id> --annotation "split from" --type refinesnn update <original-id> --content "<remaining body>" --no-editA note is atomic when removing any sentence would leave only one coherent claim.
Run the link suggester to surface candidate connections:
nn suggest-links <id> [--limit 20]
Review candidates and propose nn link or nn bulk-link commands. Every link requires --annotation and --type. See nn-link-suggester for the full workflow.
A note is eligible for promotion when:
nn backlinks <id> to check)draft or reviewedIf eligible, propose:
nn promote <id> --to reviewed # draft → reviewed (errors on concurrent conflict)
nn promote <id> --to permanent # reviewed → permanent (errors on concurrent conflict)
Or use direct assignment:
nn update <id> --status reviewed --no-edit
nn update <id> --status permanent --no-edit
Does the title name the single claim in the body? A good title is a complete, falsifiable assertion or a precise concept label.
If not, propose:
nn update <id> --title "Better title that names the claim" --no-edit
nn show <id>
nn suggest-links <id> [--limit N]
nn new --title "..." --type <type> --content "..." --no-edit
nn link <from> <to> --annotation "..." --type TYPE
nn bulk-link <from> --to <id> --annotation "..." --type TYPE [--to <id> ...]
nn backlinks <id> [--json]
nn promote <id> --to reviewed|permanent # errors on concurrent modification conflict
nn update <id> [--title "..."] [--content "..."] [--status STATUS] --no-edit
nn list --long --json
nn suggest-links was run and candidate links were reviewed