From ac6bb274a17d37a7ea20678ab722ae0aea747a67 Mon Sep 17 00:00:00 2001 From: safishamsi Date: Tue, 7 Jul 2026 11:34:54 +0100 Subject: [PATCH] docs(skill): fix stale /graphify usage comment that claimed an Obsidian vault by default (#1681) The Usage block's bare `/graphify` comment read "full pipeline on current directory -> Obsidian vault", contradicting Step 6 (HTML viz always; Obsidian vault only when --obsidian is explicitly given). The comment predated the opt-in change and told agents a bare /graphify produces a vault. It now reads "full pipeline on current directory (HTML viz; add --obsidian for a vault)". Fixed at the skillgen source (fragments/core/core.md + the aider monolith override), added a sanctioned-diff predicate so the monolith round-trip guard allows the change, and re-blessed the expected/ snapshots. Every generated skill-*.md now carries the corrected comment; the only content change across all rendered files is this one line. Co-Authored-By: Claude Opus 4.8 (1M context) --- graphify/skill-agents.md | 2 +- graphify/skill-aider.md | 2 +- graphify/skill-amp.md | 2 +- graphify/skill-claw.md | 2 +- graphify/skill-codex.md | 2 +- graphify/skill-copilot.md | 2 +- graphify/skill-droid.md | 2 +- graphify/skill-kilo.md | 2 +- graphify/skill-kiro.md | 2 +- graphify/skill-opencode.md | 2 +- graphify/skill-pi.md | 2 +- graphify/skill-trae.md | 2 +- graphify/skill-vscode.md | 2 +- graphify/skill-windows.md | 2 +- graphify/skill.md | 2 +- tools/skillgen/expected/graphify__skill-agents.md | 2 +- tools/skillgen/expected/graphify__skill-aider.md | 2 +- tools/skillgen/expected/graphify__skill-amp.md | 2 +- tools/skillgen/expected/graphify__skill-claw.md | 2 +- tools/skillgen/expected/graphify__skill-codex.md | 2 +- tools/skillgen/expected/graphify__skill-copilot.md | 2 +- tools/skillgen/expected/graphify__skill-droid.md | 2 +- tools/skillgen/expected/graphify__skill-kilo.md | 2 +- tools/skillgen/expected/graphify__skill-kiro.md | 2 +- tools/skillgen/expected/graphify__skill-opencode.md | 2 +- tools/skillgen/expected/graphify__skill-pi.md | 2 +- tools/skillgen/expected/graphify__skill-trae.md | 2 +- tools/skillgen/expected/graphify__skill-vscode.md | 2 +- tools/skillgen/expected/graphify__skill-windows.md | 2 +- tools/skillgen/expected/graphify__skill.md | 2 +- tools/skillgen/fragments/core/aider.md | 2 +- tools/skillgen/fragments/core/core.md | 2 +- tools/skillgen/gen.py | 12 ++++++++++++ 33 files changed, 44 insertions(+), 32 deletions(-) diff --git a/graphify/skill-agents.md b/graphify/skill-agents.md index 2e19931f..1b3da7c5 100644 --- a/graphify/skill-agents.md +++ b/graphify/skill-agents.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-aider.md b/graphify/skill-aider.md index 2ccf5326..3559b480 100644 --- a/graphify/skill-aider.md +++ b/graphify/skill-aider.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify --mode deep # thorough extraction, richer INFERRED edges /graphify --update # incremental - re-extract only new/changed files diff --git a/graphify/skill-amp.md b/graphify/skill-amp.md index 2e19931f..1b3da7c5 100644 --- a/graphify/skill-amp.md +++ b/graphify/skill-amp.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-claw.md b/graphify/skill-claw.md index b3542438..a53809df 100644 --- a/graphify/skill-claw.md +++ b/graphify/skill-claw.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-codex.md b/graphify/skill-codex.md index e6e411ea..36cadce5 100644 --- a/graphify/skill-codex.md +++ b/graphify/skill-codex.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-copilot.md b/graphify/skill-copilot.md index b3542438..a53809df 100644 --- a/graphify/skill-copilot.md +++ b/graphify/skill-copilot.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-droid.md b/graphify/skill-droid.md index d1147b90..2bef076d 100644 --- a/graphify/skill-droid.md +++ b/graphify/skill-droid.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-kilo.md b/graphify/skill-kilo.md index c4557816..d3aca08c 100644 --- a/graphify/skill-kilo.md +++ b/graphify/skill-kilo.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-kiro.md b/graphify/skill-kiro.md index b3542438..a53809df 100644 --- a/graphify/skill-kiro.md +++ b/graphify/skill-kiro.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-opencode.md b/graphify/skill-opencode.md index 684e0e22..2aa66f5b 100644 --- a/graphify/skill-opencode.md +++ b/graphify/skill-opencode.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-pi.md b/graphify/skill-pi.md index b3542438..a53809df 100644 --- a/graphify/skill-pi.md +++ b/graphify/skill-pi.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-trae.md b/graphify/skill-trae.md index ac16b925..c1635cde 100644 --- a/graphify/skill-trae.md +++ b/graphify/skill-trae.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-vscode.md b/graphify/skill-vscode.md index 31a3352f..30247498 100644 --- a/graphify/skill-vscode.md +++ b/graphify/skill-vscode.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill-windows.md b/graphify/skill-windows.md index 5a55c577..b298f29a 100644 --- a/graphify/skill-windows.md +++ b/graphify/skill-windows.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/graphify/skill.md b/graphify/skill.md index b3542438..a53809df 100644 --- a/graphify/skill.md +++ b/graphify/skill.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-agents.md b/tools/skillgen/expected/graphify__skill-agents.md index 2e19931f..1b3da7c5 100644 --- a/tools/skillgen/expected/graphify__skill-agents.md +++ b/tools/skillgen/expected/graphify__skill-agents.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-aider.md b/tools/skillgen/expected/graphify__skill-aider.md index 2ccf5326..3559b480 100644 --- a/tools/skillgen/expected/graphify__skill-aider.md +++ b/tools/skillgen/expected/graphify__skill-aider.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify --mode deep # thorough extraction, richer INFERRED edges /graphify --update # incremental - re-extract only new/changed files diff --git a/tools/skillgen/expected/graphify__skill-amp.md b/tools/skillgen/expected/graphify__skill-amp.md index 2e19931f..1b3da7c5 100644 --- a/tools/skillgen/expected/graphify__skill-amp.md +++ b/tools/skillgen/expected/graphify__skill-amp.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-claw.md b/tools/skillgen/expected/graphify__skill-claw.md index b3542438..a53809df 100644 --- a/tools/skillgen/expected/graphify__skill-claw.md +++ b/tools/skillgen/expected/graphify__skill-claw.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-codex.md b/tools/skillgen/expected/graphify__skill-codex.md index e6e411ea..36cadce5 100644 --- a/tools/skillgen/expected/graphify__skill-codex.md +++ b/tools/skillgen/expected/graphify__skill-codex.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-copilot.md b/tools/skillgen/expected/graphify__skill-copilot.md index b3542438..a53809df 100644 --- a/tools/skillgen/expected/graphify__skill-copilot.md +++ b/tools/skillgen/expected/graphify__skill-copilot.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-droid.md b/tools/skillgen/expected/graphify__skill-droid.md index d1147b90..2bef076d 100644 --- a/tools/skillgen/expected/graphify__skill-droid.md +++ b/tools/skillgen/expected/graphify__skill-droid.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-kilo.md b/tools/skillgen/expected/graphify__skill-kilo.md index c4557816..d3aca08c 100644 --- a/tools/skillgen/expected/graphify__skill-kilo.md +++ b/tools/skillgen/expected/graphify__skill-kilo.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-kiro.md b/tools/skillgen/expected/graphify__skill-kiro.md index b3542438..a53809df 100644 --- a/tools/skillgen/expected/graphify__skill-kiro.md +++ b/tools/skillgen/expected/graphify__skill-kiro.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-opencode.md b/tools/skillgen/expected/graphify__skill-opencode.md index 684e0e22..2aa66f5b 100644 --- a/tools/skillgen/expected/graphify__skill-opencode.md +++ b/tools/skillgen/expected/graphify__skill-opencode.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-pi.md b/tools/skillgen/expected/graphify__skill-pi.md index b3542438..a53809df 100644 --- a/tools/skillgen/expected/graphify__skill-pi.md +++ b/tools/skillgen/expected/graphify__skill-pi.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-trae.md b/tools/skillgen/expected/graphify__skill-trae.md index ac16b925..c1635cde 100644 --- a/tools/skillgen/expected/graphify__skill-trae.md +++ b/tools/skillgen/expected/graphify__skill-trae.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-vscode.md b/tools/skillgen/expected/graphify__skill-vscode.md index 31a3352f..30247498 100644 --- a/tools/skillgen/expected/graphify__skill-vscode.md +++ b/tools/skillgen/expected/graphify__skill-vscode.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill-windows.md b/tools/skillgen/expected/graphify__skill-windows.md index 5a55c577..b298f29a 100644 --- a/tools/skillgen/expected/graphify__skill-windows.md +++ b/tools/skillgen/expected/graphify__skill-windows.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/expected/graphify__skill.md b/tools/skillgen/expected/graphify__skill.md index b3542438..a53809df 100644 --- a/tools/skillgen/expected/graphify__skill.md +++ b/tools/skillgen/expected/graphify__skill.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/fragments/core/aider.md b/tools/skillgen/fragments/core/aider.md index 2ccf5326..3559b480 100644 --- a/tools/skillgen/fragments/core/aider.md +++ b/tools/skillgen/fragments/core/aider.md @@ -10,7 +10,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify --mode deep # thorough extraction, richer INFERRED edges /graphify --update # incremental - re-extract only new/changed files diff --git a/tools/skillgen/fragments/core/core.md b/tools/skillgen/fragments/core/core.md index 0516b3a6..8d8aab7a 100644 --- a/tools/skillgen/fragments/core/core.md +++ b/tools/skillgen/fragments/core/core.md @@ -7,7 +7,7 @@ Turn any folder of files into a navigable knowledge graph with community detecti ## Usage ``` -/graphify # full pipeline on current directory → Obsidian vault +/graphify # full pipeline on current directory (HTML viz; add --obsidian for a vault) /graphify # full pipeline on specific path /graphify https://github.com// # clone repo then run full pipeline on it /graphify https://github.com// --branch # clone a specific branch diff --git a/tools/skillgen/gen.py b/tools/skillgen/gen.py index 0082e9e5..e742a62c 100644 --- a/tools/skillgen/gen.py +++ b/tools/skillgen/gen.py @@ -877,6 +877,17 @@ def _is_shebang_allowlist_fix_line(line: str) -> bool: return "[!a-zA-Z0-9/_." in line +def _is_obsidian_usage_comment_line(line: str) -> bool: + """Whether a line is part of the ``/graphify`` usage-comment fix (#1681). + + The Usage block's bare ``/graphify`` comment said "full pipeline on current + directory -> Obsidian vault", contradicting Step 6 (HTML always; Obsidian vault + only when ``--obsidian`` is explicitly given). The comment now describes the + real default. Both the old (removed) and new (added) comment forms match here. + """ + return "# full pipeline on current directory" in line + + # Every line that may differ between a rendered monolith and its pristine v8 # baseline. Each predicate documents one sanctioned change-class; a blank line is # allowed because the multi-line fix blocks insert spacing. Anything else failing @@ -892,6 +903,7 @@ _SANCTIONED_MONOLITH_DIFFS = ( _is_manifest_root_fix_line, _is_no_api_key_fix_line, _is_shebang_allowlist_fix_line, + _is_obsidian_usage_comment_line, )