gentle-shell

Gentle Shell is a Pi-native workspace for AI-assisted development, bringing parallel coding agents, live tasks, Git diffs, persistent memory, and permission controls into one terminal interface. Powered by Gentle AI and Organic Driven Development (ODD).

Stars: 2.2k
Skills: 15
License: MIT
Last commit: Nov 11, 2026

install.sh

# every skill in this repo, via the skills CLI

npx skills add Gentleman-Programming/gentle-shell

# or, for Claude Code, copy one skill folder into

~/.claude/skills/ (all projects)

.claude/skills/ (this project)

View Gentleman-Programming/gentle-shell on GitHub

Inside this pack

15 skills in gentle-shell

Each skill is a SKILL.md file your agent loads when a task matches its description.

01
gentle-ai-branch-pr
Prepare pull requests using the target repository's contribution policy. Trigger: creating, opening, or preparing PRs for review.
Preview SKILL.md
02
gentle-ai-chained-pr
Trigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus.
Preview SKILL.md
03
gentle-ai-cognitive-doc-design
Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.
Preview SKILL.md
04
gentle-ai-comment-writer
Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments.
Preview SKILL.md
05
gentle-design
Trigger: design a screen or page, mockup, landing page, UI directions, artboards, try a different approach, design system sync. Write self-contained HTML design directions under design/<slug>/.
Preview SKILL.md
06
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.
Preview SKILL.md
07
gentle-ui-design
Trigger: product interface design, web UI, design critique, browsing experience, responsive layout. Guide usable interfaces for the current project.
Preview SKILL.md
08
gentle-ai-issue-creation
Create and triage GitHub issues from repository evidence. Trigger: issue creation, bug reports, feature requests, or issue approval.
Preview SKILL.md
09
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.
Preview SKILL.md
10
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.
Preview SKILL.md
11
gentle-ai-skill-creator
Trigger: /skill-creation, skill creation, skill creator, create skill, new skill. Create LLM-first skills with valid frontmatter.
Preview SKILL.md
12
gentle-ai-skill-improver
Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills.
Preview SKILL.md
13
gentle-ai-skill-registry
Trigger: update skills, skill registry, actualizar skills, after skill changes. Index available skills by trigger and path.
Preview SKILL.md
14
gentle-ai-tui-design
Trigger: terminal UI design, TUI redesign, Gentle Shell look, IDE in a terminal, sidebar/status bar polish, critique TUI. Design, critique and refine terminal UIs with visual proof.
Preview SKILL.md
15
gentle-ai-work-unit-commits
Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.
Preview SKILL.md