| name | second-brain-edit-wiki |
| description | Apply targeted edits to one or more wiki articles from a natural-language instruction, preserving structural invariants. |
| argument-hint | "<edit_prompt>" [<slug>] |
| user-invocable | true |
Second Brain — Wiki Edit
Apply targeted edits to one or more wiki articles based on a natural-language instruction, while preserving all structural invariants.
Input
/second-brain-edit-wiki "<edit_prompt>" [<slug>]
edit_prompt — free-text description of the edit to apply (required)slug — kebab-case wiki article filename without .md (optional)
- If provided, the edit is applied only to that article
- If omitted, the skill reads
wiki/INDEX.md and infers which article(s) to edit from the prompt
Execution Steps
Step 1 — Parse and validate
- Extract
edit_prompt from the first quoted argument.
- Extract optional
slug from the second quoted argument.
- If
slug is provided, verify wiki/<slug>.md exists. If not, stop with:
✗ Article not found: wiki/<slug>.md
Step 2 — Identify target article(s)
If slug is provided: target is wiki/<slug>.md only.
If slug is omitted:
- Read
wiki/INDEX.md to get the full list of topics and their one-line summaries.
- Scan the
edit_prompt for article names, topic references, or contradiction descriptions (e.g. "company-overview", "revenue figure", "headcount data").
- Match against INDEX entries. Select all articles that are plausibly relevant to the edit.
- If no match is found, stop with:
✗ Could not determine which article to edit from: "<edit_prompt>"
Hint: re-run with an explicit slug, e.g. /second-brain-edit-wiki "<prompt>" company-overview
Step 3 — Apply edits
For each target article:
- Read the current content of
wiki/<slug>.md.
- Apply the edit described in
edit_prompt. Use good judgement to make the minimal, targeted change that satisfies the instruction.
- Preserve all invariants:
- Summary paragraph — must remain the first paragraph after the
# Heading. Never remove, replace with headings, or reorder.
- Sources footer — the
---\n*Sources: ...* block at the end must remain byte-for-byte unchanged. Never modify, remove, or add to source references.
- Wikilinks — all existing
[[wikilinks]] must be preserved. You may add new ones; never remove without an explicit instruction to do so.
- Section structure — preserve all
## Headings and their order unless the edit explicitly requires restructuring.
- Write the updated content back to
wiki/<slug>.md.
Step 4 — Confirm
Output one status line per article edited:
✓ wiki/company-overview.md — Updated revenue figure in summary: "$120M" → "$134M (2024 actual)"
✓ wiki/product-strategy.md — Corrected launch date from Q3 to Q4 in Key Milestones section
For errors use ✗ prefix with a brief reason.
Invariants
- Never delete or rename wiki articles
- Never modify any file in
raw/
- Never alter the Sources footer
- Never write to
raw/edits/ or any other staging location — edits are in-place only
- If the edit would require creating a new wiki article, note it in output but do not create it (suggest running
/second-brain-ingest instead)
