Rechord Guitar Tab Enhancer

This skill helps you work with Rechord, a Python CLI tool that enhances guitar tablature files using Google's Gemini AI. It converts raw tab text into well-formatted markdown with YAML front matter containing song metadata.

What This Skill Does

Rechord processes guitar tablature files and enhances them with:

Setup Instructions

1. **Create and activate virtual environment:**

```bash

python -m venv .venv

source .venv/bin/activate # On Windows: .venv\Scripts\activate

```

2. **Install dependencies:**

```bash

pip install -r requirements.txt

pip install -e .

# For development with testing and linting:

pip install -e ".[dev]"

```

3. **Set up API key:**

- Ensure `GEMINI_API_KEY` is set in environment or `.env` file

- Required before running any enhancement commands

Core Usage

Single File Enhancement

```bash

Basic enhancement (outputs as artist-song-name.md)

rechord enhance input_tab.txt

With validation

rechord enhance input_tab.txt --validate

```

Batch Processing

```bash

Process all .txt files in current directory

rechord batch "*.txt" --output-dir ./enhanced

Recursive processing

rechord batch "**/*.txt" --output-dir ./enhanced --recursive

Multiple extensions with validation

rechord batch "{*.txt,*.tab}" --output-dir ./enhanced --validate

```

Validation

```bash

rechord validate enhanced_tab.md

```

Development Workflow

Running Tests

```bash

All tests with verbose output

pytest tests/ -v

Specific test file

pytest tests/test_formatter.py -v

Specific test

pytest tests/test_formatter.py::TestTabFormatter::test_parse_tab_with_front_matter -v

With coverage

pytest tests/ --cov=rechord

```

Code Quality

```bash

Check linting

ruff check .

Auto-fix issues

ruff check . --fix

Format code

ruff format .

```

Architecture

Core Components

**GeminiClient** (`rechord/gemini_client.py`):

**TabFormatter** (`rechord/formatter.py`):

**CLI** (`rechord/cli.py`):

Output Format Rules

1. YAML front matter with metadata (NO title header after front matter)

2. Tab notation in ```tab blocks for 6-line tablature ONLY

3. Lyrics with chords positioned above each line

4. No chord definitions section

5. No verse/chorus/section markers

6. Capo info in YAML only (e.g., `capo: 8`)

7. Chord progressions as plain text, not in tab blocks

API Integration

Uses Google's `google-genai` library (v1.31.0+):

Important Constraints

French Language Support

The prompt includes enhanced French support:

When Modifying Code

1. Always run tests after changes: `pytest tests/ -v`

2. Ensure code passes linting: `ruff check .`

3. Format with ruff before committing: `ruff format .`

4. Validate output format follows the rules above

5. Test with both English and French content if modifying enhancement logic