Updated today
by Gentleman-Programming
gentle-shell
Your coding agent for controlled development in the workspace you lead. A Pi-native shell with Organic Driven Development, focused subagents, risk-based native review, live changes and agent views, and permission modes that keep destructive guards.
1.3k GitHub stars (1,338)
+230 in 20 days
| Period | New stars |
|---|---|
| Sep 27 | +4 |
| Sep 28 | +11 |
| Sep 29 | +12 |
| Sep 30 | +12 |
| Oct 1 | +3 |
| Oct 2 | +14 |
| Oct 3 | +17 |
| Oct 4 | +10 |
| Oct 5 | +4 |
| Oct 6 | +10 |
| Oct 7 | +9 |
| Oct 8 | +7 |
| Oct 9 | +20 |
| Oct 10 | +18 |
| Oct 11 | +15 |
| Oct 12 | +7 |
| Oct 13 | +13 |
| Oct 14 | +22 |
| Oct 15 | +11 |
| Oct 16 | +11 |
- 12 skills (12 skills found in its SKILL.md files)
- 204 forks (204 forks)
- Today last update (Last updated today)
Install
Skills CLI
npx skills add Gentleman-Programming/gentle-shell
Asks which skills and agents to install. Just one: npx skills add Gentleman-Programming/gentle-shell --skill gentle-ai-branch-pr — add -g for every project.
Claude Code
git clone https://github.com/Gentleman-Programming/gentle-shellcp -r "gentle-shell/skills/branch-pr" ~/.claude/skills/
Copies the gentle-ai-branch-pr skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add Gentleman-Programming/gentle-shell
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
gentle-ai-branch-pr
Create Gentle AI pull requests with issue-first checks. Trigger: creating, opening, or preparing PRs for review.
skills/branch-pr/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-chained-pr
Trigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus.
skills/chained-pr/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-cognitive-doc-design
Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.
skills/cognitive-doc-design/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-comment-writer
Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments.
skills/comment-writer/SKILL.md on GitHub (opens in a new tab) -
gentle-ai
Use Gentle AI harness discipline for Pi work: clarify first, track ODD work, use applicable test-first development by default, delegate when useful, and protect review workload.
skills/gentle-ai/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-issue-creation
Create and triage GitHub issues from repository evidence. Trigger: issue creation, bug reports, feature requests, or issue approval.
skills/issue-creation/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-judgment-day
Trigger: judgment day, judgement day, dual review, adversarial review, juzgar. Run explicit blind dual review with at most two scoped fix/re-judgment rounds.
skills/judgment-day/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-rdd-defect-workflow
Trigger: RDD, receipt-driven development, review authority, receipt/lineage, correction/recovery, delivery gate/kill switch, bounded review defects. Guide work.
skills/rdd-defect-workflow/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-skill-creator
Trigger: /skill-creation, skill creation, skill creator, create skill, new skill. Create LLM-first skills with valid frontmatter.
skills/skill-creator/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-skill-improver
Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills.
skills/skill-improver/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-skill-registry
Trigger: update skills, skill registry, actualizar skills, after skill changes. Index available skills by trigger and path.
skills/skill-registry/SKILL.md on GitHub (opens in a new tab) -
gentle-ai-work-unit-commits
Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.
skills/work-unit-commits/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.