skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
boshu2/agentops1.2k installs

heal-skill

Check or repair structural hygiene in AgentOps skill packages. Triggers: "heal skill", "repair skill hygiene", "audit skill structure", "check skill package".

How do I install this agent skill?

npx skills add https://github.com/boshu2/agentops --skill heal-skill
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a maintenance utility designed to automate skill hygiene and structural audits. It performs checks for missing metadata, broken file references, and naming inconsistencies, with optional auto-repair functionality for common issues. All operations are local to the skill repository, and no security risks were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    2/3 files flagged

  • ZeroLeakspass

    Score: 93/100 · 2 sections analyzed

What does this agent skill do?

/heal-skill — Check one or more skill packages

heal-skill is a specialist hygiene tool. It reports structural defects in canonical source skills and generated Codex twins. With --fix, it repairs only owned projections through their generators. It does not schedule work, operate Git, validate a software candidate, or decide what happens after a failure.

Inputs

bash skills/heal-skill/scripts/heal.sh --check [skills/<slug> ...]
bash skills/heal-skill/scripts/heal.sh --check --strict [skills/<slug> ...]
bash skills/heal-skill/scripts/heal.sh --fix [skills/<slug> ...]

Every explicit target must be a real, direct child of skills/ or skills-codex/. Missing paths, traversal, and symlink spellings are rejected.

Procedure

  1. Resolve and contain all requested target directories.
  2. Parse each SKILL.md frontmatter.
  3. Check the path/name match, description, API version, disposition metadata, and linked local references.
  4. Print every finding once.
  5. In --fix mode only, regenerate metadata-owned projections and scoped Codex twins, then stop.

--check is read-only. --strict makes any finding produce exit 1. A failed fix is returned to the caller; the skill does not retry or select another action.

Deep content audit

The optional read-only content audit is:

bash skills/heal-skill/scripts/audit.sh [--strict] [--json <path>] skills/<slug>

It combines the structural result with deterministic authoring checks and an advisory quality score. It is not the core Validate phase, does not write a verdict.v2, and has no delivery authority. Check definitions live in audit-checks.md; density scoring is described in context-density-checks.md.

Output

Structural findings are printed as:

[FINDING_CODE] skills/example: concrete explanation

Deep audit JSON conforms to audit-report.json. The caller owns any subsequent edit or invocation.

Checks

  • Check mode never mutates files.
  • Fix mode changes only an explicit source target and its owned projections.
  • A second identical fix is idempotent.
  • Generated Codex parity follows codex-parity.md.
  • Remaining non-fixable findings stay explicit.

Related executable specifications

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/boshu2/agentops/heal-skill">View heal-skill on skillZs</a>