zeroclaw-labs/zeroclaw · error · anyhow::Error

Open-skill markdown not found

Error message

Open-skill markdown not found: {}

What it means

Fires inside audit_open_skill_markdown when the given open-skill markdown file path does not exist on disk at audit time. Auditing requires the skill's markdown document to be present so its sections can be checked; a missing file means the skill is broken or the path was computed against the wrong root. The caller should verify the path resolution and ensure the skill directory contains its documentation file before auditing.

Solutions

  1. Add the expected open-skill markdown file at the path, or fix the configured path.
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at crates/zeroclaw-runtime/src/skills/audit.rs:79 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/4cd7e2ca1d1cd1e9. Report an issue: GitHub.

Appendix: source

Thrown at crates/zeroclaw-runtime/src/skills/audit.rs:79

        .iter()
        .any(|name| canonical_root.join(name).is_file());
    if !has_canonical && !has_deprecated {
        report.findings.push(format!(
            "Skill root must include {SKILL_MANIFEST_FILENAME} (canonical) or one of {SKILL_DEPRECATED_MANIFESTS:?} (deprecated) for deterministic auditing.",
        ));
    }

    for path in collect_paths_depth_first(&canonical_root)? {
        report.files_scanned += 1;
        audit_path(&canonical_root, &path, &mut report, options)?;
    }

    Ok(report)
}

pub fn audit_open_skill_markdown(path: &Path, repo_root: &Path) -> Result<SkillAuditReport> {
    if !path.exists() {
        bail!(
            "Open-skill markdown not found: {}",
            path.display().to_string()
        );
    }
    let canonical_repo = repo_root
        .canonicalize()
        .with_context(|| format!("failed to canonicalize {}", repo_root.display().to_string()))?;
    let canonical_path = path
        .canonicalize()
        .with_context(|| format!("failed to canonicalize {}", path.display().to_string()))?;
    if !canonical_path.starts_with(&canonical_repo) {
        bail!(
            "Open-skill markdown escapes repository root: {}",
            path.display()
        );
    }

    let mut report = SkillAuditReport {

View on GitHub (pinned to 88bb9c8533)