<img src="image/ddev-skills-logo.png" height="200px" />

DDEV Skills

Overview

This add-on integrates Skills into your DDEV project. It allows you to manage and install skills.sh via a simple configuration file. It reads the skills you want to install from a .env.skills file and uses npx to install them inside your DDEV web container. This add-on is ideal for developers who want to easily manage and update their skills directly within their project’s environment without requiring Node.js on their host machine.

Prerequisites

• DDEV: You need a running DDEV environment.
• Node.js: Node.js and npm must be available in your DDEV web container (usually included by default).

Installation

ddev add-on get OpenForgeProject/ddev-skills
ddev restart

Configuration

1. Create the configuration file: Navigate to your project’s .ddev directory and create a file named .env.skills. You can also copy the sample file provided:

   cp .ddev/.env.skills.sample .ddev/.env.skills
   

2. Add your skills: Edit .ddev/.env.skills and add the skills you want to install. The format is SkillName="GitRepoURL".

   Example .ddev/.env.skills:

   # Format: Skill-Name="url"
   MySkill="https://github.com/username/my-skill-repo"
   AnotherSkill="https://github.com/username/another-skill"
   

3. Version Control: Make sure to commit the .ddev/.env.skills file to version control so your team has the same skills configuration.

Usage

Run the following command within your DDEV project to install or update the skills defined in your configuration:

ddev skills

This command runs inside the web container and will:

• Read your .ddev/.env.skills file.
• Check if npx is available in the container.
• Install or update the specified skills using npx skills inside the container.

Commands

Credits

Contributed and maintained by @OpenForgeProject