Add an item to the highlights page. Max 1 per day.
Add a notable item to the public highlights (What's New) page.
/add-highlight [topic]Use the CLI to check if we can add today:
uv run python scripts/highlights.py check
Only 1 highlight per day is allowed. If already added today, skip silently and note in output that a highlight was already added.
Determine the content:
new-article - A new piece of content was createdinsight - An interesting finding from review or analysisresearch - Research notes or discoveriesrefinement - Significant improvement to existing content[[hard-problem-of-consciousness]])uv run python scripts/highlights.py add "Title Here" "Description of what's interesting, max 280 chars." --type new-article --link "[[article-name]]"
If Twitter is configured (credentials in .env), add the --tweet flag:
uv run python scripts/highlights.py add "Title" "Description" --type new-article --link "[[article]]" --tweet
To test formatting without posting:
uv run python scripts/highlights.py add "Title" "Description" --type new-article --link "[[article]]" --tweet --dry-run
Note: Twitter posting is optional. If credentials aren't configured, the highlight is added and a warning is logged. Twitter failures never block highlight creation.
--tweet CLI FlagWhen tweeting, you MUST use the --tweet flag on the highlights.py add command. Do NOT decompose the tweet pipeline into separate steps (e.g., adding highlight, then manually committing, then calling post_tweet separately). The --tweet flag runs an integrated pipeline that:
Skipping any of these steps can result in malformed URLs being tweeted.
The CLI will confirm success or report rate limiting.
Good highlights are:
Skip these (not highlight-worthy):
uv run python scripts/highlights.py add \
"Why Materialism Can't Explain Consciousness" \
"New article argues that all forms of materialism fail to account for subjective experience. The hard problem isn't just unsolved—it may be unsolvable in principle." \
--type new-article \
--link "[[materialism]]"
uv run python scripts/highlights.py add \
"Buddhist Perspectives Challenge Western Assumptions" \
"Research into Buddhist philosophy reveals that the self-consciousness problem looks different from a tradition that questions the self's existence entirely." \
--type research \
--link "[[buddhist-perspectives-meaning]]"
uv run python scripts/highlights.py add \
"Decoherence Timescales Present Real Challenge" \
"Pessimistic review identified that quantum decoherence in warm brains happens in femtoseconds—nine orders of magnitude faster than neural processes." \
--type insight \
--link "[[consciousness-selecting-neural-patterns]]"
The evolution loop automatically invokes this skill at 8am UTC daily when there's highlight-worthy work from today's successful tasks. It passes task context via --from-task.
--from-taskParse the task info and compose an appropriate highlight:
expand-topic: concepts/qualia.md)--tweet flagInput: --from-task 'expand-topic: concepts/quantum-timing.md' --tweet
Steps:
obsidian/concepts/quantum-timing.mduv run python scripts/highlights.py add \
"Quantum Timing: When Mind Meets Matter" \
"New article maps timescales from femtosecond decoherence to 300ms decisions, showing how quantum effects must operate within neural constraints." \
--type new-article \
--link "[[quantum-timing]]" \
--tweet
The --tweet flag triggers the full chain: add → commit → push → wait for deployment → tweet.
| Task Type | Highlight Type |
|---|---|
| expand-topic | new-article |
| research-topic | research |
| research-voids | research |
| deep-review | insight |
| coalesce | new-article |
| apex-evolve | new-article |
| backlog | (infer from content - see below) |
When invoked with --from-task 'backlog: obsidian/path/to/file.md', this means we're highlighting existing content that hasn't been featured in the last 90 days. This is NOT necessarily new work—it's content worth sharing that hasn't had recent attention.
obsidian/topics/ → new-article (even if old, it's an article)obsidian/concepts/ → new-articleobsidian/apex/ → new-articleobsidian/voids/ → insight (these explore cognitive limits)