К основному содержанию
скилл CX Codex

session-start · bitwize-music-studio — скилл для Claude Code: что делает и как установить

Скилл session-start для Claude Code запускает проверку окружения в начале сессии и загружает конфигурацию и состояние проекта. Восстанавливает рабочий контекст.

CC0-1.0 251 установок ★ 686 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill session-start -a claude-code
Открыть на GitHub

Что делает session-start

Скилл запускает стартовую процедуру: проверяет MCP и виртуальное окружение, вызывает health_check, читает конфигурацию и необязательные override-файлы. Затем он загружает кэш состояния, при необходимости запускает rebuild_state и проверяет миграции установленного плагина.

После этого скилл собирает из state.json идеи, альбомы в работе, незавершённые проверки источников и контекст прошлой сессии. Он также показывает один совет по текущему состоянию и обращается к MCP-инструментам, включая rebuild_state и acknowledge_migrations. Без рабочего ~/.bitwize-music/venv и доступного MCP сервер не пройдёт стартовую проверку.

Какие задачи решает

  • проверить MCP и виртуальное окружение
  • загрузить конфигурацию и override-файлы
  • восстановить кэш состояния проекта
  • обработать миграции плагина
  • показать незавершённые альбомы и проверки

Примеры запросов агенту

  • Начни новую сессию: проверь настройку и покажи статус проекта.
  • Загрузи состояние проекта и сообщи, какие альбомы требуют продолжения.
  • Проверь ожидающие миграции плагина и обработай их по правилам.

Как установить session-start

1Через Skills CLI (Vercel)

npx skills add bitwize-music-studio/claude-ai-music-skills --skill session-start -a claude-code

2Вручную: положить файлы

~/.claude/skills/session-start/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/session-start/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о session-start

Как установить session-start в Claude Code?

Выполните npx skills add bitwize-music-studio/claude-ai-music-skills --skill session-start -a claude-code, затем проверьте файл ~/.claude/skills/session-start/SKILL.md.

Что делает session-start?

Скилл проверяет MCP, конфигурацию и состояние проекта, обрабатывает миграции и показывает текущий рабочий контекст в начале сессии.

Что нужно для работы session-start?

Нужны виртуальное окружение ~/.bitwize-music/venv, доступный MCP SDK и конфигурация ~/.bitwize-music/config.yaml. При проблеме с MCP запуск останавливается.

Исходный текст

SKILL.md · CC0-1.0
---
name: 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:

```bash
~/.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 bare `import mcp`: 2.x serves `MCPServer` from `mcp.server.mcpserver` and 1.x serves `FastMCP` from `mcp.server.fastmcp`, and the server accepts either — but a bare `import mcp` succeeds even when neither module is present, reporting healthy on an install the server cannot boot on
- If config missing (`~/.bitwize-music/config.yaml` doesn'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 silently
- `status: "stale"` → warn with mismatches and fix command, continue session
- `status: "no_venv"` → **stop** and suggest `/bitwize-music:setup`
- `status: "error"` → warn and continue

**Skill registration results** (from `result.skills`):
- `status: "ok"` → continue silently
- `status: "stale"` → warn: list missing and ghost skill names, show fix message
- `status: "no_cache"` → warn that plugin cache not found, continue

**Album slug collision results** (from `result.collisions`):
- `status: "ok"` → continue silently
- `status: "collision"` → warn: list each slug with its kept and shadowed genres, show the fix (rename one album with `/bitwize-music:rename` or move its directory, then run `rebuild_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.

1. **If `pending` is empty** (`reason: "current"`, or `reason: "unknown"` when the
   installed version can't be read from plugin.json): No action needed.
2. **If `pending` is non-empty** (`reason: "upgrade"` or `"untracked"`): For each
   migration, process its `actions` in order:
   - `auto`: Execute silently (run `check` first — skip if it returns 0)
   - `action`: Show description, ask the user to confirm before executing
   - `info`: Display to the user
   - `manual`: Show the instruction to the user
3. **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.
4. 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 by
> `acknowledge_migrations`. Do NOT just rebuild state to clear migrations —
> a rebuild preserves the pending status; only `acknowledge_migrations` records
> 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:resume` to 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:clipboard` to copy lyrics/prompts for Suno"
- "Master your audio with `/bitwize-music:mastering-engineer` for 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

1. **Don't skip steps** — Each step matters for session integrity
2. **Rebuild state if needed** — Stale state leads to wrong recommendations
3. **Be concise** — This is a status report, not a conversation
4. **Warn about verifications** — Unverified sources block generation
5. **One tip, not five** — Pick the most relevant tip for the current state

© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills

Похожие скиллы

Каталог скиллов SKILL.md →

Сначала — session-start от других авторов.

session-start yahor-punko Скилл session-start подгружает текущее состояние Mavericks в начале сессии или после потери контекста: инициативу, этап, активные задачи и следующий шаг. CX Codex +1 ★ 121звёзд репо agents-md-loader davila7 Хук agents-md-loader добавляет содержимое AGENTS.md в контекст Claude Code при старте или возобновлении сессии. Так агент получает проектные инструкции автоматически. 1 423установок board LeeSwallow Хук board, который при старте сессии показывает агенту состояние доски проекта. Доска лежит в обычных Markdown-файлах, читать её можно прямо из терминала. CX Codex ★ 1 596звёзд репо a-team RBraga01 Хук a-team для Claude Code запускается при старте сессии и событиях clear или compact. Он показывает статус и загружает инструкции команды. CX Codex ★ 1 596звёзд репо tanstack-start-best-practices DeckardGer Скилл tanstack-start-best-practices для Claude Code собирает правила и паттерны для full-stack приложений на TanStack Start. Помогает настраивать серверные функции, сессии и потоковый SSR. CX Codex +1 10 000установок start-learning rohitg00 Скилл start-learning проводит вводное интервью, определяет стартовый этап курса по AI Engineering и создаёт план в LEARNING.md. Запускайте его, чтобы начать обучение или настроить план. CX Codex +1 5 600установок start официальный anthropics Скилл start проверяет подключённые MCP-серверы и доступные инструменты биоисследований. Помогает сориентироваться в окружении плагина перед началом проекта. CX Codex +1 5 100установок

Из того же набора52

Весь набор →
help Скилл help для Claude Code показывает каталог команд, рабочих процессов и быстрые советы; вызывай его, чтобы найти команду или узнать назначение инструмента. CX Codex +1 253установок import-art Скилл import-art копирует обложку музыкального альбома сразу в две папки проекта с нужными именами файлов. Помогает при подготовке релизов. CX Codex +1 252установок new-album Скилл new-album разворачивает каталоги и шаблоны нового музыкального альбома по заданному жанру через вызов инструмента MCP. CX Codex +1 252установок researchers-gov Скилл researchers-gov ищет и структурирует официальные релизы ведомств США (DOJ, FBI, SEC, CISA) для документальных музыкальных треков. Выделяет цитаты, хронологию и ключевые цифры. CX Codex +1 252установок explicit-checker Скилл explicit-checker проверяет тексты песен на ненормативную лексику и сверяет флаг Explicit перед генерацией в Suno или отправкой дистрибьюторам. CX Codex +1 251установок promo-reviewer Скилл promo-reviewer проверяет тексты для соцсетей в promo/ альбома и помогает отредактировать их перед релизом. Подходит для финальной вычитки постов по платформам. CX Codex +1 250установок voice-checker Скилл voice-checker анализирует текст песен и прозу на признаки AI-генерации: абстрактные существительные подряд, переобъяснённые метафоры, штампованные фразы. Помечает проблемы как советы, не переписывает. CX Codex +1 250установок import-track Скилл import-track для Claude Code перемещает файлы треков в директории альбомов. Организует треки, лежащие вразброс, по структуре проекта. CX Codex +1 250установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой