Add examples and install script

Author: Mingyue-Cheng

.gitignore

@@ -4,3 +4,6 @@ __pycache__/
 *.pyo
 *.png
 *.pdf
+examples/.cache/
+!examples/output/*.png
+!examples/output/*.pdf

Makefile

@@ -1,9 +1,15 @@
 PYTHON ?= python3
 
-.PHONY: test test-release
+.PHONY: test test-release example install
 
 test:
 	PYTHON_BIN=$(PYTHON) ./scripts/self-test.sh
 
 test-release:
 	PYTHON_BIN=$(PYTHON) ./scripts/release-test.sh
+
+example:
+	PYTHON_BIN=$(PYTHON) ./examples/generate_comparison_bar.py
+
+install:
+	./scripts/install-skill.sh

README.md

@@ -45,14 +45,25 @@ The style contract is academic and conservative by default:
 figure-plot/
 ├── SKILL.md
 ├── README.md
+├── README_ZH.md
+├── LICENSE
 ├── Makefile
 ├── .gitignore
+├── agents/
+│   └── openai.yaml
+├── examples/
+│   ├── comparison_results.csv
+│   ├── generate_comparison_bar.py
+│   └── output/
+│       ├── comparison_bar_example.png
+│       └── comparison_bar_example.pdf
 ├── references/
 │   ├── plot-presets.md
 │   ├── style-guide.md
 │   ├── data-patterns.md
 │   └── troubleshooting.md
 └── scripts/
+    ├── install-skill.sh
     ├── check-deps.sh
     ├── self-test.sh
     └── release-test.sh
@@ -65,6 +76,9 @@ figure-plot/
 - [references/style-guide.md](./references/style-guide.md): academic rc params, muted palette, paper sizing guidance
 - [references/data-patterns.md](./references/data-patterns.md): common pandas reshape / aggregation patterns
 - [references/troubleshooting.md](./references/troubleshooting.md): common matplotlib / seaborn issues and fixes
+- [examples/comparison_results.csv](./examples/comparison_results.csv): a real sample input table
+- [examples/generate_comparison_bar.py](./examples/generate_comparison_bar.py): a deterministic example plotting script
+- [scripts/install-skill.sh](./scripts/install-skill.sh): one-command install into `~/.claude/skills`
 
 ## Quick Start
 
@@ -98,6 +112,43 @@ make test
 make test-release
 ```
 
+### 4. Generate the example figure
+
+```bash
+make example
+```
+
+This writes:
+
+- `examples/output/comparison_bar_example.pdf`
+- `examples/output/comparison_bar_example.png`
+
+## Install Into `~/.claude/skills`
+
+To copy this skill into the default Claude skills directory:
+
+```bash
+./scripts/install-skill.sh
+```
+
+To install into a custom skills root:
+
+```bash
+./scripts/install-skill.sh /path/to/skills
+```
+
+Or:
+
+```bash
+CLAUDE_SKILLS_HOME=/path/to/skills ./scripts/install-skill.sh
+```
+
+## Example Output
+
+The repository includes a committed example render produced from [examples/comparison_results.csv](./examples/comparison_results.csv):
+
+![Example figure output](./examples/output/comparison_bar_example.png)
+
 ## Example User Requests
 
 Typical requests that should trigger this skill:
@@ -140,6 +191,8 @@ Useful commands:
 git status
 make test
 make test-release
+make example
+./scripts/install-skill.sh
 ```
 
 If you modify chart defaults or export rules, rerun both test targets before pushing.

README_ZH.md

@@ -52,12 +52,19 @@ figure-plot/
 ├── .gitignore
 ├── agents/
 │   └── openai.yaml
+├── examples/
+│   ├── comparison_results.csv
+│   ├── generate_comparison_bar.py
+│   └── output/
+│       ├── comparison_bar_example.png
+│       └── comparison_bar_example.pdf
 ├── references/
 │   ├── plot-presets.md
 │   ├── style-guide.md
 │   ├── data-patterns.md
 │   └── troubleshooting.md
 ├── scripts/
+│   ├── install-skill.sh
 │   ├── check-deps.sh
 │   ├── self-test.sh
 │   └── release-test.sh
@@ -73,6 +80,9 @@ figure-plot/
 - [references/data-patterns.md](./references/data-patterns.md)：常见 pandas reshape / 聚合模式
 - [references/troubleshooting.md](./references/troubleshooting.md)：常见 matplotlib / seaborn 问题和修复方法
 - [agents/openai.yaml](./agents/openai.yaml)：Skill UI 元数据
+- [examples/comparison_results.csv](./examples/comparison_results.csv)：真实示例输入数据
+- [examples/generate_comparison_bar.py](./examples/generate_comparison_bar.py)：可运行的示例绘图脚本
+- [scripts/install-skill.sh](./scripts/install-skill.sh)：一键安装到 `~/.claude/skills`
 
 ## 快速开始
 
@@ -106,6 +116,43 @@ make test
 make test-release
 ```
 
+### 4. 生成示例图
+
+```bash
+make example
+```
+
+会生成：
+
+- `examples/output/comparison_bar_example.pdf`
+- `examples/output/comparison_bar_example.png`
+
+## 一键安装到 `~/.claude/skills`
+
+默认安装到 Claude 的技能目录：
+
+```bash
+./scripts/install-skill.sh
+```
+
+安装到指定路径：
+
+```bash
+./scripts/install-skill.sh /path/to/skills
+```
+
+或者：
+
+```bash
+CLAUDE_SKILLS_HOME=/path/to/skills ./scripts/install-skill.sh
+```
+
+## 示例输出
+
+仓库里已经提交了一份基于 [examples/comparison_results.csv](./examples/comparison_results.csv) 生成的示例图：
+
+![示例图输出](./examples/output/comparison_bar_example.png)
+
 ## 典型触发请求
 
 下面这些请求都应该触发这个 Skill：
@@ -146,6 +193,8 @@ make test-release
 git status
 make test
 make test-release
+make example
+./scripts/install-skill.sh
 ```
 
 如果修改了图类默认值、导出规则或脚本，至少重新跑两套测试再提交。

examples/comparison_results.csv

@@ -0,0 +1,4 @@
+Dataset,Ours,BaselineA,BaselineB
+Cora,87.3,83.1,81.5
+Citeseer,91.2,87.5,86.0
+Pubmed,78.4,74.2,73.1

examples/generate_comparison_bar.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+cache_root = Path(os.environ.get("FIGURE_PLOT_CACHE_DIR", Path(__file__).resolve().parent / ".cache"))
+os.environ.setdefault("MPLBACKEND", "Agg")
+os.environ.setdefault("MPLCONFIGDIR", str(cache_root / "mplconfig"))
+os.environ.setdefault("XDG_CACHE_HOME", str(cache_root / "xdg-cache"))
+Path(os.environ["MPLCONFIGDIR"]).mkdir(parents=True, exist_ok=True)
+Path(os.environ["XDG_CACHE_HOME"]).mkdir(parents=True, exist_ok=True)
+
+import matplotlib.pyplot as plt
+import numpy as np
+import pandas as pd
+
+
+def main() -> int:
+    repo_root = Path(__file__).resolve().parent.parent
+    example_dir = repo_root / "examples"
+    output_dir = example_dir / "output"
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    csv_path = example_dir / "comparison_results.csv"
+    df = pd.read_csv(csv_path)
+
+    plt.rcParams.update(
+        {
+            "font.family": "sans-serif",
+            "font.sans-serif": ["Arial", "DejaVu Sans", "Helvetica"],
+            "font.size": 9,
+            "axes.labelsize": 9,
+            "xtick.labelsize": 8,
+            "ytick.labelsize": 8,
+            "legend.fontsize": 8,
+            "lines.linewidth": 1.8,
+            "axes.linewidth": 0.8,
+            "axes.facecolor": "white",
+            "figure.facecolor": "white",
+            "axes.grid": True,
+            "axes.grid.axis": "y",
+            "grid.color": "#e5e7eb",
+            "grid.linewidth": 0.6,
+            "axes.spines.top": False,
+            "axes.spines.right": False,
+            "pdf.fonttype": 42,
+            "ps.fonttype": 42,
+            "savefig.dpi": 300,
+        }
+    )
+
+    methods = ["Ours", "BaselineA", "BaselineB"]
+    datasets = df["Dataset"].tolist()
+    values = df[methods].to_numpy()
+    colors = ["#4C6A92", "#7A8F63", "#B5875A"]
+
+    fig, ax = plt.subplots(figsize=(3.5, 2.5))
+    x = np.arange(len(datasets))
+    width = 0.22
+    offsets = np.linspace(-(len(methods) - 1) / 2, (len(methods) - 1) / 2, len(methods)) * width
+
+    for i, (name, off) in enumerate(zip(methods, offsets)):
+        ax.bar(x + off, values[:, i], width=width * 0.92, label=name, color=colors[i], zorder=3)
+
+    ax.set_xticks(x)
+    ax.set_xticklabels(datasets)
+    ax.set_ylabel("Accuracy (%)")
+    ax.set_ylim(bottom=70)
+    ax.legend(loc="upper right", framealpha=0.9)
+    fig.tight_layout(pad=0.4)
+
+    png_path = output_dir / "comparison_bar_example.png"
+    pdf_path = output_dir / "comparison_bar_example.pdf"
+    fig.savefig(pdf_path, bbox_inches="tight")
+    fig.savefig(png_path, bbox_inches="tight")
+
+    print(f"csv={csv_path}")
+    print(f"png={png_path}")
+    print(f"pdf={pdf_path}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

examples/output/comparison_bar_example.pdf

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "$0")" && pwd)"
+repo_root="$(cd "$script_dir/.." && pwd)"
+
+target_root="${1:-${CLAUDE_SKILLS_HOME:-$HOME/.claude/skills}}"
+target_dir="$target_root/figure-plot"
+
+mkdir -p "$target_root"
+rm -rf "$target_dir"
+mkdir -p "$target_dir"
+
+if command -v rsync >/dev/null 2>&1; then
+  rsync -a \
+    --exclude '.git/' \
+    --exclude '__pycache__/' \
+    "$repo_root/" "$target_dir/"
+else
+  cp -R "$repo_root/." "$target_dir/"
+  rm -rf "$target_dir/.git"
+  find "$target_dir" -name '__pycache__' -type d -prune -exec rm -rf {} +
+fi
+
+echo "[figure-plot] installed to: $target_dir"