You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: skills/ghcrawl/SKILL.md
+3-19Lines changed: 3 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
name: ghcrawl
3
3
description: "Use the local ghcrawl CLI to inspect duplicate clusters and issue/PR summaries from the existing ghcrawl dataset, and refresh one repo only when the user explicitly asks. Use when a user wants to triage related issues or PRs, inspect semantic clusters, or run ghcrawl's staged refresh pipeline."
@@ -31,13 +31,9 @@ Also never run `close-thread` or `close-cluster` unless the user explicitly asks
31
31
32
32
## Command preference
33
33
34
-
Prefer the installed `ghcrawl` bin.
34
+
Use the installed `ghcrawl` bin directly.
35
35
36
-
If `ghcrawl` is not on `PATH`, use:
37
-
38
-
```bash
39
-
npx ghcrawl cli ...
40
-
```
36
+
If `ghcrawl` is not on `PATH`, stop and tell the user the local `ghcrawl` binary is unavailable. Do not fall back to repo-local wrappers. If the user is actively maintaining `ghcrawl` itself and explicitly wants source-tree commands, use the maintainer workflow in `CONTRIBUTING.md`.
41
37
42
38
Do not start by running `ghcrawl --help` or `<subcommand> --help`. The documented command surface in this skill and [references/protocol.md](references/protocol.md) is the default source of truth. Only use help output when the user explicitly asks about CLI syntax or you are actively maintaining ghcrawl itself.
43
39
@@ -95,12 +91,6 @@ Run:
95
91
ghcrawl doctor --json
96
92
```
97
93
98
-
If the bin is unavailable, fall back to:
99
-
100
-
```bash
101
-
pnpm --filter ghcrawl cli doctor --json
102
-
```
103
-
104
94
Only do this when:
105
95
106
96
- the user explicitly wants an API-backed operation such as `refresh`, `sync`, `embed`, or `cluster`
@@ -115,12 +105,6 @@ If `doctor` is unhealthy but the user asked only for read-only inspection, say t
115
105
116
106
### 3. If the CLI is unavailable or misbehaving
117
107
118
-
Use one supported fallback path before giving up:
119
-
120
-
```bash
121
-
pnpm --filter ghcrawl cli ...
122
-
```
123
-
124
108
If a documented `ghcrawl` command still fails, hangs, or returns unusable output through the supported CLI path, stop and report that to the user. Do not inspect tables, schema, or rows with `sqlite3`, `pragma`, or ad hoc SQL.
125
109
126
110
### 4. Refresh local data only when explicitly requested
If the supported CLI path still fails, hangs, or returns unusable output, stop and tell the user there is a ghcrawl CLI problem. Do not fall back to direct SQLite inspection.
170
+
## CLI availability
171
+
172
+
Use the installed `ghcrawl` binary directly.
173
+
174
+
If `ghcrawl` is missing on `PATH`, stop and tell the user the local `ghcrawl` binary is unavailable. Do not fall back to project-local wrappers or direct SQLite inspection. If the user is actively maintaining `ghcrawl` itself and explicitly wants source-tree commands, use the maintainer workflow documented in `CONTRIBUTING.md`.
0 commit comments