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
Fix duplicate skill docs and overly broad tarball cleanup
- Merge duplicate '## Skills' and '## Cursor Skills' sections in agent-setup.md
into a single consolidated section with the most complete descriptions
- Fix tarball cleanup in packdep.js to use regex matching version number (digit)
after prefix, preventing false matches on similarly-named packages
(e.g., 'edge-core-' no longer matches 'edge-core-js-*.tgz')
Copy file name to clipboardExpand all lines: docs/agent-setup.md
+14-66Lines changed: 14 additions & 66 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -30,17 +30,17 @@ Execute a planning document and iteratively refine the implementation until it p
30
30
31
31
## Skills
32
32
33
-
Skills are defined in `.cursor/skills/` and are automatically invoked by Cursor when relevant. They can also be referenced from commands via `@.cursor/skills/<name>/SKILL.md`.
33
+
Skills are defined in `.cursor/skills/` and provide reusable workflows that commands and other skills can invoke. They are also surfaced to the agent automatically and can be triggered directly.
34
34
35
35
### debug-edge
36
36
37
37
Compile, launch, and debug the Edge wallet app on an iOS simulator.
38
38
39
39
**Prerequisites**: Xcode, working directory `edge-react-gui`, MCP servers `xcodebuild` and `mobile-mcp`
40
40
41
-
**Workflow**: Install deps → Clean iOS → Prepare iOS → Start Metro → Build and launch → Login if needed
41
+
**Workflow**: Install deps → Clean iOS build artifacts → Prepare iOS → Clean Xcode build → Start Metro bundler → Build and launch app → Log into test account if needed
42
42
43
-
**Tip**: For plugin repo debugging (edge-core-js, edge-currency-accountbased, edge-exchange-plugins, edge-currency-plugins), use `log.warn()` instead of `console.log` to see output in Metro logs.
43
+
**Tip**: For plugin repo debugging (edge-core-js, edge-currency-accountbased, edge-exchange-plugins, edge-currency-plugins), use `log.warn()` instead of `console.log` to see output in Metro logs. Enable the corresponding `DEBUG_*` flag in `env.json` and run `yarn start` in the plugin repo for hot-reload.
44
44
45
45
### fix-code
46
46
@@ -58,31 +58,29 @@ Address reviewer comments on a GitHub pull request.
58
58
59
59
**Usage**: Provide a GitHub PR URL or number.
60
60
61
-
**Workflow**: Collect reviewer comments → Create fix plan → Pause for user iteration → Implement fixes with fixup commits → Push with `--force-with-lease`
61
+
**Workflow**: Fetch reviewer comments → Filter actionable items → Create fix plan in `/tmp`→ Pause for user approval → Implement each fix as a fixup commit (checkout original commit, edit, cherry-pick remaining) → Push with `--force-with-lease`
62
62
63
63
**Constraints**: Does not auto-squash. Leaves fixup commits visible for reviewer.
64
64
65
-
### package-deps
66
-
67
-
Package local dependency repos and link them to edge-react-gui for testing.
65
+
### gh-review
68
66
69
-
**Usage**: Specify dependency repos to package.
67
+
Orchestrate an interactive GitHub PR review session using the `gh` CLI.
70
68
71
-
**Workflow**: `npm pack` → Rename with UTC timestamp → Copy to edge-react-gui → Update `package.json` reference
69
+
**Prerequisites**: `gh` CLI installed and authenticated
72
70
73
-
### review-code
71
+
**Usage**: Provide a PR reference (URL, number, or "current PR") and comment instructions.
74
72
75
-
Review code changes for quality and convention compliance.
73
+
**Workflow**: Start or resume a pending review → Add inline comments interactively (single-line or multi-line) via GraphQL API → Present summary of all comments → Submit only after explicit user confirmation as APPROVE, COMMENT, or REQUEST_CHANGES
76
74
77
-
**Usage**: Provide a GitHub PR URL, PR number, local branch name, or "current branch".
75
+
**Key detail**: Uses GraphQL `addPullRequestReviewThread` for incremental comments because the REST API returns 422 when a pending review already exists.
78
76
79
-
**Workflow**: Checkout code → Get diff → Launch review subagents (`review-react`, `review-errors`, `review-state`, etc.) → Compile findings → Save to `/tmp` → For PRs: submit inline comments via GitHub MCP
77
+
### package-deps
80
78
81
-
---
79
+
Package local dependency repos and link them to edge-react-gui for testing.
82
80
83
-
## Cursor Skills
81
+
**Usage**: Specify dependency repos to package.
84
82
85
-
Skills are defined in `.cursor/skills/` and provide reusable workflows that commands and other skills can invoke. They are also surfaced to the agent automatically and can be triggered directly.
83
+
**Workflow**: `npm pack` → Rename with UTC timestamp → Copy to edge-react-gui → Update `package.json` reference
86
84
87
85
### review-code
88
86
@@ -94,56 +92,6 @@ Review code changes for quality and convention compliance. Supports both GitHub
94
92
95
93
---
96
94
97
-
### fix-pr
98
-
99
-
Address reviewer comments on a GitHub pull request.
100
-
101
-
**Usage**: Provide a GitHub PR URL or number.
102
-
103
-
**Workflow**: Fetch reviewer comments → Filter actionable items → Create fix plan in `/tmp` → Pause for user approval → Implement each fix as a fixup commit (checkout original commit, edit, cherry-pick remaining) → Push with `--force-with-lease`
104
-
105
-
**Constraints**: Does not auto-squash. Leaves fixup commits visible for reviewer.
106
-
107
-
---
108
-
109
-
### fix-code
110
-
111
-
Implement fixes from a plan document by editing code.
112
-
113
-
**Usage**: Provide a plan document path (typically generated by `fix-pr` or `review-code`).
114
-
115
-
**Workflow**: Parse plan → Edit files → Run `yarn precommit` → Present summary
116
-
117
-
**Constraints**: Does not commit or push. Leaves changes unstaged for user review.
118
-
119
-
---
120
-
121
-
### debug-edge
122
-
123
-
Compile, launch, and debug the Edge wallet app on an iOS simulator.
124
-
125
-
**Prerequisites**: Xcode, working directory `edge-react-gui`, MCP servers `xcodebuild` and `mobile-mcp`
126
-
127
-
**Workflow**: Install deps → Clean iOS build artifacts → Prepare iOS → Clean Xcode build → Start Metro bundler → Build and launch app → Log into test account if needed
128
-
129
-
**Tip**: For plugin repo debugging (edge-core-js, edge-currency-accountbased, edge-exchange-plugins, edge-currency-plugins), use `log.warn()` instead of `console.log` to see output in Metro logs. Enable the corresponding `DEBUG_*` flag in `env.json` and run `yarn start` in the plugin repo for hot-reload.
130
-
131
-
---
132
-
133
-
### gh-review
134
-
135
-
Orchestrate an interactive GitHub PR review session using the `gh` CLI.
136
-
137
-
**Prerequisites**: `gh` CLI installed and authenticated
138
-
139
-
**Usage**: Provide a PR reference (URL, number, or "current PR") and comment instructions.
140
-
141
-
**Workflow**: Start or resume a pending review → Add inline comments interactively (single-line or multi-line) via GraphQL API → Present summary of all comments → Submit only after explicit user confirmation as APPROVE, COMMENT, or REQUEST_CHANGES
142
-
143
-
**Key detail**: Uses GraphQL `addPullRequestReviewThread` for incremental comments because the REST API returns 422 when a pending review already exists.
144
-
145
-
---
146
-
147
95
## Best Practices
148
96
149
97
1.**Monitor Metro bundler** when debugging—JavaScript logs appear there
0 commit comments