Skip to content

docs: bring the github-tools README rows up to date #32

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jimisola merged 3 commits into from
Oct 13, 2026
Merged

docs: bring the github-tools README rows up to date #32

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
81824a4
docs: describe the safe-settings traps and sync verification in the R…
jimisola Oct 13, 2026
d52357d
docs: list merge-ready in the README
jimisola Oct 13, 2026
27325b6
docs: fix the marketplace name and describe the hooks in the README
jimisola Oct 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 12 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ Personal development standards that auto-apply based on context.
|---|---|
| `git-workflow` | Creating branches, commits, or pull requests |

Also a `SessionStart` hook that pulls every installed marketplace, working around `/reload-plugins` fetching without pulling ([claude-code#26744](https://github.com/anthropics/claude-code/issues/26744)).

### quality

Quality tools. Every skill auto-applies when its description matches, and can also
Expand All @@ -32,12 +34,13 @@ be invoked explicitly with the slash command shown below.

### github-tools

GitHub tools for the parts of GitHub that have no comfortable CLI.
GitHub tools for the parts of GitHub that have no comfortable CLI. A `PreToolUse` hook enforces the `upload` skill's constraints (file type checked against content, every upload logged to `~/.claude/github-tools-uploads.jsonl`).

| Skill | Auto-applies when... |
|---|---|
| `upload` | Attaching images or video to a GitHub PR or issue from the command line |
| `safe-settings` | Setting up, fixing or debugging `github/safe-settings` for an org — App registration via the manifest flow, wiring, and the first sync |
| `safe-settings` | Setting up, fixing or debugging `github/safe-settings` for an org — App registration via the manifest flow, wiring, the first sync, the traps found rolling it out (version pin, dot-repos, ruleset merging, paywalls), and verifying a sync against the live state |
| `merge-ready` | Only when invoked (`/github-tools:merge-ready [all\|bots\|mine\|others]`) — merges open PRs one at a time, each only when checks are green, it is conflict-free and up to date, and its title and body still match the branch; handles stacked and bot PRs |
| `renovate-automerge` | Bringing a repo or org onto gated Renovate auto-merge — required checks first, then `platformAutomerge: true`; audit script, checklist and the traps found rolling it out across five orgs |

### cad-tools
Expand Down Expand Up @@ -73,11 +76,11 @@ Linux only: it reads `/proc/meminfo` and `ps`. A hook that throws is skipped by
### 2. Install plugins

```
/plugin install dev-standards@claude-plugins
/plugin install quality@claude-plugins
/plugin install github-tools@claude-plugins
/plugin install cad-tools@claude-plugins
/plugin install ram-guard@claude-plugins
/plugin install dev-standards@jimisola-plugins
/plugin install quality@jimisola-plugins
/plugin install github-tools@jimisola-plugins
/plugin install cad-tools@jimisola-plugins
/plugin install ram-guard@jimisola-plugins
```

Or use the interactive UI: `/plugin` → **Discover** tab → select plugins and choose scope (user / project / local).
Expand All @@ -87,11 +90,11 @@ Or use the interactive UI: `/plugin` → **Discover** tab → select plugins and
To refresh plugin listings after upstream changes:

```
/plugin marketplace update claude-plugins
/plugin marketplace update jimisola-plugins
```

## Local Testing

```bash
claude --plugin-dir ./plugins/dev-standards --plugin-dir ./plugins/quality-tools --plugin-dir ./plugins/github-tools --plugin-dir ./plugins/cad-tools
claude --plugin-dir ./plugins/dev-standards --plugin-dir ./plugins/quality-tools --plugin-dir ./plugins/github-tools --plugin-dir ./plugins/cad-tools --plugin-dir ./plugins/ram-guard
```