← Back to Skills Marketplace
charlie-morrison

Repository Health Score

by charlie-morrison · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
47
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install repository-health-score
Description
Score a repository's health across 8 dimensions — code quality, testing, documentation, CI/CD, security, dependencies, community, and maintainability. Produc...
Usage Guidance
This skill runs many shell searches and small utilities against a repository to compute scores — that's consistent with its purpose. However, the SKILL.md calls tools such as ripgrep (rg), python3, bc, find, awk, grep, wc, head, etc., while the skill metadata lists no required binaries or install steps. Before installing or invoking it: (1) review the full SKILL.md yourself; (2) run it in a safe/isolated environment (container or VM) first; (3) ensure required tools are installed (or ask the author to declare them); (4) be mindful the tool will read and print repository contents (including potential secret-like strings), so avoid running it in repos containing sensitive data unless you trust the environment and capture/retention policies.
Capability Analysis
Type: OpenClaw Skill Name: repository-health-score Version: 1.0.0 The repository-health-score skill performs static analysis of a local codebase to calculate a health score across multiple dimensions. It uses standard shell utilities and Python for JSON parsing to check for the presence of documentation, tests, CI/CD configurations, and security best practices (like searching for hardcoded secrets). There is no evidence of data exfiltration, malicious execution, or unauthorized network activity.
Capability Tags
requires-walletrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The skill's stated purpose (scoring a repository across multiple dimensions) matches the actions in SKILL.md (inspecting README, tests, CI config, lockfiles, searching for secrets). However the SKILL.md invokes several command-line tools (examples seen: rg (ripgrep), python3, bc, find, wc, grep, awk, ls, head) but the registry metadata declares no required binaries. This mismatch is disproportionate and likely to cause runtime failures or hidden dependencies.
Instruction Scope
Instructions are limited to scanning repository files and producing scores, which aligns with the stated purpose. The script intentionally searches for potential secrets (regex hits) and inspects many files; this is expected for a health scan but means the tool will read any file in the repo. There are no explicit outbound network calls in the visible SKILL.md, but the skill prints potentially sensitive content (secret hits) to stdout — consider that outputs could be captured or sent by the caller.
Install Mechanism
This is an instruction-only skill with no install spec (low write-to-disk risk). However, the lack of an install spec combined with undeclared runtime dependencies is risky: users will need to ensure appropriate tools are present (ripgrep, python3, bc, etc.). The skill does not provide guidance to install or vendor these tools.
Credentials
The skill does not request environment variables, credentials, or config paths. Its scanning of the repository content is proportional to the purpose. Note: because it searches for secret-like patterns, it may identify sensitive strings present in the repo — the behavior is expected but worth being explicit about.
Persistence & Privilege
The skill is not always-enabled and does not request persistent system presence or modify other skills; autonomous invocation is allowed by platform default but not combined with other elevated privileges here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install repository-health-score
  3. After installation, invoke the skill by name or use /repository-health-score
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — easily assess repository health across 8 critical dimensions with a composite score and actionable tips. - Scores a repository 0–100 (A–F) across code quality, testing, documentation, CI/CD, security, dependencies, community, and maintainability. - Provides detailed breakdowns and scoring logic for each assessment dimension. - Generates actionable improvement suggestions per area. - Ideal for quick repo audits, adoption decisions, or due diligence on open source projects.
Metadata
Slug repository-health-score
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Repository Health Score?

Score a repository's health across 8 dimensions — code quality, testing, documentation, CI/CD, security, dependencies, community, and maintainability. Produc... It is an AI Agent Skill for Claude Code / OpenClaw, with 47 downloads so far.

How do I install Repository Health Score?

Run "/install repository-health-score" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Repository Health Score free?

Yes, Repository Health Score is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Repository Health Score support?

Repository Health Score is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Repository Health Score?

It is built and maintained by charlie-morrison (@charlie-morrison); the current version is v1.0.0.

💬 Comments