CtrlK
BlogDocsLog inGet started
Tessl Logo

aaronguo/muse

Conversational writing topic discovery. Combines personal context (journals, notes, past writing), optional Signal DB intelligence, and web research to surface timely, authentic topic ideas for any writing format.

90

Quality

90%

Does it follow best practices?

Impact

Pending

Average score across 4 eval scenarios

SecuritybySnyk

Risky

Do not use without reviewing

Overview
Quality
Evals
Security
Files

Muse — Documentation

Invocation

/muse                              # Full discovery — Signal + context + web
/muse I've been thinking about X   # Start with a rough idea, skip to refinement

If you arrive with an idea, Muse skips the research phase and goes straight to sharpening your angle.

First Run

The first time you invoke /muse, it asks 6 questions to learn who you are — your name, content pillars, audience, writing formats, and optional Signal DB / personal context paths. This creates .aaron-skills/muse/EXTEND.md and only happens once.

To reconfigure: delete .aaron-skills/muse/EXTEND.md and run /muse again.

What Muse Does

┌─────────────────────────────────────────────┐
│  1. Attune        Read your EXTEND.md       │
│  2. Signal        Query your trend DB       │
│  3. Read You      Journals, notes, past work│
│  4. Scan the Web  4–6 targeted searches     │
│  5. Present       4–6 topic ideas           │
│  6. Go Deeper     Conversation to sharpen   │
│  7. Confirm       One clear direction       │
└─────────────────────────────────────────────┘

Steps 2–4 gather intelligence. Steps 5–6 are a conversation. Step 7 is the output.

What Muse Outputs

A confirmed topic direction — not a content plan, not a draft:

## Your Next Piece

Working title: "..."
In one sentence: ...
The story: ...
Pillar: ...
Format: blog / newsletter / ...
Why this week: ...
What makes it yours: ...

With or Without Signal DB

SetupWhat happens
With Signal DBMuse queries your Turso database for trending items and daily pulse summaries, then combines with web search + personal context
Without Signal DBMuse relies on web search + your journals/notes. Still fully functional — just less personalized trend data

EXTEND.md Preferences Reference

All configuration lives in .aaron-skills/muse/EXTEND.md (YAML frontmatter). Edit directly to change content pillars, audience, writing formats, Signal DB credentials, CTA rotation, or hand-off skill.

Identity

FieldTypeDefaultDescription
versioninteger1Schema version
author_namestring""Your name or pen name
brand_positioningstring""What you write and why

Writing

FieldTypeDefaultDescription
writing_formatslist["blog"]Formats: blog, newsletter, linkedin, video-script, essay, thread, other
content_pillarslist[]Your 2–4 recurring topics
target_audiencestring""Who reads your work

Personal Context — content_paths

FieldWhat Muse readsExample
journals_dirLast 2–3 journal entries"src/journal/"
reading_notes_dirReading notes from the last 14 days"src/reading/"
brain_dirEvergreen "second brain" notes"src/brain/"
past_writing_globLast 3 content plans or outlines"src/blogs/*/content-plan.md"

CTA Rotation — cta_rotation

FieldTypeDefaultDescription
enabledbooleanfalseInclude CTA in confirmed topic summary
sequencelist["follow", "newsletter", "reply"]Rotation order
currentstring"follow"Next CTA to use (update manually after each post)

Signal DB — signal_db

FieldTypeDefaultDescription
enabledbooleanfalseEnable Signal DB queries
providerstring"turso"Database provider
database_urlstring""HTTPS URL of your Turso database
auth_token_envstring"TURSO_AUTH_TOKEN"Env variable holding the token
tables.daily_pulsestring"daily_pulse"Table with date + pulse_text
tables.itemsstring"items"Table with title, source, score, relevance, summary, collected_at
min_relevanceinteger7Minimum relevance score (1–10)
lookback_daysinteger7Days of history to query

Hand-off — next_skill

FieldTypeDefaultDescription
next_skillstring""Skill to suggest after confirming a topic (e.g. "blog-brainstorm")
Workspace
aaronguo
Visibility
Public
Created
Last updated
Publish Source
CLI
Badge
aaronguo/muse badge