diff options
| author | DanConwayDev <DanConwayDev@protonmail.com> | 2026-03-05 10:39:19 +0000 |
|---|---|---|
| committer | DanConwayDev <DanConwayDev@protonmail.com> | 2026-03-05 10:39:19 +0000 |
| commit | 4d23e609ec3d6c25b5f5918fd317eef02a434efe (patch) | |
| tree | e8b6f295f6c9e2a335a6a38bc5ff637a02561943 | |
| parent | a7ca31af8a326327fbebb1b6f688850fdc3627c6 (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
| -rw-r--r-- | skills/ngit/SKILL.md | 26 |
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 |
| 57 | ngit init # interactive | 57 | ngit init --name "My Project" --description "What it does" -d # uses user's preferred grasp server or falls back to defaults |
| 58 | ngit init --name "My Project" --description "What it does" -d # non-interactive | ||
| 59 | ngit repo edit --description "New description" # update metadata | 58 | ngit repo edit --description "New description" # update metadata |
| 60 | ngit repo --json --offline # view repo info (check nostr_url field) | 59 | ngit 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 | ||
| 83 | Push options `title=` and `description=` are required. Use `\n\n` for paragraph breaks. | 82 | Push 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 | |||
| 99 | ngit pr view <ID|nevent> --json | 98 | ngit pr view <ID|nevent> --json |
| 100 | ngit pr view <ID|nevent> --json --comments | 99 | ngit pr view <ID|nevent> --json --comments |
| 101 | ngit pr comment <ID|nevent> --body "Looks good" | 100 | ngit pr comment <ID|nevent> --body "Looks good" |
| 102 | ngit pr comment <ID|nevent> --body "Fixed!" --reply-to <comment-ID> | 101 | ngit 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 |
| 108 | ngit pr checkout <ID|nevent> | 107 | ngit pr checkout <ID|nevent> |
| 109 | ngit 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 |
| 132 | ngit issue create --title "Bug title" --body "Details" --label bug | 130 | ngit issue create --title "Bug title" --body "Details as markdown" --label bug |
| 133 | ngit issue create --title "Feature" --body "..." --label enhancement --label help-wanted | 131 | ngit issue create --title "Feature" --body "..." --label enhancement --label help-wanted |
| 134 | ngit issue list --json | 132 | ngit issue list --json |
| 135 | ngit issue list --json --status closed | 133 | ngit issue list --json --status closed |
| @@ -137,7 +135,7 @@ ngit issue list --json --label bug | |||
| 137 | ngit issue view <ID|nevent> --json | 135 | ngit issue view <ID|nevent> --json |
| 138 | ngit issue view <ID|nevent> --json --comments | 136 | ngit issue view <ID|nevent> --json --comments |
| 139 | ngit issue comment <ID|nevent> --body "Reproduced on v2.1" | 137 | ngit issue comment <ID|nevent> --body "Reproduced on v2.1" |
| 140 | ngit issue comment <ID|nevent> --body "Thanks!" --reply-to <comment-ID> | 138 | ngit issue comment <ID|nevent> --body "Thanks!" --reply-to <comment-ID|nevent> |
| 141 | ngit issue close <ID|nevent> | 139 | ngit issue close <ID|nevent> |
| 142 | ngit issue reopen <ID|nevent> | 140 | ngit 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 | ||