Preface

When developing agents or configuring workflows with DeepSeek Harness (DSH), ensuring that a repository follows standard conventions—such as including documentation and a license—is a common requirement. The dsh-repo-health plugin automates this process, replacing manual item-by-item verification and directly returning check results with remediation suggestions.

Plugin Overview

This plugin checks common repository best practices, including README, LICENSE, .gitignore, tests, CI, lockfiles, scripts, and .env.example, and returns a health check report. It is implemented in pure Node.js and requires no network access or external service dependencies.

Core Features

The plugin provides a health_check tool that performs checks item by item and outputs the results. The main checks include:
* README
* LICENSE
* .gitignore
* Tests
* CI workflows
* Dependency lockfile
* npm scripts
* .env.example

The tool returns a ✓/✗ status, remediation suggestions, and an overall score for each item.

Installation and Enablement

Run the following command in the terminal to install:

dsh plugin add github:uckkk/dsh-repo-health

After installation, you need to enable the plugin in the project’s package.json configuration file. Add the following to the dsh.profile.bundles field:

"dsh-repo-health"

Typical Usage

Call the health_check tool in a DSH session and specify the project root directory path. Example:

health_check(root="/workspace")

Notes

  • Code execution permissions: This plugin runs code locally with the permissions of the current DSH process. Please review the source code carefully before installing it.
  • Dependency requirements: This plugin requires @deepseek-ai/cordis and @deepseek-ai/dsh-tools as dependencies.

Follow-up

By following the steps above, you can quickly understand whether your project complies with best-practice conventions. For more details, refer to the plugin directory or the GitHub repository.

Directory and Links
- Plugin directory: https://www.skillhub.cn/plugins/uckkk/dsh-repo-health
- GitHub repository: https://github.com/uckkk/dsh-repo-health