From a15cb36dfcdb1630044a3140c981bea9954b95aa Mon Sep 17 00:00:00 2001 From: Arjun Pramanik Date: Thu, 7 May 2026 15:07:49 -0400 Subject: [PATCH] fix(skills): rewrite YAML descriptions from pipeline-only to trigger-oriented (#774) 10 skill-*.md files had descriptions that only described what graphify does (input->pipeline->output), not when agents should use it. This meant skills never loaded proactively on codebase questions. Changed to hybrid descriptions that retain the pipeline summary but add trigger conditions: 'Use when user asks any question about a codebase, project content, architecture, or file relationships'. --- graphify/skill-aider.md | 2 +- graphify/skill-claw.md | 2 +- graphify/skill-codex.md | 2 +- graphify/skill-copilot.md | 2 +- graphify/skill-droid.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 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/graphify/skill-aider.md b/graphify/skill-aider.md index de570445..3a734e9d 100644 --- a/graphify/skill-aider.md +++ b/graphify/skill-aider.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-claw.md b/graphify/skill-claw.md index 865eae26..8d7da315 100644 --- a/graphify/skill-claw.md +++ b/graphify/skill-claw.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-codex.md b/graphify/skill-codex.md index febdb6ee..ecf39987 100644 --- a/graphify/skill-codex.md +++ b/graphify/skill-codex.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-copilot.md b/graphify/skill-copilot.md index 69f4df52..04a70582 100644 --- a/graphify/skill-copilot.md +++ b/graphify/skill-copilot.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-droid.md b/graphify/skill-droid.md index 8c649da1..6fec34fa 100644 --- a/graphify/skill-droid.md +++ b/graphify/skill-droid.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-opencode.md b/graphify/skill-opencode.md index 3f1c0053..dfa3541b 100644 --- a/graphify/skill-opencode.md +++ b/graphify/skill-opencode.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-pi.md b/graphify/skill-pi.md index b0844794..f1fb81fc 100644 --- a/graphify/skill-pi.md +++ b/graphify/skill-pi.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images, video) → knowledge graph → clustered communities → HTML + JSON + GRAPH_REPORT.md +description: "any input (code, docs, papers, images, video) → knowledge graph → clustered communities → HTML + JSON + GRAPH_REPORT.md. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." --- # /graphify diff --git a/graphify/skill-trae.md b/graphify/skill-trae.md index 58ed168a..794a4148 100644 --- a/graphify/skill-trae.md +++ b/graphify/skill-trae.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-vscode.md b/graphify/skill-vscode.md index 9e5e3fbe..1fafd671 100644 --- a/graphify/skill-vscode.md +++ b/graphify/skill-vscode.md @@ -1,6 +1,6 @@ --- name: graphify -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify --- diff --git a/graphify/skill-windows.md b/graphify/skill-windows.md index f668c2f1..fb727df7 100644 --- a/graphify/skill-windows.md +++ b/graphify/skill-windows.md @@ -1,6 +1,6 @@ --- name: graphify-windows -description: any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report +description: "any input (code, docs, papers, images) → knowledge graph → clustered communities → HTML + JSON + audit report. Use when user asks any question about a codebase, project content, architecture, or file relationships — especially if graphify-out/ exists. Provides persistent graph with god nodes, community detection, and BFS/DFS query tools." trigger: /graphify ---