Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
7 changes: 6 additions & 1 deletion skill.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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.
Expand Down
Loading