Insight Song

insight-song (歌)

Transform technical conversations and insights into songs formatted for Suno.ai. Creates lyrics with emotional arc that mirrors the technical journey, complete with style tags and section markers.

Trigger: 明示呼出 (explicit invocation) or when deep technical insight emerges

Core insight: "Creation forces synthesis. Making a song about a concept reveals gaps that passive understanding cannot."

Installation

openclaw install leegitw/insight-song

Dependencies: None (standalone creative skill)

Data handling: This skill synthesizes content from user-supplied input or the current conversation context (default). It does NOT read files from the workspace or access project artifacts directly. Results are returned to the invoking agent, who decides how to use them.

What This Solves

Technical insights fade with context compression. Songs provide audio reinforcement that makes concepts memorable and transferable. This skill:

1. Synthesizes technical conversations into narrative arc
2. Transforms abstract concepts into singable lyrics with visual imagery
3. Formats output for direct use with Suno.ai

The insight: Technical principles conveyed through metaphor and emotional arc stick better than documentation alone.

Usage

/song [topic]

Arguments

| Argument | Required | Description | |----------|----------|-------------| | topic | No | Topic focus (default: synthesize current conversation) |

Pre-Requisites

Before creating a song, ensure:

1. Sufficient conversation depth — Surface-level summaries don't make good songs
2. Clear narrative arc — Problem → Discovery → Solution → Impact
3. Main work documented — Save current progress first if mid-task

Context Understanding Checklist

You must be able to answer:

| Question | What It Means | |----------|---------------| | Core insight? | Not "we talked about X" but "we discovered X solves Y" | | Problem solved? | The pain point, not just the topic | | Why, not just what? | The reasoning, not just the outcome | | Substantial depth? | Teaches something new, not standard practice |

Red Flags (Don't Create)

• Surface-level summary of conversation
• Don't understand why a decision was made
• Insight is just standard practice
• No clear narrative arc
• Vague lyrics that could apply to anything

Output Format

Suno.ai Song Format

## Song

**Title**: [Song Name]

**Suno.ai Style Tags**:
[300-500 characters describing musical style, mood, instrumentation]

[Verse 1]
[Lyrics conveying the problem/pain]

[Chorus]
[Core message, repeatable, memorable]

[Verse 2]
[Discovery/insight]

[Bridge]
[Technical depth through metaphor]

[Chorus]

[Outro]
[Resolution/call to action]

Song Rules

| Rule | Description | |------|-------------| | Tell a story | Beginning, middle, end with clear arc | | Technical but singable | Don't sacrifice accuracy for rhyme | | Visual imagery | Designed for audio+visual reinforcement | | Emotional arc | Matches the technical journey | | NO literal specifics | Use metaphor and symbol, not file names or metrics | | NO artist names | Extract essence, not references |

Example: Good vs Bad Lyrics

Bad (too literal):

We fixed the bug in handler.go
The timeout was set to 300

Good (metaphorical):

Three in the morning, the logs are all silent
System's on fire but the metrics don't know
Building in darkness, no baseline to measure
Can't debug what you've never seen before

Core Logic

Step 1: Synthesize Conversation

• Read full conversation context
• Identify key decisions, "aha" moments
• Extract core insight or pattern

Step 2: Identify Narrative Arc

| Element | Question | |---------|----------| | Problem | What was broken/painful? | | Discovery | What did we learn? | | Solution | What pattern emerged? | | Impact | Why does this matter? |

Step 3: Write Song

Structure (flexible):

• Intro: Set the problem/context
• Verse 1: The pain/current state
• Verse 2: The discovery/insight
• Bridge: Technical depth through metaphor
• Chorus: Core message (repeatable, memorable)
• Outro: Resolution/call to action

Step 4: Format for Suno

• Add title
• Write 300-500 character style tags
• Add section markers: [Verse 1], [Chorus], [Bridge], etc.

Example

Input: Bootstrap Observability Insight

Context: Discovered reproduce-to-debug problem. Introduced Bootstrap → Learn → Enforce phases.

Narrative arc:

• Problem: Debugging without reproduction is impossible
• Discovery: Greenfield systems don't know what "normal" is
• Solution: Bootstrap → Learn → Enforce phases
• Impact: Debug with sight instead of in darkness

Output

Title: Bootstrap Before You Break

Suno.ai Style Tags:

Atmospheric indie folk with building intensity, finger-picked acoustic guitar opening,
gradually adding warm synth pads and driving drums, introspective male vocals with
occasional harmonies, dynamic shifts between quiet verses and powerful choruses,
ethereal reverb on bridge section, cinematic crescendo finale

[Verse 1]
Three in the morning, the logs are all silent
System's on fire but the metrics don't know
Building in darkness, no baseline to measure
Can't debug what you've never seen before

[Chorus]
Bootstrap before you break
Learn the patterns while you wait
Enforce what the data shows
Now you see where the failure goes

[Verse 2]
Started collecting every signal
Cast the net wide, caught it all
Fourteen days of patient watching
Now we know what normal's called

Integration

• Layer: Creative
• Depends on: None (standalone)
• Used by: side-quests (combo skill)
• Complements: visual-concept, ted-talk

Failure Modes

| Condition | Behavior | |-----------|----------| | Insufficient context | Ask clarifying questions first | | No clear narrative arc | Decline, explain what's missing | | Surface-level topic | Suggest deeper exploration first |

Security Considerations

Input sources:

• User-supplied context (if provided)
• Current conversation context (default)

What this skill does NOT do:

• Read files from the workspace
• Access project artifacts directly
• Send data to external services
• Call external APIs

Output behavior: This skill returns the song directly to the invoking agent. The agent can then display, save, or pass the result to another skill as needed.

Provenance note: This skill is developed by Live Neon (https://github.com/live-neon/skills) and published to ClawHub under the leegitw account. Both refer to the same maintainer.

Quality Checklist

• [ ] Can explain core insight in one sentence
• [ ] Understand why, not just what
• [ ] Song tells story with beginning, middle, end
• [ ] Emotional arc matches technical journey
• [ ] No literal specifics (file names, metrics, etc.)
• [ ] Style tags are 300-500 characters
• [ ] Section markers present: [Verse], [Chorus], [Bridge], etc.

Acceptance Criteria

• [ ] /song synthesizes input or conversation into Suno-ready format
• [ ] Output includes title, 300-500 char style tags, sectioned lyrics
• [ ] Lyrics convey technical insight through metaphor
• [ ] Emotional arc matches the technical journey
• [ ] Result returned to invoking agent

---

Part of the Live Neon Creative Suite.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: live-neon
• Source: live-neon/skills
• License: MIT

Install and usage instructions live in the source repository linked above.