| name | faerie-fire |
| description | Faerie Fire marks things that are already known. It does not search, discover, explain, translate, or fix. The user has already identified what matters; your job is to make those items impossible to overlook by annotating, tagging, highlighting, or visually surfacing them in context. |
| user-invocable | true |
Faerie Fire
Make hidden things visible by highlighting, tagging, and marking them for attention.
Overview
Faerie Fire is interpreted here as a metaphorical spell with a shipping-now execution model.
Canonical source: Faerie Fire (spell)
Provider target: OpenClaw
When To Use
- "Highlight", "tag", "mark", "annotate", "call out", "flag" applied to specific items the user has already named or located
- "Make X visible" where X is a known set of findings, clauses, functions, tickets, or features
- "Show me where [specific thing] appears" — location surfacing, not discovery
- "Annotate", "add margin notes", "color-code", "produce a summary table of marked items"
- The user provides the target list and asks you to apply markers to a document, codebase, dataset, or diagram
Workflow
- Confirm the target set: Restate what the user wants marked. If the list is implicit, extract it explicitly before annotating.
- Choose the marking strategy based on the medium:
- Code: inline comments, // HIGHLIGHT: markers, or extracted function lists with file:line references
- Documents: bold/underline, margin notes, or a findings table with clause references
- Data/tables: tagged rows, conditional formatting descriptions, or filtered views
- Diagrams: callout labels, numbered annotations, or a legend mapping marks to gaps
- Apply markers with context: Every mark must include why the item was flagged, not just that it was flagged. A marker without rationale is noise.
- Deliver two artifacts: the annotated source and a concise summary listing what was marked and the selection criteria.
Deliverables
- An annotated version of the source material with key findings highlighted and marked.
- A summary of what was highlighted and why each item warrants attention.
Guardrails
- Be selective. Highlighting everything is highlighting nothing. If the user gives you 200 items, ask them to narrow or apply a ranking.
- Never claim to have discovered something you were not asked to mark. Faerie Fire illuminates; it does not hunt.
- If the request mixes marking with fixing, translating, or explaining, scope yourself to marking only and note the boundary.
- Do not use for: Scanning/searching: "Find all hidden webhooks", "Scan for MCP servers" — the user is asking you to discover, not mark. Use a detection spell instead.
- Do not use for: Explaining: "Explain what this manifest does", "What does this code do?" — comprehension, not annotation.
- Do not use for: Translating: "Translate from German to English" — language conversion, not highlighting.
- Do not use for: Rewriting: "Rewrite for executives", "Simplify this report" — transformation, not marking.
- Do not use for: Fixing: "Highlight the risky parts and fix them" — Faerie Fire only marks; it does not remediate. Decline the fix portion or route it to a separate spell.
- Do not use for: Vague requests: "Highlight the important stuff" with no criteria — ask the user what "important" means before proceeding.
Default Invocation
Use $faerie-fire to highlight the most important [findings/patterns/elements] in this [document/codebase/dataset] so they cannot be overlooked.
