From b4d759ef5426a1ceb6e18b6e63ad68615fd50d3f Mon Sep 17 00:00:00 2001 From: Syed Fahad Date: Tue, 17 Nov 2026 07:29:19 +0530 Subject: [PATCH 1/4] move the graphify skill to skills/graphify/SKILL.md --- .mintlify/skills | 1 + CONTRIBUTING.md | 2 +- skill.md => skills/graphify/SKILL.md | 0 3 files changed, 2 insertions(+), 1 deletion(-) create mode 120000 .mintlify/skills rename skill.md => skills/graphify/SKILL.md (100%) diff --git a/.mintlify/skills b/.mintlify/skills new file mode 120000 index 0000000..42c5394 --- /dev/null +++ b/.mintlify/skills @@ -0,0 +1 @@ +../skills \ No newline at end of file diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c6ab51d..bd8ad83 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -42,7 +42,7 @@ After a big change to the setup pages, also try these by hand in a fresh Claude ### 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. +When you change the `description` in `skills/graphify/SKILL.md` (served at https://docs.graphify.com/skill.md, and linked from `.mintlify/skills` so Mintlify finds it), 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: diff --git a/skill.md b/skills/graphify/SKILL.md similarity index 100% rename from skill.md rename to skills/graphify/SKILL.md From bc3d6eb5ddd50502515f34f6f50a551adf6b725c Mon Sep 17 00:00:00 2001 From: Syed Fahad Date: Tue, 17 Nov 2026 07:31:44 +0530 Subject: [PATCH 2/4] keep the skill source out of the rendered pages --- .mintignore | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.mintignore b/.mintignore index 9e42cf8..56631a3 100644 --- a/.mintignore +++ b/.mintignore @@ -11,3 +11,6 @@ scripts/ # Contributor instructions for agents editing this repo AGENTS.md + +# Agent skill source, served at /skill.md and /.well-known/skills/ through .mintlify/skills +skills/ From 3ba9f4977cfce8dea7ea8513632e5ab02fd91efb Mon Sep 17 00:00:00 2001 From: Syed Fahad Date: Tue, 17 Nov 2026 07:33:48 +0530 Subject: [PATCH 3/4] keep the skill file under .mintlify and link skills/ to it --- .mintignore | 2 +- .mintlify/skills | 1 - {skills => .mintlify/skills}/graphify/SKILL.md | 0 CONTRIBUTING.md | 2 +- skills | 1 + 5 files changed, 3 insertions(+), 3 deletions(-) delete mode 120000 .mintlify/skills rename {skills => .mintlify/skills}/graphify/SKILL.md (100%) create mode 120000 skills diff --git a/.mintignore b/.mintignore index 56631a3..298e027 100644 --- a/.mintignore +++ b/.mintignore @@ -12,5 +12,5 @@ scripts/ # Contributor instructions for agents editing this repo AGENTS.md -# Agent skill source, served at /skill.md and /.well-known/skills/ through .mintlify/skills +# Link to .mintlify/skills for the skills CLI. The skill is served at /skill.md and /.well-known/skills/ skills/ diff --git a/.mintlify/skills b/.mintlify/skills deleted file mode 120000 index 42c5394..0000000 --- a/.mintlify/skills +++ /dev/null @@ -1 +0,0 @@ -../skills \ No newline at end of file diff --git a/skills/graphify/SKILL.md b/.mintlify/skills/graphify/SKILL.md similarity index 100% rename from skills/graphify/SKILL.md rename to .mintlify/skills/graphify/SKILL.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bd8ad83..c86aab2 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -42,7 +42,7 @@ After a big change to the setup pages, also try these by hand in a fresh Claude ### Skill trigger check -When you change the `description` in `skills/graphify/SKILL.md` (served at https://docs.graphify.com/skill.md, and linked from `.mintlify/skills` so Mintlify finds it), 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. +When you change the `description` in `.mintlify/skills/graphify/SKILL.md` (served at https://docs.graphify.com/skill.md, and linked from `skills/` so `npx skills add Graphify-Labs/docs` finds it), 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: diff --git a/skills b/skills new file mode 120000 index 0000000..08285b8 --- /dev/null +++ b/skills @@ -0,0 +1 @@ +.mintlify/skills \ No newline at end of file From 6bc1021638edb6b376fd74c48de064f0fe22dc3c Mon Sep 17 00:00:00 2001 From: Syed Fahad Date: Tue, 17 Nov 2026 07:35:33 +0530 Subject: [PATCH 4/4] only ignore the top-level skills link --- .mintignore | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.mintignore b/.mintignore index 298e027..0145ba5 100644 --- a/.mintignore +++ b/.mintignore @@ -13,4 +13,4 @@ scripts/ AGENTS.md # Link to .mintlify/skills for the skills CLI. The skill is served at /skill.md and /.well-known/skills/ -skills/ +/skills/