Skip to content
Back to search

dr-jskill

"Creates Java + Spring Boot projects: Web applications, full-stack apps with Vue.js or Angular or React or vanilla JS, PostgreSQL, REST APIs, and Docker. Use when creating Spring Boot projects, setting up Java microservices, or building enterprise applications with the Spring Framework."

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/jdubois--dr-jskill/badge.svg)](/listings/jdubois--dr-jskill)

HTML

<a href="/listings/jdubois--dr-jskill"><img src="/api/listings/jdubois--dr-jskill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

SKILL.md · Manifest · 305 lines

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

  1. ---
  2. name: dr-jskill
  3. description: "Creates Java + Spring Boot projects: Web applications, full-stack apps with Vue.js or Angular or React or vanilla JS, PostgreSQL, REST APIs, and Docker. Use when creating Spring Boot projects, setting up Java microservices, or building enterprise applications with the Spring Framework."
  4. metadata:
  5. recommended_model: gpt-5.5
  6. ---
  7. # Spring Boot skill that follows Julien Dubois' best practices.
  8. ## Overview
  9. This agent skill helps you create Spring Boot projects following [Julien Dubois](https://www.julien-dubois.com)' best practices. It provides tools and scripts to quickly bootstrap Spring Boot applications using [https://start.spring.io](https://start.spring.io).
  10. **Recommended model:** Dr JSkill works best with **GPT-5.5**.
  11. ## Version Management
  12. Centralized versions live in `versions.json`. All scripts read from it via `scripts/lib/versions.mjs` (JavaScript). Update this file to bump Java, Spring Boot fallback, Postgres, Node/npm, Testcontainers, etc.
  13. ## Prerequisites
  14. 1. Java 25 installed
  15. 2. Node.js 24.x and NPM 11.x (for front-end development)
  16. 3. Docker installed and running
  17. ## Capabilities
  18. - Generate Spring Boot projects with predefined configurations
  19. - Support for various Spring Boot versions and dependencies
  20. - Follow best practices for project structure and configuration
  21. - Quick setup scripts for common use cases
  22. - Docker support for containerized deployments
  23. - Front-end development with multiple framework options:
  24. - **Vue.js 3** (default) - Progressive framework with Composition API
  25. - **React 19** - Popular library for building user interfaces
  26. - **Angular 22** - Full-featured framework with TypeScript
  27. - **Vanilla JavaScript** - No framework, pure ES6+ with Vite
  28. ## Usage
  29. ### Using the Scripts
  30. This skill includes cross-platform JavaScript (Node.js) scripts in the `scripts/` directory that can be used to download pre-configured Spring Boot projects from start.spring.io. They work on Linux, macOS, and Windows.
  31. **Unified launcher (cross-platform):**
  32. ```bash
  33. node scripts/create-project my-app com.myco my-app com.myco.myapp 25 fullstack --output-dir /absolute/path/to/user/workspace
  34. ```
  35. **Direct invocation:**
  36. ```bash
  37. node scripts/create-project-latest.mjs my-app com.myco my-app com.myco.myapp 25 fullstack --output-dir /absolute/path/to/user/workspace
  38. ```
  39. Flags supported:
  40. - `--boot-version <x.y.z>` / `-BootVersion`: override Spring Boot version
  41. - `--project-type basic|web|fullstack` / `-ProjectType`
  42. - `--output-dir <absolute-path>`: create the generated project folder under this directory
  43. **Output directory rule (important for Agent Skills):** bundled scripts are run from the skill directory root. When the user asks to create an app, pass `--output-dir` with the user's current working directory from the agent session so the generated project folder is created in the user's workspace, not inside the `dr-jskill` skill folder. Only omit `--output-dir` when running Dr JSkill's own tests, where generating inside the skill checkout is intentional.
  44. > Tip: The `create-project-latest` script auto-resolves preferred Boot 4.x and falls back to the configured `springBootFallback` if 4.x is not yet available. Override with `--boot-version` if needed.
  45. ### Latest Version Project ⭐
  46. Use the `create-project-latest.mjs` script to create a project with the **latest Spring Boot version** (automatically fetched):
  47. ```bash
  48. node scripts/create-project-latest.mjs my-app com.mycompany my-app com.mycompany.myapp 25 web
  49. ```
  50. Project types available:
  51. - `basic` - Minimal Spring Boot project
  52. - `web` - Web application with REST API capabilities
  53. - `fullstack` - Complete application with database; security is optional
  54. ### Basic Spring Boot Project
  55. Use the `create-basic-project.mjs` script to create a basic Spring Boot project with essential dependencies:
  56. ```bash
  57. node scripts/create-basic-project.mjs
  58. ```
  59. ### Web Application
  60. Use the `create-web-project.mjs` script to create a Spring Boot web application with web dependencies:
  61. ```bash
  62. node scripts/create-web-project.mjs
  63. ```
  64. ### Full-Stack Application
  65. Use the `create-fullstack-project.mjs` script to create a comprehensive Spring Boot application with database, security, and web dependencies:
  66. ```bash
  67. node scripts/create-fullstack-project.mjs
  68. ```
  69. ## Best Practices
  70. When creating Spring Boot projects:
  71. 1. Use the latest Spring Boot version (currently 4.x) - the `create-project-latest.mjs` script automatically fetches it
  72. 2. **Review Spring Boot 4 critical considerations**: See [Spring Boot 4 Migration Guide](references/SPRING-BOOT-4.md) for Jackson 3 annotations and TestContainers configuration
  73. 3. Include Spring Boot Actuator for production-ready features
  74. 4. Use Spring Data JPA for database access
  75. 5. Use PostgreSQL for database - see [Database Best Practices](references/DATABASE.md) for optimization
  76. 6. Use properties files for configuration - see [Configuration Best Practices](references/CONFIGURATION.md)
  77. 7. Set up foundational dotfiles: `.gitignore`, `.env.sample`, `.editorconfig`, `.gitattributes`, `.dockerignore`, optional `.vscode/`, `.devcontainer/` - see [Project Setup & Dotfiles](references/PROJECT-SETUP.md)
  78. - The `.env` file is the canonical location for local secrets; instruct users to copy `.env.sample` → `.env` and fill in real values
  79. - **NEVER read or expose `.env`**: it contains real secrets — do not `cat`, view, or print its contents; only `.env.sample` (placeholder values) may be read or displayed
  80. 8. Follow daily Git best practices for small branches, reviewed diffs, safe commits, pull requests, and worktrees - see [Git Best Practices](references/GIT.md)
  81. 9. Use `spring-boot-docker-compose` for automatic database startup during development - see [Docker Guide](references/DOCKER.md)
  82. 10. Follow RESTful API design principles
  83. 11. Configure proper logging with Logback - see [Logging Best Practices](references/LOGGING.md)
  84. 12. Use Maven for dependency management
  85. 13. Include Spring Boot DevTools for development productivity
  86. 14. Add Spring Security only when needed - see [Security Guide](references/SECURITY.md) for best practices
  87. 15. Configure Docker for containerized deployments - see [Docker Guide](references/DOCKER.md)
  88. 16. Enable GraalVM native image support for faster startup - see [GraalVM Guide](references/GRAALVM.md)
  89. 17. **Always ship a startup banner** that prints access URLs when the app is ready - see [Startup Banner](references/SPRING-BOOT-4.md#startup-banner-required)
  90. 18. The user must review changes before they are committed to git. Ask the user before initializing a Git repository, or running git commands.
  91. ## Java Code Intelligence (JDTLS) ⭐
  92. Generated projects integrate with the **Eclipse JDT Language Server (JDTLS)** so AI agents can navigate, refactor, and diagnose Java code *semantically* rather than with text search. The scripts ship a `.github/lsp.json` that wires JDTLS into GitHub Copilot CLI automatically.
  93. **For the AI agent**: when working on Java files, prefer the `lsp` tool over `grep`/`view`/`sed`. It understands imports, generics, inheritance, and Javadoc.
  94. | Task | Use |
  95. |------|-----|
  96. | Find where a class/method is defined | `lsp goToDefinition` |
  97. | Find callers before changing a signature | `lsp findReferences` or `incomingCalls` |
  98. | Look up types, parameters, Javadoc | `lsp hover` |
  99. | List symbols in a file | `lsp documentSymbol` |
  100. | Search a class/method across the project | `lsp workspaceSymbol` |
  101. | Rename safely across files | `lsp rename` (never sed) |
  102. | Check compile errors before `./mvnw verify` | `ide-get_diagnostics` |
  103. **Preference order for Java work: `lsp` → `grep` with `.java` glob → `view`.**
  104. Install JDTLS once: `brew install jdtls` (or see [JDTLS guide](references/JDTLS.md) for other platforms). Full setup, gotchas, and editor integrations live in [references/JDTLS.md](references/JDTLS.md).
  105. ## Project Structure
  106. The service layer is only included if it adds value (e.g. complex business logic). For simple CRUD applications, the controller can directly call the repository.
  107. Generated projects follow the following recommended structure:
  108. ```plaintext
  109. my-spring-boot-app/
  110. ├── .gitignore # Java + front-end + secrets (see references/PROJECT-SETUP.md)
  111. ├── .env.sample # Template for local env vars; .env is gitignored
  112. ├── .editorconfig # Consistent formatting across IDEs
  113. ├── .gitattributes # Normalize line endings, better diffs
  114. ├── .dockerignore # Slim Docker build contexts
  115. ├── .vscode/ # Optional editor recommendations
  116. │ ├── extensions.json
  117. │ └── settings.json
  118. ├── .devcontainer/ # Optional Dev Container (Java 25 + Node 24 + PostgreSQL)
  119. │ ├── devcontainer.json
  120. │ └── docker-compose.yml
  121. ├── src/
  122. │ ├── main/
  123. │ │ ├── java/
  124. │ │ │ └── com/example/app/
  125. │ │ │ ├── Application.java
  126. │ │ │ ├── config/
  127. │ │ │ ├── controller/
  128. │ │ │ ├── service/ # Only included if needed
  129. │ │ │ ├── repository/
  130. │ │ │ └── domain/
  131. │ │ └── resources/
  132. │ │ ├── static/ # Front-end web assets (HTML, CSS, JS)
  133. │ │ │ ├── index.html
  134. │ │ │ ├── css/
  135. │ │ │ │ └── styles.css
  136. │ │ │ ├── js/
  137. │ │ │ │ └── app.js
  138. │ │ │ └── images/
  139. │ │ └── application.properties
  140. │ └── test/
  141. │ └── java/
  142. │ └── com/example/app/
  143. │ ├── config/
  144. │ ├── controller/
  145. │ ├── service/ # Only included if needed
  146. │ ├── repository/
  147. │ └── domain/
  148. ├── Dockerfile # JVM image (jlink runtime + distroless)
  149. ├── Dockerfile-aot # JVM + Spring AOT image
  150. ├── Dockerfile-native # GraalVM native image
  151. ├── Dockerfile-crac # CRaC (fast-restore) image
  152. ├── checkpoint-and-run.sh # CRaC entrypoint helper
  153. ├── compose.yaml # Dev database (spring-boot-docker-compose)
  154. ├── docker-compose.yml # Full stack with PostgreSQL (JVM)
  155. ├── docker-compose-aot.yml # Full stack with PostgreSQL (AOT)
  156. ├── docker-compose-native.yml # Full stack with PostgreSQL (native)
  157. ├── docker-compose-crac.yml # CRaC app (database-free)
  158. ├── pom.xml
  159. └── README.md
  160. ```
  161. ## Dependencies
  162. Generated projects include: Spring Web, Spring Data JPA, Spring Boot Actuator, DevTools, PostgreSQL, Validation, Docker Compose support, Test Starter with JUnit Jupiter (JUnit 6), and Testcontainers.
  163. ## Configuration
  164. Use `.properties` files (not YAML), externalize secrets via environment variables, and leverage `@ConfigurationProperties` for type safety. See the [Configuration Guide](references/CONFIGURATION.md) for profiles, secrets management, and common patterns.
  165. The `.env` file is the single local secret store — never read or print it; only `.env.sample` (placeholder values) may be shown.
  166. **For database optimization**, see the [Database Best Practices Guide](references/DATABASE.md).
  167. ## Security (Optional)
  168. Spring Security is **optional** - only add it when you need authentication or authorization. See the [Security Guide](references/SECURITY.md) for JWT, OAuth2, role-based access, and CORS configuration.
  169. ## Testing
  170. See the [Testing Guide](references/TEST.md) for unit tests (Mockito, `@WebMvcTest`), integration tests (TestContainers + `@ServiceConnection`), and Given-When-Then patterns with AssertJ.
  171. ## Front-End Development
  172. Choose a front-end framework:
  173. - **Vue.js 3** (default) ⭐ → [Vue.js Guide](references/VUE.md)
  174. - **React 19** → [React Guide](references/REACT.md)
  175. - **Angular 22** → [Angular Guide](references/ANGULAR.md)
  176. - **Vanilla JavaScript** (no framework) → [Vanilla JS Guide](references/VANILLA-JS.md)
  177. All options include: Vite/CLI dev server with hot reload, Bootstrap 5.3+, SPA routing, and automatic build into the Spring Boot JAR.
  178. When wiring the `frontend-maven-plugin`, bind the Node install, `npm install`, and `npm run build` executions to the `generate-resources` phase. This makes `./mvnw spring-boot:run` build the frontend before Spring Boot starts, instead of only building it during explicit package-oriented commands.
  179. > **Non-interactive scaffolding (important for CI and AI agents).** Two separate prompts must be silenced:
  180. > 1. **npm's own "Ok to proceed?" install prompt** — silence by placing `-y` **before** the package name (flags after `--` go to the scaffolder, not to npm). Use `npm create -y vite@latest …` or `npx --yes create-vite@latest …`.
  181. > 2. **The scaffolder's own prompts** — create-vite 9.x and Angular CLI 22 still pose interactive questions (e.g. "Use rolldown-vite?", analytics opt-in) that `-y` / `--yes` do **not** silence. The reliable fix is to close stdin: pipe `echo |` into the command so the scaffolder immediately sees EOF and accepts defaults.
  182. >
  183. > Canonical recipes:
  184. > - React / Vanilla: `echo | npx --yes create-vite@latest frontend --template react` (or `--template vanilla`)
  185. > - Vue: `npm create -y vue@latest frontend -- --router --pinia --vitest --eslint --prettier` (create-vue does not pose extra prompts)
  186. > - Angular: `echo | npx --yes @angular/cli@22 new frontend --style=css --ssr=false --skip-git --defaults --skip-install`, then `npm install`
  187. >
  188. > **Vue: normalize before the first `npm install` (required).** `create-vue` scaffolds `oxlint` and `eslint-plugin-oxlint` pinned to mismatched minors, so `npm install` fails with an `ERESOLVE` peer conflict — which fails the `frontend-maven-plugin` step and therefore the whole Maven build. Immediately after scaffolding, run:
  189. >
  190. > ```bash
  191. > # Run from the Dr JSkill skill directory (that is where `scripts/` lives),
  192. > # passing the path to the generated project's frontend/ directory.
  193. > node scripts/normalize-vue-frontend.mjs /absolute/path/to/my-app/frontend
  194. > ```
  195. >
  196. > It drops the oxlint dual-linter, leaving the single ESLint pipeline, adds the `lint:check` script that the Maven build runs, and pins existing Vue/Vite/test dependencies to the tested stable versions in `versions.json`. It is idempotent, and `--check` reports without writing. See [Vue.js Guide](references/VUE.md#1-project-setup).
  197. >
  198. > **Vitest + callback Vite config.** If `vite.config.js` exports `defineConfig(({ mode }) => ...)`, do not let the generated `vitest.config.js` call `mergeConfig(viteConfig, ...)`. Resolve the callback first with `viteConfig({ mode: 'test', command: 'serve' })`; otherwise Vitest fails with `Cannot merge config in form of callback`. See [Vue.js Guide](references/VUE.md#2-configure-vite-for-spring-boot-integration).
  199. ## Docker Deployment
  200. Spring Boot automatically manages Docker containers during development via `spring-boot-docker-compose`. For production, pick one of the four provided images: `Dockerfile` (JVM, jlink + distroless), `Dockerfile-aot` (JVM + Spring AOT), `Dockerfile-native` (GraalVM native), or `Dockerfile-crac` (CRaC fast-restore). See the [Docker Guide](references/DOCKER.md) for full setup, the matching Maven profiles, and deployment patterns.
  201. ## GraalVM Native Images
  202. Build native images via Docker (no local GraalVM needed) or locally with `./mvnw -Pnative -DskipTests package native:compile`. See the [GraalVM Guide](references/GRAALVM.md) for configuration, runtime hints, testing, and CI/CD integration.
  203. ## Azure Deployment
  204. Deploy to Azure Container Apps with an optional VNET-injected Azure Database for PostgreSQL Flexible Server. Uses GitHub Container Registry (GHCR) for image storage (pushed via `GITHUB_TOKEN` in CI, pulled by Container Apps using a stored PAT) and Container Apps secrets for the DB password — no secrets in source, env dumps, or shell history. Includes a GitHub Actions OIDC workflow, and supports both the JVM and GraalVM native image variants. See the [Azure Deployment Guide](references/AZURE.md).
  205. ## Validation
  206. | # | What | Command |
  207. |---|------|---------|
  208. | 1 | Build backend | `./mvnw clean install` |
  209. | 2 | Unit tests | `./mvnw test` |
  210. | 3 | Integration tests | `./mvnw verify` (uses Testcontainers 2 + `@ServiceConnection`) |
  211. | 4 | Front-end dev server | `cd frontend && npm run dev` |
  212. > Run validation steps first. If anything fails, fix before proceeding.
  213. Once the project is generated, go through the steps above to ensure that the generated project is fully functional and follows best practices. If any validation step fails, try to identify the issue and fix it before proceeding. This ensures that the generated project is of high quality and ready for development.
  214. ## Additional Resources
  215. ### Included Reference Guides
  216. **Core Spring Boot:**
  217. - [Spring Boot 4 Migration Guide](references/SPRING-BOOT-4.md) - Key changes from Spring Boot 3, Jackson 3 annotations
  218. - [Configuration Best Practices](references/CONFIGURATION.md) - Properties files, profiles, secrets management
  219. - [Logging Best Practices](references/LOGGING.md) - Logback configuration and patterns
  220. - [Java Code Intelligence (JDTLS)](references/JDTLS.md) - LSP-based navigation, refactoring, diagnostics
  221. **Data and Persistence:**
  222. - [Database Best Practices](references/DATABASE.md) - PostgreSQL and Hibernate optimization
  223. **Security (Optional):**
  224. - [Security Guide](references/SECURITY.md) - Spring Security, JWT, OAuth2, authentication patterns
  225. **Testing:**
  226. - [Testing Guide](references/TEST.md) - Unit and integration testing with TestContainers
  227. **Front-End Development:**
  228. - [Vue.js Development Guide](references/VUE.md) - Vue.js 3 with Vite (default)
  229. - [React Development Guide](references/REACT.md) - React 19 with Vite
  230. - [Angular Development Guide](references/ANGULAR.md) - Angular 22 with Angular CLI
  231. - [Vanilla JS Development Guide](references/VANILLA-JS.md) - Pure ES6+ with Vite
  232. **Project Setup:**
  233. - [Project Setup & Dotfiles](references/PROJECT-SETUP.md) - `.gitignore`, `.env.sample`, `.editorconfig`, `.gitattributes`, `.dockerignore`, `.devcontainer/`
  234. - [Git Best Practices](references/GIT.md) - daily Git workflow, branches, commits, pull requests, safe undo, stashing, and worktrees
  235. **Deployment:**
  236. - [Docker Deployment Guide](references/DOCKER.md) - Docker, Docker Compose, development automation
  237. - [GraalVM Native Images Guide](references/GRAALVM.md) - Docker-based native builds, optimization
  238. - [Azure Deployment Guide](references/AZURE.md) - Azure Container Apps, PostgreSQL Flexible Server, GitHub Container Registry (GHCR) image push/pull, Container Apps secrets for DB password, GitHub Actions OIDC
README.md · README · 170 lines

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

  1. # Dr JSkill
  2. <table>
  3. <tr>
  4. <td>
  5. <p><strong>An Agent Skill for creating Spring Boot applications following Julien Dubois' best practices.</strong></p>
  6. <p>Generate Spring Boot 4.x projects with Java 25, PostgreSQL, Docker support, and your choice of front-end framework (Vue.js, React, Angular, or Vanilla JS).</p>
  7. <p>Dr JSkill is an agent skill: it is meant to work with tools like GitHub Copliot CLI or Claude Code.
  8. </p>
  9. </td>
  10. <td align="right" valign="middle" width="340">
  11. <img src="./dr-jskill-small.png" alt="Dr JSkill logo" width="320" />
  12. </td>
  13. </tr>
  14. </table>
  15. ## Video Introduction
  16. <a href="https://youtu.be/Z8tWJ0NTy08">
  17. <img src="https://img.youtube.com/vi/Z8tWJ0NTy08/hqdefault.jpg" alt="Dr JSkill Video" width="480" />
  18. </a>
  19. ## What This Skill Provides
  20. - **Automated project generation** from https://start.spring.io with the latest available Spring Boot version
  21. - **Docker-ready** applications with standard and native image builds
  22. - **Multiple front-end options**: Vue.js (default), React, Angular, or Vanilla JS
  23. - **Production-ready** configurations with PostgreSQL, REST APIs, and monitoring
  24. ## Comparison with JHipster
  25. [JHipster](https://jhipster.tech) is an awesome Spring Boot application generator, also created by Julien Dubois.
  26. Dr JSkill builds on the JHipster experience:
  27. - It generates applications that should be similar to what JHipster creates
  28. - It is closer to Julien Dubois' tastes, as JHipster is ultimately the work of hundreds of people
  29. - Dr JSkill is an AI agent: it is not deterministic, it is slower and can cost some money to execute. But it is easier to tune, more versatile, and can update projects easily.
  30. At the moment, Dr JSkill is an experiment. If it is successful, it might join the JHipster organization.
  31. ## Workshop
  32. A full hands-on workshop — **GitHub Copilot CLI + Java, using Dr JSkill** — walks you through generating, extending, testing, and deploying a real Spring Boot + Vue application: **[workshop/README.md](workshop/README.md)**.
  33. ## Documentation
  34. For complete documentation, usage instructions, and best practices, see **[SKILL.md](SKILL.md)**.
  35. Additional references:
  36. - [Project Setup & Dotfiles](references/PROJECT-SETUP.md)
  37. - [Front-end Development Guides](references/) (Vue.js, React, Angular, Vanilla JS)
  38. - [Database Best Practices](references/DATABASE.md)
  39. - [Docker Deployment](references/DOCKER.md)
  40. - [Testing Guide](references/TEST.md)
  41. - [Azure Deployment](references/AZURE.md)
  42. - **Versions manifest:** `versions.json` (read by `scripts/lib/versions.mjs`). Update this file first when bumping any tool/library version.
  43. ## Using This Skill with AI Assistants
  44. This is an [Agent Skill](https://agentskills.io) that can be used with AI coding assistants that support the Agent Skills specification.
  45. **Recommended model:** Dr JSkill works best with **GPT-5.5**.
  46. ### Fork or clone this repository
  47. In order to use this skill, and modify it to your needs, you can fork this repository on GitHub, or simply clone it to your local machine.
  48. #### Forking on GitHub
  49. **Using the GitHub website:**
  50. 1. Navigate to the repository on GitHub
  51. 2. Click the "Fork" button in the top-right corner
  52. 3. Select your account as the destination
  53. 4. Clone your fork:
  54. ```bash
  55. git clone https://github.com/YOUR_USERNAME/dr-jskill.git
  56. ```
  57. **Using the GitHub CLI:**
  58. 1. Install the [GitHub CLI](https://cli.github.com/) if you haven't already
  59. 2. Fork and clone in one command:
  60. ```bash
  61. gh repo fork jdubois/dr-jskill --clone
  62. ```
  63. This will fork the repository to your GitHub account and clone it to your local machine.
  64. #### Just cloning (without forking)
  65. If you only want to use the skill locally without maintaining your own fork:
  66. ```bash
  67. git clone https://github.com/jdubois/dr-jskill.git
  68. ```
  69. ### GitHub Copilot CLI
  70. Configure skills for GitHub Copilot CLI by placing them in the skills directory:
  71. 1. Create the skills directory if it doesn't exist:
  72. ```bash
  73. mkdir -p ~/.github-copilot/skills
  74. ```
  75. 2. Clone or copy this skill to the skills directory:
  76. ```bash
  77. git clone <repository-url> ~/.github-copilot/skills/dr-jskill
  78. # Or copy: cp -r /path/to/dr-jskill ~/.github-copilot/skills/
  79. ```
  80. 3. Use GitHub Copilot CLI as usual - the skill will be automatically loaded:
  81. ```bash
  82. gh copilot suggest "create an application using the dr-jskill"
  83. ```
  84. The skill will be available for all `gh copilot` commands.
  85. ### GitHub Copilot (VS Code)
  86. 1. Open VS Code Settings (`Cmd+,` on macOS or `Ctrl+,` on Windows/Linux)
  87. 2. Search for `github.copilot.chat.codeGeneration.instructions`
  88. 3. Click "Edit in settings.json"
  89. 4. Add a skill entry:
  90. ```json
  91. {
  92. "github.copilot.chat.codeGeneration.instructions": [
  93. {
  94. "file": "/absolute/path/to/dr-jskill/SKILL.md"
  95. }
  96. ]
  97. }
  98. ```
  99. 5. Restart VS Code for changes to take effect
  100. Alternatively, you can enable skills globally by placing them in a specific directory:
  101. - macOS/Linux: `~/.github-copilot/skills/`
  102. - Windows: `%USERPROFILE%\.github-copilot\skills\`
  103. ### Claude Code / Windsurf (VS Code)
  104. Skills are automatically discovered from configured skill directories.
  105. 1. Clone or copy this skill to a directory on your system:
  106. ```bash
  107. git clone <repository-url> ~/skills/dr-jskill
  108. ```
  109. 2. Configure the skills directory in VS Code Settings:
  110. - Open Settings (`Cmd+,` or `Ctrl+,`)
  111. - Search for "skills" or look for your assistant's skill configuration
  112. - Add the path to your skills directory: `~/skills/`
  113. 3. Restart VS Code
  114. Claude Code will automatically discover all skills in the configured directory and load them when relevant to your task.
  115. ### Other Compatible Assistants
  116. This skill follows the [Agent Skills specification](https://agentskills.io/specification) and works with any compatible AI assistant. Refer to your assistant's documentation for configuration instructions.
  117. ## Requirements
  118. - Node.js 24.x and npm 11.x
  119. - Java 25
  120. - Docker (for containerized deployments)
  121. ## License
  122. This project is licensed under the Apache License 2.0.
  123. See [LICENSE](LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

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