← 返回 Skills 市场
377
总下载
0
收藏
2
当前安装
3
版本数
在 OpenClaw 中安装
/install guitar-chord
功能描述
Guitar chord toolkit with chord identification, chord diagrams, capo calculation, and more. Features: - Identify chord from notes (reverse lookup) - Look up...
使用说明 (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_minorpentatonic_major,pentatonic_minor,bluesdorian,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
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install guitar-chord - 安装完成后，直接呼叫该 Skill 的名称或使用
/guitar-chord触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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 换算功能及对照表
- 覆盖多种和弦类型和音名格式
元数据
常见问题
Guitar Chord 是什么？
Guitar chord toolkit with chord identification, chord diagrams, capo calculation, and more. Features: - Identify chord from notes (reverse lookup) - Look up... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 377 次。
如何安装 Guitar Chord？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install guitar-chord」即可一键安装，无需额外配置。
Guitar Chord 是免费的吗？
是的，Guitar Chord 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Guitar Chord 支持哪些平台？
Guitar Chord 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Guitar Chord？
由 DeAnti-（@deantiwang）开发并维护，当前版本 v1.0.2。
推荐 Skills