Skip to content
Back to search

gentleman-skills

Community-driven AI agent skills for Claude Code, OpenCode, and other AI assistants. Curated patterns and community contributions.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gentleman-programming--gentleman-skills/badge.svg)](/listings/gentleman-programming--gentleman-skills)

HTML

<a href="/listings/gentleman-programming--gentleman-skills"><img src="/api/listings/gentleman-programming--gentleman-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Quick Start

# Clone the repository
git clone https://github.com/Gentleman-Programming/Gentleman-Skills.git

# Copy curated skills to your agent's skills directory
# Replace <SKILLS_DIR> with the path from the table above

# Example: Claude Code (macOS/Linux)
cp -r Gentleman-Skills/curated/* ~/.claude/skills/

# Example: OpenCode (macOS/Linux)
cp -r Gentleman-Skills/curated/* ~/.config/opencode/skills/

# Example: Gemini CLI (macOS/Linux)
cp -r Gentleman-Skills/curated/* ~/.gemini/skills/

# Example: Cursor (macOS/Linux)
cp -r Gentleman-Skills/curated/* ~/.cursor/skills/

# Or copy specific skills only
cp -r Gentleman-Skills/curated/react-19 ~/.claude/skills/
cp -r Gentleman-Skills/curated/typescript ~/.claude/skills/

Manual Installation

1. Create the skills directory for your agent if it doesn't exist:

   # Example for Claude Code
   mkdir -p ~/.claude/skills

   # Example for Gemini CLI
   mkdir -p ~/.gemini/skills

2. Copy the skill folder(s) you want:

   cp -r curated/react-19 ~/.claude/skills/

3. Reference the skill in your agent's configuration file (e.g., `CLAUDE.md` for Claude Code):

   ## Skills
   When working with React, read `~/.claude/skills/react-19/SKILL.md` first.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 202 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Gentleman-Skills
  2. > Community-driven AI agent skills for Claude Code, OpenCode, Gemini CLI, Cursor, VS Code Copilot, Codex, Windsurf, Antigravity, and other AI assistants.
  3. Skills are specialized instruction sets that teach AI assistants how to work with specific frameworks, libraries, and patterns. They provide on-demand context so the AI writes code following best practices and conventions.
  4. ## Philosophy
  5. - **Curated Skills** - Personally crafted and battle-tested by [@Gentleman-Programming](https://github.com/Gentleman-Programming). These reflect MY way of thinking about code architecture - Scope Rule, file naming conventions, signals-first approach, and more. Some skills (like testing and Python) have been developed in collaboration with the team at [Prowler](https://github.com/prowler-cloud).
  6. - **Community Skills** - Created by the community, for the community. These go through a democratic voting process before being accepted.
  7. ## Curated Skills
  8. These skills represent patterns and practices I've personally tested and refined over years of development.
  9. ### Contributing to this Repo?
  10. > **Start here!** Use the [github-pr](curated/github-pr) skill to create proper PRs with conventional commits.
  11. | Skill | Description | Trigger |
  12. |-------|-------------|---------|
  13. | [github-pr](curated/github-pr) | Create quality PRs with conventional commits | When creating PRs or contributing |
  14. | [skill-creator](curated/skill-creator) | Create new skills | When creating new AI agent skills |
  15. ### Frontend
  16. | Skill | Description | Trigger |
  17. |-------|-------------|---------|
  18. | [angular/core](curated/angular/core) | Standalone components, signals, inject, zoneless | When creating Angular components |
  19. | [angular/forms](curated/angular/forms) | Signal Forms, Reactive Forms | When working with Angular forms |
  20. | [angular/performance](curated/angular/performance) | NgOptimizedImage, @defer, lazy loading, SSR | When optimizing Angular apps |
  21. | [angular/architecture](curated/angular/architecture) | Scope Rule, project structure, file naming | When structuring Angular projects |
  22. | [react-19](curated/react-19) | React 19 patterns with React Compiler | When writing React components |
  23. | [nextjs-15](curated/nextjs-15) | Next.js 15 App Router patterns | When working with Next.js |
  24. | [typescript](curated/typescript) | TypeScript strict patterns | When writing TypeScript code |
  25. | [tailwind-4](curated/tailwind-4) | Tailwind CSS 4 patterns | When styling with Tailwind |
  26. | [zod-4](curated/zod-4) | Zod 4 schema validation | When using Zod for validation |
  27. | [zustand-5](curated/zustand-5) | Zustand 5 state management | When managing React state |
  28. ### Backend & AI
  29. | Skill | Description | Trigger |
  30. |-------|-------------|---------|
  31. | [ai-sdk-5](curated/ai-sdk-5) | Vercel AI SDK 5 patterns | When building AI chat features |
  32. | [django-drf](curated/django-drf) | Django REST Framework patterns | When building REST APIs with Django |
  33. ### Testing
  34. | Skill | Description | Trigger |
  35. |-------|-------------|---------|
  36. | [playwright](curated/playwright) | Playwright E2E testing | When writing E2E tests |
  37. | [pytest](curated/pytest) | Python pytest patterns | When writing Python tests |
  38. ### Workflow
  39. | Skill | Description | Trigger |
  40. |-------|-------------|---------|
  41. | [jira-task](curated/jira-task) | Jira task creation | When creating Jira tasks |
  42. | [jira-epic](curated/jira-epic) | Jira epic creation | When creating Jira epics |
  43. ## Community Skills
  44. Skills contributed by the community and approved through our voting process.
  45. | Skill | Description | Author |
  46. |-------|-------------|--------|
  47. | [electron](community/electron) | Electron patterns for building cross-platform desktop applications. | @gentleman-programming |
  48. | [elixir-antipatterns](community/elixir-antipatterns) | Core catalog of 8 critical Elixir/Phoenix anti-patterns covering error handli... | @tsardinasGitHub |
  49. | [hexagonal-architecture-layers-java](community/hexagonal-architecture-layers-java) | Hexagonal architecture layering for Java services with strict boundaries. | @diegnghrmr |
  50. | [java-21](community/java-21) | Java 21 language and runtime patterns for modern, safe code. | @diegnghrmr |
  51. | [react-native](community/react-native) | React Native patterns for mobile app development with Expo and bare workflow. | @gentleman-programming |
  52. | [spring-boot-3](community/spring-boot-3) | Spring Boot 3 patterns for configuration, DI, and web services. | @diegnghrmr |
  53. ## Supported Agents & Skills Directory
  54. Each agent reads skills from a specific directory. Copy the skills you want into the right path for your agent:
  55. | Agent | macOS / Linux | Windows |
  56. |-------|---------------|---------|
  57. | **Claude Code** | `~/.claude/skills/` | `%USERPROFILE%\.claude\skills\` |
  58. | **OpenCode** | `~/.config/opencode/skills/` | `%USERPROFILE%\.config\opencode\skills\` |
  59. | **Gemini CLI** | `~/.gemini/skills/` | `%USERPROFILE%\.gemini\skills\` |
  60. | **Cursor** | `~/.cursor/skills/` | `%USERPROFILE%\.cursor\skills\` |
  61. | **VS Code Copilot** | `~/.copilot/skills/` | `%USERPROFILE%\.copilot\skills\` |
  62. | **Codex** | `~/.codex/skills/` | `%USERPROFILE%\.codex\skills\` |
  63. | **Windsurf** | `~/.codeium/windsurf/skills/` | `%USERPROFILE%\.codeium\windsurf\skills\` |
  64. | **Antigravity** | `~/.gemini/antigravity/skills/` | `%USERPROFILE%\.gemini\antigravity\skills\` |
  65. Inside each `skills/` directory, every skill lives in its own folder with a `SKILL.md`:
  66. ```
  67. skills/
  68. react-19/SKILL.md
  69. typescript/SKILL.md
  70. angular/core/SKILL.md
  71. playwright/SKILL.md
  72. ...
  73. ```
  74. ## Installation
  75. ### Quick Start
  76. ```bash
  77. # Clone the repository
  78. git clone https://github.com/Gentleman-Programming/Gentleman-Skills.git
  79. # Copy curated skills to your agent's skills directory
  80. # Replace <SKILLS_DIR> with the path from the table above
  81. # Example: Claude Code (macOS/Linux)
  82. cp -r Gentleman-Skills/curated/* ~/.claude/skills/
  83. # Example: OpenCode (macOS/Linux)
  84. cp -r Gentleman-Skills/curated/* ~/.config/opencode/skills/
  85. # Example: Gemini CLI (macOS/Linux)
  86. cp -r Gentleman-Skills/curated/* ~/.gemini/skills/
  87. # Example: Cursor (macOS/Linux)
  88. cp -r Gentleman-Skills/curated/* ~/.cursor/skills/
  89. # Or copy specific skills only
  90. cp -r Gentleman-Skills/curated/react-19 ~/.claude/skills/
  91. cp -r Gentleman-Skills/curated/typescript ~/.claude/skills/
  92. ```
  93. ### Manual Installation
  94. 1. Create the skills directory for your agent if it doesn't exist:
  95. ```bash
  96. # Example for Claude Code
  97. mkdir -p ~/.claude/skills
  98. # Example for Gemini CLI
  99. mkdir -p ~/.gemini/skills
  100. ```
  101. 2. Copy the skill folder(s) you want:
  102. ```bash
  103. cp -r curated/react-19 ~/.claude/skills/
  104. ```
  105. 3. Reference the skill in your agent's configuration file (e.g., `CLAUDE.md` for Claude Code):
  106. ```markdown
  107. ## Skills
  108. When working with React, read `~/.claude/skills/react-19/SKILL.md` first.
  109. ```
  110. ## How Skills Work
  111. Each skill contains a `SKILL.md` file with:
  112. 1. **Trigger conditions** - When the AI should load this skill
  113. 2. **Patterns and rules** - Specific coding conventions to follow
  114. 3. **Code examples** - Reference implementations
  115. 4. **Anti-patterns** - What to avoid
  116. When the AI detects a matching context (e.g., editing a React component), it reads the skill file and applies those patterns to its responses.
  117. ## Contributing
  118. We welcome community contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for the full process.
  119. > **Pro tip**: Load the [github-pr](curated/github-pr) skill to create PRs that follow our conventions!
  120. ### Quick Overview
  121. 1. **Fork** this repository
  122. 2. **Create** your skill following the [skill template](SKILL_TEMPLATE.md)
  123. 3. **Submit** a Pull Request to the `community/` folder using [conventional commits](https://www.conventionalcommits.org/)
  124. 4. **Community votes** for 7 days using reactions
  125. 5. **Accepted** if more positive than negative votes
  126. ### Voting System
  127. - Vote with reactions on the PR
  128. - Voting period: **7 days**
  129. - Acceptance criteria: `positive votes > negative votes`
  130. - Maintainers can fast-track exceptional contributions
  131. ## Skill Structure
  132. ```
  133. skill-name/
  134. ├── SKILL.md # Main skill file (required)
  135. ├── examples/ # Code examples (optional)
  136. └── README.md # Skill documentation (optional)
  137. ```
  138. ## Other Resources
  139. Looking for official Vercel skills? Check out [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills).
  140. ## License
  141. MIT License - See [LICENSE](LICENSE) for details.
  142. ---
  143. Made with care by [Gentleman Programming](https://github.com/Gentleman-Programming) and the community.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.