session-start
Runs the session startup procedure - verifies setup, loads config and state, checks skill models, and reports project status. Use at the beginning of a fresh session.
Install / Use
npx skills add bitwize-music-studio/claude-ai-music-skills --skill session-startInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Our assessment of session-start
session-start scores 88/100 on our quality scale, 337th of 652 Marketing skills we index.
Its SKILL.md is 7.7 KB long, well organised into 18 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 512 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so session-start is actively maintained.
- Our last check on 2026-11-01 found the source still online.
- It is released under the CC0-1.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
session-start compared with similar skills
All 4 of these similar skills score higher than session-start; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| session-start (this skill)by bitwize-music-studio | 88 | 512 | 56d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.0k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.4k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install session-start?
- Run
npx skills add bitwize-music-studio/claude-ai-music-skills --skill session-start. The install tabs above show the steps for each supported agent. - Which AI agents does session-start work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is session-start safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is CC0-1.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is session-start still maintained?
- The repository was last updated about 2 months ago, so session-start is actively maintained.
Skill content
View source on GitHubname: session-start description: Runs the session startup procedure - verifies setup, loads config and state, checks skill models, and reports project status. Use at the beginning of a fresh session. model: sonnet effort: low allowed-tools:
- Read
- Bash
- Glob
- Grep
- WebSearch
- WebFetch
- bitwize-music-mcp
Your Task
Run the full session start procedure and report project status to the user.
Session Start Skill
You perform the 8-step session startup procedure that initializes a working session.
Step 1: Verify Setup
Quick dependency check:
~/.bitwize-music/venv/bin/python3 -c "import mcp.server.mcpserver" 2>/dev/null || ~/.bitwize-music/venv/bin/python3 -c "import mcp.server.fastmcp" 2>/dev/null && echo "MCP ready" || echo "MCP unusable" # macOS/Linux/WSL
~/.bitwize-music/venv/Scripts/python.exe -c "import mcp.server.mcpserver" 2>/dev/null || ~/.bitwize-music/venv/Scripts/python.exe -c "import mcp.server.fastmcp" 2>/dev/null && echo "MCP ready" || echo "MCP unusable" # Windows (Git Bash; cmd/PowerShell: %USERPROFILE%\.bitwize-music\venv\Scripts\python.exe)
- If MCP unusable: Stop immediately and suggest:
/bitwize-music:setup mcp(the SDK is missing or predates 1.28.1). Probe both server modules, never bareimport mcp: 2.x servesMCPServerfrommcp.server.mcpserverand 1.x servesFastMCPfrommcp.server.fastmcp, and the server accepts either — but a bareimport mcpsucceeds even when neither module is present, reporting healthy on an install the server cannot boot on - If config missing (
~/.bitwize-music/config.yamldoesn't exist): suggest/bitwize-music:configure - Don't proceed until setup is complete
Step 1.5: Health Check
Use the health_check MCP tool (checks venv packages + skill registration + album slug collisions in one call):
Venv results (from result.venv):
status: "ok"→ continue silentlystatus: "stale"→ warn with mismatches and fix command, continue sessionstatus: "no_venv"→ stop and suggest/bitwize-music:setupstatus: "error"→ warn and continue
Skill registration results (from result.skills):
status: "ok"→ continue silentlystatus: "stale"→ warn: list missing and ghost skill names, show fix messagestatus: "no_cache"→ warn that plugin cache not found, continue
Album slug collision results (from result.collisions):
status: "ok"→ continue silentlystatus: "collision"→ warn: list each slug with its kept and shadowed genres, show the fix (rename one album with/bitwize-music:renameor move its directory, then runrebuild_state), continue session
Step 2: Load Config
Read ~/.bitwize-music/config.yaml.
If missing, tell user to run /bitwize-music:configure.
Step 3: Load Overrides
Read paths.overrides from config (default: {content_root}/overrides):
- Check for
{overrides}/CLAUDE.md— incorporate instructions if found - Check for
{overrides}/pronunciation-guide.md— note if found - Skip silently if missing (overrides are optional)
Step 4: Load State Cache
Read ~/.bitwize-music/cache/state.json:
- If missing, corrupted, schema mismatch, or config changed: rebuild via MCP
rebuild_state()
Step 4.5: Check for Plugin Upgrades
Call the get_pending_migrations MCP tool. It compares the installed plugin
version against last_migrated_version in state (the last version whose
migrations were processed — distinct from plugin_version, which only records
the installed version for display) and returns the pending notes already
parsed and sorted.
- If
pendingis empty (reason: "current", orreason: "unknown"when the installed version can't be read from plugin.json): No action needed. - If
pendingis non-empty (reason: "upgrade"or"untracked"): For each migration, process itsactionsin order:auto: Execute silently (runcheckfirst — skip if it returns 0)action: Show description, ask the user to confirm before executinginfo: Display to the usermanual: Show the instruction to the user
- After processing all notes, call
acknowledge_migrations(no argument acknowledges everything up to the installed version) so the same notes do not surface again next session. - Report: "Upgraded to Y" with a summary of the actions taken.
reason: "untracked"means the state predates migration tracking; the full backlog up to the installed version is surfaced once, then cleared byacknowledge_migrations. Do NOT just rebuild state to clear migrations — a rebuild preserves the pending status; onlyacknowledge_migrationsrecords that you processed them.
Step 5: (Removed)
Skill model checking is no longer part of session start. Skills use tier aliases (opus/sonnet/haiku) that auto-track the frontier model, and the test suite (/bitwize-music:test) enforces model/effort hygiene — so no manual model checking is needed when new Claude models are released.
Step 6: Report From State Cache
Using data from state.json, report:
Album Ideas
From state.ideas.counts — show count by status (Pending, In Progress, etc.)
In-Progress Albums
Filter state.albums for status: "In Progress", "Research Complete", "Complete"
For each, show:
- Album name, genre, status
- Track progress (completed/total)
Pending Source Verifications
From state.albums — find tracks where sources_verified is "Pending"
If any found, warn: "These tracks have unverified sources — generation is blocked until verified."
Last Session Context
From state.session:
- Last album worked on
- Last phase
- Pending actions
Step 7: Show Contextual Tips
Based on state, show ONE relevant tip:
| Condition | Tip |
|-----------|-----|
| No albums exist | "Try /bitwize-music:tutorial to create your first album" |
| Ideas exist but no albums | "You have album ideas! Use /bitwize-music:album-ideas list to review them" |
| In-progress albums exist | "Resume where you left off: /bitwize-music:resume <album-name>" |
| Overrides loaded | "Custom overrides loaded from {overrides}/" |
| Overrides missing | "Customize your workflow with override files — see /reference/overrides/" |
| Pending verifications | "Source verification needed before generation can proceed" |
Also show one random general tip (rotate through these):
- "Ask 'what should I do next?' for workflow guidance"
- "Use
/bitwize-music:resumeto quickly jump back into an album" - "The researcher skill coordinates 10 specialized sub-skills for deep research"
- "Check pronunciation before generating — Suno can't infer from context"
- "Use
/bitwize-music:clipboardto copy lyrics/prompts for Suno" - "Master your audio with
/bitwize-music:mastering-engineerfor professional results"
Step 8: Ask
End with: "What would you like to work on?"
Report Format
SESSION START
=============
Setup: MCP ready, config loaded
Health: [venv ok, skills ok, no collisions | warnings listed]
Overrides: [loaded from {path} | not found (optional)]
State: [loaded | rebuilt | error]
ALBUM IDEAS
Pending: X | In Progress: Y
IN-PROGRESS ALBUMS
[album-name] (genre) - Status [X/Y tracks]
[album-name] (genre) - Status [X/Y tracks]
PENDING VERIFICATIONS
[album-name]: track-01, track-05
LAST SESSION
Album: [name] | Phase: [phase]
Pending: [actions]
TIP: [contextual tip]
What would you like to work on?
Remember
- Don't skip steps — Each step matters for session integrity
- Rebuild state if needed — Stale state leads to wrong recommendations
- Be concise — This is a status report, not a conversation
- Warn about verifications — Unverified sources block generation
- One tip, not five — Pick the most relevant tip for the current state
Related Skills
Agent-Reach
113.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
86.4kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.1kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
