From 73f1b1d9409e89bea9b0d7fa2dc16cac46914834 Mon Sep 17 00:00:00 2001 From: Syed Fahad Date: Tue, 17 Nov 2026 07:26:36 +0530 Subject: [PATCH] widen the graphify skill triggers and tool list --- CONTRIBUTING.md | 30 ++++++++++++++++++++++++++++++ skill.md | 7 ++++++- 2 files changed, 36 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8ac6420..c6ab51d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -40,6 +40,36 @@ After a big change to the setup pages, also try these by hand in a fresh Claude - Install Graphify CLI. It should install the `graphifyy` package with uv or pipx. - Ask which languages Graphify CLI supports for a given language. The answer should match `open-source/features/languages`. +### Skill trigger check + +When you change the `description` in `skill.md`, install the skill in a fresh session (`npx skills add https://docs.graphify.com`) in a repository indexed in Graphify, then run each prompt below 3 times. Count it as a pass when the agent loads the Graphify skill in at least 2 of 3 runs for the "should load" prompts, and in at most 1 of 3 runs for the "should not load" prompts. + +Should load the skill: + +1. Set up Graphify in this project. +2. Where is `parseConfig` defined? +3. who calls the retry helper +4. How does checkout work in this repo? +5. Is there a path from the webhook handler to `chargeCard`? +6. I'm about to rename `UserService`. What could break, and which tests should I run? +7. Which other repositories depend on this package? +8. Did we decide anything about how we handle timeouts in the API client? +9. What did the review on PR 42 find? +10. Before I refactor the auth module, give me a map of what touches it. + +Should not load the skill: + +1. Find every line that logs "connection refused". +2. Fix the typo in README.md. +3. Write a unit test for this pure function I pasted. +4. What does HTTP 429 mean? +5. Convert this JSON file to YAML. +6. Run the test suite. +7. Bump the version in package.json. +8. Explain what a knowledge graph is in general. +9. What's the capital of France? +10. Format this file with Prettier. + ## Frontmatter ```yaml diff --git a/skill.md b/skill.md index 305f788..0a0aa7f 100644 --- a/skill.md +++ b/skill.md @@ -1,6 +1,6 @@ --- name: graphify -description: Connect a coding agent to Graphify, shared codebase context for teams and coding agents built on a codebase knowledge graph of the user's repositories, through the hosted MCP server at https://api.graphify.com/mcp. Use when the user asks to set up Graphify, or asks about code structure, where a symbol is defined, who calls a function, dependencies, or what a change could affect. +description: "Graphify is shared codebase context for teams and coding agents, served by the hosted MCP server at https://api.graphify.com/mcp. Use when the user wants to set up or connect Graphify, or asks a question that needs codebase context: where a symbol is defined, who calls a function, how a feature works, how one function reaches another, what a change could affect or which tests cover it, cross-repo dependencies, what the team already decided, or what a pull request review found. Use it even when the user does not name Graphify, if the project says the repository is indexed in Graphify." compatibility: Any MCP client that supports remote Streamable HTTP servers with OAuth sign-in. Graphify CLI needs Python and the graphifyy package. metadata: author: Graphify Labs @@ -59,6 +59,11 @@ Then follow the full steps at [docs.graphify.com/for-agents.md](https://docs.gra - `graphify_find`: where a symbol is defined. - `graphify_callers`: who calls a symbol. - `graphify_impact`: the callers and callees directly connected to a symbol, and what a change could affect. Set `include_risk` to rank hotspot files by linked-test coverage. +- `graphify_tests_for`: tests linked through the graph to a symbol or a file. It reads the graph and does not run tests. +- `graphify_trace`: directed call paths from `src` to `tgt`. Check `resolved.src` and `resolved.tgt`, since a name can resolve to a semantic match. An empty path means no path was found in the indexed graph. +- `recall`: search what the workspace remembers, such as earlier decisions. Pass `paths` and `symbols` for the code you are about to change so related notes rank first. An empty result means nothing relevant is remembered yet. +- `remember`: save one fact to the workspace's shared Memory. It writes, so ask the user first, and save only what they asked you to save. +- `review_status`: read how a pull request review went. Pass `pr_number` for one pull request, or omit it to list recent reviews. It does not start or re-run a review. - `list_workspaces` and `set_workspace`: see or switch the workspace. `set_workspace` changes state, so ask first. If a Graphify tool fails or the repository is not indexed, say so, then fall back to grep. Do not guess.