upleb.uk

Public git repos — served from a NIP-34 GRASP relay at git.upleb.uk

summaryrefslogtreecommitdiff
path: root/skills/ngit
diff options
context:
space:
mode:
authorDanConwayDev <DanConwayDev@protonmail.com>2026-03-05 10:39:19 +0000
committerDanConwayDev <DanConwayDev@protonmail.com>2026-03-05 10:39:19 +0000
commit4d23e609ec3d6c25b5f5918fd317eef02a434efe (patch)
treee8b6f295f6c9e2a335a6a38bc5ff637a02561943 /skills/ngit
parenta7ca31af8a326327fbebb1b6f688850fdc3627c6 (diff)
refine ngit skill: pr/issue command corrections
- ngit init: use user's preferred grasp server or fall back to defaults - note git push / git push --force can update existing PRs - prefer pr checkout over pr apply for agent use - issue/pr comment: --reply-to accepts ID or nevent - issue body supports markdown - restore --verbose flag to reference table - fix typos
Diffstat (limited to 'skills/ngit')
-rw-r--r--skills/ngit/SKILL.md26
1 files changed, 12 insertions, 14 deletions
diff --git a/skills/ngit/SKILL.md b/skills/ngit/SKILL.md
index 795ed91..6da6305 100644
--- a/skills/ngit/SKILL.md
+++ b/skills/ngit/SKILL.md
@@ -54,8 +54,7 @@ Standard git commands work directly with these URLs — `git-remote-nostr` resol
54## Publishing a repo 54## Publishing a repo
55 55
56```bash 56```bash
57ngit init # interactive 57ngit init --name "My Project" --description "What it does" -d # uses user's preferred grasp server or falls back to defaults
58ngit init --name "My Project" --description "What it does" -d # non-interactive
59ngit repo edit --description "New description" # update metadata 58ngit repo edit --description "New description" # update metadata
60ngit repo --json --offline # view repo info (check nostr_url field) 59ngit repo --json --offline # view repo info (check nostr_url field)
61``` 60```
@@ -80,7 +79,7 @@ git push -u origin pr/my-feature \
80 -o 'description=Summary.\n\nDetail here.' 79 -o 'description=Summary.\n\nDetail here.'
81``` 80```
82 81
83Push options `title=` and `description=` are required. Use `\n\n` for paragraph breaks. 82Push options `title=` and `description=` are required. Use `\n\n` for paragraph breaks. `git push` or `git push --force` can update existing prs.
84 83
85### Advanced: ngit send 84### Advanced: ngit send
86 85
@@ -99,14 +98,13 @@ ngit pr list --json --label bug
99ngit pr view <ID|nevent> --json 98ngit pr view <ID|nevent> --json
100ngit pr view <ID|nevent> --json --comments 99ngit pr view <ID|nevent> --json --comments
101ngit pr comment <ID|nevent> --body "Looks good" 100ngit pr comment <ID|nevent> --body "Looks good"
102ngit pr comment <ID|nevent> --body "Fixed!" --reply-to <comment-ID> 101ngit pr comment <ID|nevent> --body "Fixed!" --reply-to <comment-ID|nevent>
103``` 102```
104 103
105### Checkout / apply 104### Checkout / apply
106 105
107```bash 106```bash
108ngit pr checkout <ID|nevent> 107ngit pr checkout <ID|nevent>
109ngit pr apply <ID|nevent>
110``` 108```
111 109
112### Merge (maintainer) 110### Merge (maintainer)
@@ -129,7 +127,7 @@ ngit pr ready <ID|nevent> # mark draft as ready for review
129## Issues 127## Issues
130 128
131```bash 129```bash
132ngit issue create --title "Bug title" --body "Details" --label bug 130ngit issue create --title "Bug title" --body "Details as markdown" --label bug
133ngit issue create --title "Feature" --body "..." --label enhancement --label help-wanted 131ngit issue create --title "Feature" --body "..." --label enhancement --label help-wanted
134ngit issue list --json 132ngit issue list --json
135ngit issue list --json --status closed 133ngit issue list --json --status closed
@@ -137,7 +135,7 @@ ngit issue list --json --label bug
137ngit issue view <ID|nevent> --json 135ngit issue view <ID|nevent> --json
138ngit issue view <ID|nevent> --json --comments 136ngit issue view <ID|nevent> --json --comments
139ngit issue comment <ID|nevent> --body "Reproduced on v2.1" 137ngit issue comment <ID|nevent> --body "Reproduced on v2.1"
140ngit issue comment <ID|nevent> --body "Thanks!" --reply-to <comment-ID> 138ngit issue comment <ID|nevent> --body "Thanks!" --reply-to <comment-ID|nevent>
141ngit issue close <ID|nevent> 139ngit issue close <ID|nevent>
142ngit issue reopen <ID|nevent> 140ngit issue reopen <ID|nevent>
143``` 141```
@@ -164,14 +162,14 @@ ngit sync --ref-name main # sync specific ref
164 162
165## Key flags 163## Key flags
166 164
167| Flag | Description | 165| Flag | Description |
168| --- | --- | 166| --------------------- | -------------------------------------- |
169| `-d`, `--defaults` | Non-interactive; use sensible defaults | 167| `-d`, `--defaults` | Non-interactive; use sensible defaults |
170| `--offline` | Local cache only, skip network | 168| `--offline` | Local cache only, skip network |
171| `--json` | Structured output (ngit commands only) | 169| `--json` | Structured output (ngit commands only) |
172| `-n`, `--nsec <NSEC>` | Provide nsec or hex private key inline | 170| `-n`, `--nsec <NSEC>` | Provide nsec or hex private key inline |
173| `-f`, `--force` | Bypass safety guards | 171| `-f`, `--force` | Bypass safety guards |
174| `-v`, `--verbose` | Verbose output | 172| `-v`, `--verbose` | Verbose output |
175 173
176## git config 174## git config
177 175