gentle-design
gentle-design is a skill in Gentleman-Programming/gentle-shell, last changed 26 Oct 2026. It is instructions only: no scripts, no named hosts and no pre-approved tools. Our pattern check flagged nothing at commit 9e7aa01 on 27 Oct 2026.
Pattern check: nothing flagged · commit 9e7aa01 · 27 Oct 2026
InstallTrigger: 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>/.
- Licence
- Apache 2.0
- Repo stars
- 1.5k
- Folder last changed
- 26 Oct 2026 (opens in a new tab)
- Publisher
- Gentleman-Programming
- Files
- 1 file
- Checked
- 9e7aa01 (opens in a new tab) · 27 Oct 2026
Install
Each tab says whether it installs commit 9e7aa01, the one we checked, or the latest version.
No tab for your agent? Use Any agent for OpenCode, Goose, Windsurf (Devin Desktop), Zed, Roo Code, Factory Droid, Junie, Amp and Antigravity, and Claude Code for Cline. Kiro needs the folder copied by hand.
Pinned to commit 9e7aa01, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/Gentleman-Programming/gentle-shell.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
git -C "$tmp" sparse-checkout set -- skills/design &&
git -C "$tmp" checkout -q 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
mkdir -p .claude/skills &&
mkdir .claude/skills/gentle-design &&
cp -R "$tmp"/skills/design/. .claude/skills/gentle-design/ &&
rm -rf "$tmp"If Claude Code was already running and this created the skills folder, run /reload-skills.
Pinned to commit 9e7aa01, the one we checked.
Skills in the Claude apps belong to your account rather than to a project.
Make gentle-design.zip, with the skill folder at the top level:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/Gentleman-Programming/gentle-shell.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
git -C "$tmp" sparse-checkout set -- skills/design &&
git -C "$tmp" checkout -q 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
out="$(mktemp -d)" &&
cp -R "$tmp"/skills/design "$out"/gentle-design &&
(cd "$out" && zip -qr - gentle-design) > gentle-design.zip &&
rm -rf "$tmp" "$out"In Claude, open Customize > Skills, select +, then + Create skill > Upload a skill, and choose gentle-design.zip.
On Free, Pro and Max plans, turn on Code execution and file creation (Create and edit files in newer settings) under Settings > Capabilities.
Pinned to commit 9e7aa01, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/Gentleman-Programming/gentle-shell.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
git -C "$tmp" sparse-checkout set -- skills/design &&
git -C "$tmp" checkout -q 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
mkdir -p .agents/skills &&
mkdir .agents/skills/gentle-design &&
cp -R "$tmp"/skills/design/. .agents/skills/gentle-design/ &&
rm -rf "$tmp"Codex picks up new skills on its own; restart it if this one does not appear.
Pinned to commit 9e7aa01, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/Gentleman-Programming/gentle-shell.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
git -C "$tmp" sparse-checkout set -- skills/design &&
git -C "$tmp" checkout -q 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
mkdir -p .cursor/skills &&
mkdir .cursor/skills/gentle-design &&
cp -R "$tmp"/skills/design/. .cursor/skills/gentle-design/ &&
rm -rf "$tmp"Pinned to commit 9e7aa01, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/Gentleman-Programming/gentle-shell.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
git -C "$tmp" sparse-checkout set -- skills/design &&
git -C "$tmp" checkout -q 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
mkdir -p .github/skills &&
mkdir .github/skills/gentle-design &&
cp -R "$tmp"/skills/design/. .github/skills/gentle-design/ &&
rm -rf "$tmp"In a running Copilot CLI session, run /skills reload.
Or install it with gh skill, which also installs the commit we checked. Needs GitHub CLI 2.90 or later.
gh skill install Gentleman-Programming/gentle-shell skills/design/SKILL.md@9e7aa013366aa82cbe126ac3f455ea758dd92925 --agent github-copilot --scope projectPinned to commit 9e7aa01, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/Gentleman-Programming/gentle-shell.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
git -C "$tmp" sparse-checkout set -- skills/design &&
git -C "$tmp" checkout -q 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
mkdir -p .gemini/skills &&
mkdir .gemini/skills/gentle-design &&
cp -R "$tmp"/skills/design/. .gemini/skills/gentle-design/ &&
rm -rf "$tmp"In a running session, run /skills reload.
Or use Gemini CLI’s own installer. Installs the latest version, not the one we checked.
gemini skills install https://github.com/Gentleman-Programming/gentle-shell.git --path skills/design --scope workspacePinned to commit 9e7aa01, the one we checked.
Codex, Cursor, Copilot, VS Code, Gemini CLI, OpenCode, Goose, Amp and Zed all read .agents/skills; Claude Code and Kiro list only their own folders.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/Gentleman-Programming/gentle-shell.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
git -C "$tmp" sparse-checkout set -- skills/design &&
git -C "$tmp" checkout -q 9e7aa013366aa82cbe126ac3f455ea758dd92925 &&
mkdir -p .agents/skills &&
mkdir .agents/skills/gentle-design &&
cp -R "$tmp"/skills/design/. .agents/skills/gentle-design/ &&
rm -rf "$tmp"Or use the skills CLI from skills.sh. Installs the latest version, not the one we checked. The skills CLI reports installs to skills.sh unless you set DISABLE_TELEMETRY=1.
npx skills@1.7.4 add Gentleman-Programming/gentle-shell --skill gentle-designWhat it can touch
From the files and frontmatter at commit 9e7aa01. This is how much a skill can do, not whether it is risky.
What it can touch: Instructions only
It is instructions only: no scripts, no named hosts and no pre-approved tools.
Pattern check
Pattern check: nothing flagged · commit 9e7aa01 · 27 Oct 2026
We checked every text file in this skill, at commit 9e7aa01 on 27 Oct 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specFails
The open format from agentskills.io, held to what the strictest agents enforce, so one folder loads everywhere.
- Error
The name "gentle-design" doesn't match its folder "design". The spec requires them to match. N4
Fix: Set name: design, or rename the folder to gentle-design.
- Warning
The description contains < or >. Uploads to the Claude apps and API reject it. D3
Fix: Remove < and >, or reword (for example "less than").
- Note
The description doesn't say when to use the skill. D6
Fix: Add a sentence such as "Use when …" naming the requests or files that should trigger it.
- Error
Claude CodePasses
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Note
The name "gentle-design" doesn't match its folder "design". Claude Code shows the skill as /gentle-design, and the folder name also invokes it. N4
Fix: Set name: design, or rename the folder to gentle-design.
- Note
Claude apps & API uploadFails
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Error
The name "gentle-design" doesn't match its folder "design". claude.ai refuses an upload whose folder name doesn't match the skill name. N4
Fix: Set name: design, or rename the folder to gentle-design.
- Error
The description contains < or >. Anthropic's validator rejects any angle bracket there. D3
Fix: Remove < and >, or reword (for example "less than").
- Error
OpenAI (Codex & API)Passes with warnings
Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.
- Warning
The name "gentle-design" doesn't match its folder "design". OpenAI's own upload example uses a differently named folder, but the spec it follows says they must match. N4
Fix: Set name: design, or rename the folder to gentle-design.
- Warning
VS Code & CopilotPasses with warnings
VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.
- Warning
The name "gentle-design" doesn't match its folder "design". VS Code uses the folder name, design, instead. N4
Fix: Set name: design, or rename the folder to gentle-design.
- Warning
VS Code deletes text between < and > in a description, so "<slug>" would vanish. D3
Fix: Remove the angle brackets or reword.
- Warning
SKILL.md
Files
1 file
| Path | Size |
|---|---|
| SKILL.md (opens in a new tab) | 8.8 KB |
More from Gentleman-Programming/gentle-shell
gentle-ai
Gentleman-Programming/gentle-shell
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.
- Instructions only
Pattern check: Nothing flaggedMIT · 1.5k repo stars · Updated 15 Oct 2026
gentle-ai-branch-pr
Gentleman-Programming/gentle-shell
Create Gentle AI pull requests with issue-first checks. Trigger: creating, opening, or preparing PRs for review.
- Instructions only
Pattern check: Nothing flaggedApache 2.0 · 1.5k repo stars · Updated 30 Sept 2026
gentle-ai-chained-pr
Gentleman-Programming/gentle-shell
Trigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus.
- Runs shell commands
Pattern check: Nothing flaggedApache 2.0 · 1.5k repo stars · Updated 30 Sept 2026
gentle-ai-cognitive-doc-design
Gentleman-Programming/gentle-shell
Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.
- Runs shell commands
Pattern check: Nothing flaggedApache 2.0 · 1.5k repo stars · Updated 25 Aug 2026
gentle-ai-comment-writer
Gentleman-Programming/gentle-shell
Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments.
- Runs shell commands
Pattern check: Nothing flaggedApache 2.0 · 1.5k repo stars · Updated 25 Aug 2026
gentle-ai-issue-creation
Gentleman-Programming/gentle-shell
Create and triage GitHub issues from repository evidence. Trigger: issue creation, bug reports, feature requests, or issue approval.
- Runs shell commands
- Reaches the network
Pattern check: Nothing flaggedApache 2.0 · 1.5k repo stars · Updated 25 Sept 2026
