Przejdź do treści
Biblioteka skilli
Inne · Budowanie i kod

beatflow-skill

/beatflow-skill

Komponuje, poprawia, waliduje, porównuje i eksportuje oryginalną muzykę wielościeżkową do Standard MIDI w zwięzłym DSL BeatFlow w Pythonie, wraz z inspekcją plików MIDI.

Repozytorium
beatflow-skill ↗
Licencja
GPL-3.0
Ostatnia zmiana repozytorium
28.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
26
Skrypty
19
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

GPL-3.0, otwarta.

Co sprawdzić przed instalacją
  • 19 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/beatflow.py, scripts/beatflow_core/__init__.py, scripts/beatflow_core/cli.py, scripts/beatflow_core/composer.py, scripts/beatflow_core/composition_compiler.py, scripts/beatflow_core/composition_diagnostics.py, scripts/beatflow_core/composition_models.py, scripts/beatflow_core/composition_validation.py

Co robi i kiedy

Komponuje, poprawia, waliduje, porównuje i eksportuje oryginalną muzykę wielościeżkową do Standard MIDI w zwięzłym DSL BeatFlow w Pythonie, wraz z inspekcją plików MIDI.

Oryginalny opis (EN)

Compose, revise, validate, compare, inspect, and export original multi-track music as Standard MIDI with BeatFlow's compact, style-neutral Python DSL. Use for turning a musical brief into a deterministic Composition, testing explicit phrase/counterpoint/theme contracts, or inspecting MIDI.

Jak działa

  1. Workflow
  2. Constraints
  3. Commands
  4. Interruptions
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 357 słów
Podgląd SKILL.md
---
name: beatflow-skill
description: Compose, revise, validate, compare, inspect, and export original multi-track music as Standard MIDI with BeatFlow's compact, style-neutral Python DSL. Use for turning a musical brief into a deterministic Composition, testing explicit phrase/counterpoint/theme contracts, or inspecting MIDI.
license: GPL-3.0-only
---

# BeatFlow

Use Codex for musical decisions and BeatFlow for exact timing, functional pitch
realization, validation, diagnostics, MIDI rendering, and inspection.

Run `python "<skill-root>/scripts/run.py" <command> ...`. Write scripts and
outputs in the user's workspace, never inside `<skill-root>`.

## Workflow

1. Extract duration, tempo, meter, tonal center, form, instrumentation, energy
   path, priorities, and exclusions. Make reversible assumptions when needed.
2. Read [composition-format.md](references/composition-format.md) before
   authoring. Read [diagnostics.md](references/diagnostics.md) only when adding
   explicit contracts, comparing candidates, or revising findings. Read
   [architecture.md](references/architecture.md) only for runtime maintenance.
3. Plan the shared clock, harmony, bass, role entries, rests, foreground,
   arrivals, and development before adding decoration.
4. Author a trusted Python file whose `build()` returns `Composition`. Prefer
   `SongBuilder` and exact `beat()` values. Style belongs in authored material,
   not compiler branches.
5. Keep identity-bearing material recognizable before transforming it. Declare
   phrases, interactions, counterpoint, themes, or silence only when the brief
   makes them testable.
6. Render and inspect:

```text
python "<skill-root>/scripts/run.py" compose song.py --midi song.mid --composition song.composition.json --report song.report.json
```

7. Treat validation errors as hard failures. Treat diagnostics as evidence
   against declared intent, never as a universal taste score. Listen before
   making the final musical judgment.

## Constraints

- Keep timing quantized unless the user explicitly requests timing variation.
- Count the perceptual tactus; do not assume every quarter note is one felt beat.
- Preserve essential instruments; repair writing or balance before dropping them.
- Give foreground a clear rhythmic identity, internal contrast, and arrival.
- Coordinate roles without forcing identical attacks.
- Use `top_target` when a chord's top voice carries the line.
- Keep all realized onsets and durations explicit.
- Create original music; do not copy a reference melody or imitate a living artist.
- Treat General MIDI as a preview, not final production timbre.

## Commands

- `compose SCRIPT --midi MIDI [--composition JSON] [--report JSON]`
- `analyze COMPOSITION [--output REPORT]`
- `compare COMPOSITION... [--revision] [--output REPORT]`
- `inspect [MIDI|COMPOSITION] [--schema] [--output REPORT]`
- `self-check`

## Interruptions

The Python source is the durable checkpoint. `--composition` is written
atomically before MIDI rendering, and MIDI/report outputs are also atomic.
After interruption, rerun the same command; deterministic realization restarts
cheaply without requiring an internal project cache.
Pliki w paczce (26)
  • LICENSE 34 KB
  • SKILL.md 3 KB
  • requirements.txt 1 KB
  • agents/openai.yaml 1 KB
  • references/architecture.md 1 KB
  • references/composition-format.md 3 KB
  • references/diagnostics.md 1 KB
  • scripts/beatflow.py 1 KB
  • scripts/run.py 3 KB
  • scripts/beatflow_core/__init__.py 1 KB
  • scripts/beatflow_core/cli.py 11 KB
  • scripts/beatflow_core/composer.py 33 KB
  • scripts/beatflow_core/composition_compiler.py 19 KB
  • scripts/beatflow_core/composition_diagnostics.py 20 KB
  • scripts/beatflow_core/composition_models.py 22 KB
  • scripts/beatflow_core/composition_validation.py 18 KB
  • scripts/beatflow_core/counterpoint_diagnostics.py 25 KB
  • scripts/beatflow_core/diagnostic_models.py 1 KB
  • scripts/beatflow_core/harmony_utils.py 4 KB
  • scripts/beatflow_core/inspect_midi.py 4 KB
  • scripts/beatflow_core/meter.py 2 KB
  • scripts/beatflow_core/models.py 1 KB
  • scripts/beatflow_core/realized_score.py 2 KB
  • scripts/beatflow_core/renderer.py 9 KB
  • scripts/beatflow_core/thematic_diagnostics.py 10 KB
  • scripts/beatflow_core/validation.py 1 KB

Wersje

W bazie nie ma innych skilli o nazwie beatflow-skill.

Migawka bazy z 13.11.2026 · wersja paczki fef4ec667cf9 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95muz-compose
    Komponuje, poprawia i sprawdza muzykę w formacie .muz kompilatorem studia, analizą partytury i renderem, pisząc kod zamiast edytora.
  • 90Ableton Describe To MIDI
    Zamienia opis muzyki w języku naturalnym na klip MIDI w Ableton Live, np. motyw nastrojowej linii pianina w podanej tonacji.
  • 95retro-music
    Komponuje, aranżuje i renderuje oryginalną muzykę w stylu ośmiobitowym i szesnastobitowym do gier, z partyturą w JSON i eksportem WAV.
  • 100arrangement-midi
    Komponuje uzupełniające ścieżki MIDI do istniejącego aranżu w REAPER z użyciem załadowanego instrumentu wirtualnego, na przykład pady, tekstury i warstwy melodyczne.
  • 100midi-cleanup
    Poprawia partie MIDI: humanizacja, prowadzenie głosów, kwantyzacja, czyszczenie timingu oraz usuwanie zawieszonych i zduplikowanych nut.
  • 91timeline
    Buduje, edytuje, waliduje i renderuje projekty osi czasu Pulp przez CLI, narzędzia MCP lub C++ SDK, w tym importy DAWproject i MIDI.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.