← Back to Skills Marketplace
deantiwang

Guitar Chord

by DeAnti- · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
377
Downloads
0
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install guitar-chord
Description
Guitar chord toolkit with chord identification, chord diagrams, capo calculation, and more. Features: - Identify chord from notes (reverse lookup) - Look up...
README (SKILL.md)

Guitar Chord Tool

1. Forward Lookup (Chord Name → Notes)

python3 chord_identifier.py \x3Cchord_name>

Example:

python3 chord_identifier.py Cmaj7
→ **Cmaj7**
  Notes: C, E, G, B

2. With Chord Diagram

python3 chord_identifier.py \x3Cchord_name> --diagram

3. Reverse Lookup (Notes → Chord Name)

python3 chord_identifier.py --identify \x3Cnote1> [note2] ...

Example:

python3 chord_identifier.py --identify C E G B
→ Result:
  • Cmaj7

4. Chord Inversions

python3 chord_identifier.py --inversion \x3Cchord_name>

Example:

python3 chord_identifier.py --inversion C7
→ **C7** inversions:
  Root: C, E, G, A#
  1st: E, G, A#, C
  2nd: G, A#, C, E
  3rd: A#, C, E, G

5. Drop2 Voicings

python3 chord_identifier.py --drop2 \x3Cchord_name>

Drop2 是一种常见的吉他扩展和弦 voicing:把七和弦的第二高音(纯五度)降一个八度,产生更"开阔"的音色。

Example:

python3 chord_identifier.py --drop2 Cmaj7
→ **Cmaj7 大七** Drop2 Voicings:
  原位: C, E, G, B
  Drop2: C, G, B, E
  
  常见 Guitar Voicings:
  Root pos.: X-3-2-1-1-0 → C,G,B,E
  1st inv.: X-X-0-2-1-0 → E,C,G,B
  ...

6. Scale Lookup

python3 chord_identifier.py --scale "\x3Cscale>"
python3 chord_identifier.py --scale "\x3Cscale>" --diagram

Supported scales:

  • major, minor, harmonic_minor, melodic_minor
  • pentatonic_major, pentatonic_minor, blues
  • dorian, phrygian, lydian, mixolydian, locrian

Example:

python3 chord_identifier.py --scale "C major"
→ **C Major**
  Scale: C, D, E, F, G, A, B

7. Capo Calculator

Formula: Actual Pitch = Open Chord Pitch + Capo Fret

Quick Reference:

Chord 1st 2nd 3rd 4th
C C#/Db D D#/Eb E
G G#/Ab A A#/Bb C
Am A#/Bb B C C#/Db

Supported Chord Types

  • Triads: major, minor, diminished, augmented, sus2, sus4
  • Sevenths: maj7, 7, m7, m7b5, dim7, aug7, maj7#5, 7#5, 7b5, mMaj7
  • Ninths: maj9, 9, m9

Note Formats

Supports:

  • Natural: C, D, E, F, G, A, B
  • Sharps: C#, D#, F#, G#, A#
  • Flats: Db, Eb, Gb, Ab, Bb
  • Symbols: ♯ (sharp), ♭ (flat)
  • Case insensitive
Usage Guidance
This skill appears to implement the advertised chord features, but exercise caution before running it as-is. The bundled script will attempt to execute 'cargo run' in ~/workspace/ascii_chord to produce ASCII diagrams — that runs code from that local directory (if present) and requires Rust/Cargo to be installed, yet the README/SKILL.md doesn't mention this dependency. Recommendations: - Inspect the full script (already included) and remove or sandbox the get_ascii_chord call if you don't want any subprocess builds/executables run. - If you need diagrams, install and review the ascii_chord project in a controlled location you trust, or modify the script to call a packaged binary you vet. - Be aware the script has identifiable bugs/unreachable code; test in an isolated environment before giving it broad use. If you want to proceed, ask the author to document the cargo/local-project requirement or provide a pure-Python diagram fallback.
Capability Analysis
Type: OpenClaw Skill Name: guitar-chord Version: 1.0.2 The guitar-chord skill is a toolkit for chord and scale identification. While the main script 'scripts/chord_identifier.py' contains several coding errors—such as a missing function definition for 'notes_to_semitones' (due to a misplaced return statement) and a duplicate 'main' function—these appear to be unintentional bugs rather than malicious logic. The script uses 'subprocess.run' to call a local Rust-based tool ('ascii_chord') for generating diagrams, but it does so using a safe list-based argument format that prevents shell injection. No evidence of data exfiltration, persistence, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description (guitar chord toolkit) aligns with the provided code and SKILL.md: the Python script implements forward/reverse lookup, scales, inversions, and diagram support. However the script attempts to call an external ascii_chord tool via 'cargo run' in ~/workspace/ascii_chord to produce diagrams; SKILL.md does not document this dependency or the requirement for cargo/a local project, so there's a proportionality/documentation mismatch.
Instruction Scope
SKILL.md instructs the agent to run the included python script (expected). The script, however, accesses the user's home directory (os.path.expanduser('~') → ~/workspace/ascii_chord) and runs subprocess.run(['cargo','run','--','get',chord_name], cwd=cwd), executing code found in that local directory if present. SKILL.md does not disclose this filesystem access or the execution of a separate tool. The script also contains coding errors/unreachable blocks (e.g., a return in normalize_note followed by code that will never run), indicating sloppy implementation that may cause unexpected behavior.
Install Mechanism
No install spec — instruction-only skill with a bundled script. That is low-risk relative to download-and-extract installs. The only install-like behavior is reliance on an external tool (cargo) which is not declared.
Credentials
The skill declares no env vars or credentials (good). The script reads the user's home path and attempts to run a local program under ~/workspace/ascii_chord. Accessing the home directory for a local diagram tool is plausible for diagram support, but it should be documented; running code from a hardcoded user path without explicit permission is disproportionate to the stated simple chord lookup capability.
Persistence & Privilege
No elevated privileges requested, always:false, and no persistent modifications are declared. The skill does not request to be always-enabled nor modify other skills or system-wide config.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install guitar-chord
  3. After installation, invoke the skill by name or use /guitar-chord
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Version 1.1.0 is a feature update with drop2 voicings support. - Added drop2 voicing generation and lookup for chords (via --drop2) - Updated documentation to describe drop2 feature and usage examples - Minor description updates in SKILL.md to reflect new functionality
v1.0.1
Fixed flat note handling bug (Bb, Eb, etc.)
v1.0.0
Initial release of guitar-chord skill. - 支持根据和弦名查询和弦音及和弦图 - 可反向根据音符识别和弦名 - 提供和弦转位查询 - 支持多种吉他音阶及其音阶图查询 - 包含 Capo 换算功能及对照表 - 覆盖多种和弦类型和音名格式
Metadata
Slug guitar-chord
Version 1.0.2
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 3
Frequently Asked Questions

What is Guitar Chord?

Guitar chord toolkit with chord identification, chord diagrams, capo calculation, and more. Features: - Identify chord from notes (reverse lookup) - Look up... It is an AI Agent Skill for Claude Code / OpenClaw, with 377 downloads so far.

How do I install Guitar Chord?

Run "/install guitar-chord" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Guitar Chord free?

Yes, Guitar Chord is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Guitar Chord support?

Guitar Chord is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Guitar Chord?

It is built and maintained by DeAnti- (@deantiwang); the current version is v1.0.2.

💬 Comments