lee/graphify
1
0
Fork 0
mirror of https://github.com/safishamsi/graphify.git synced 2026-07-11 18:07:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(skill): fix stale /graphify usage comment that claimed an Obsidian vault by default (#1681)

Browse Source 
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) <noreply@anthropic.com>
This commit is contained in:
safishamsi
2026-07-07 11:34:54 +01:00
parent 23457d11ff
commit ac6bb274a1
33 changed files with 44 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
graphify/skill-agents.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-aider.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify <path> --mode deep # thorough extraction, richer INFERRED edges
/graphify <path> --update # incremental - re-extract only new/changed files
graphify/skill-amp.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-claw.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-codex.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-copilot.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-droid.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-kilo.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-kiro.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-opencode.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-pi.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-trae.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-vscode.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill-windows.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
graphify/skill.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-agents.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-aider.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify <path> --mode deep # thorough extraction, richer INFERRED edges
/graphify <path> --update # incremental - re-extract only new/changed files
tools/skillgen/expected/graphify__skill-amp.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-claw.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-codex.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-copilot.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-droid.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-kilo.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-kiro.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-opencode.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-pi.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-trae.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-vscode.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill-windows.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/expected/graphify__skill.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/fragments/core/aider.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify <path> --mode deep # thorough extraction, richer INFERRED edges
/graphify <path> --update # incremental - re-extract only new/changed files
tools/skillgen/fragments/core/core.md
+1 -1
View File
@@ -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 <path> # full pipeline on specific path
/graphify https://github.com/<owner>/<repo> # clone repo then run full pipeline on it
/graphify https://github.com/<owner>/<repo> --branch <branch> # clone a specific branch
tools/skillgen/gen.py
+12
View File
@@ -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,
)