odysseus-dev/odysseus · error · SkillImportError

bundle has no SKILL.md

Error message

bundle has no SKILL.md

What it means

Error "bundle has no SKILL.md" thrown in odysseus-dev/odysseus.

Source

Thrown at services/memory/skill_importer.py:483

    else:
        _list_github_dir(src, "", files)

    if not any(p.lower().endswith("skill.md") for p in files):
        # Flat repo root with SKILL.md only
        try:
            files["SKILL.md"] = _fetch_text(_raw_url(src, "SKILL.md"))
        except Exception as e:
            raise SkillImportError(
                "No SKILL.md found — link to a skill folder or SKILL.md on GitHub"
            ) from e
    return files, src


def pick_skill_md(files: Dict[str, str]) -> Tuple[str, str]:
    for rel, content in files.items():
        if rel.lower().endswith("skill.md"):
            return rel, content
    raise SkillImportError("bundle has no SKILL.md")


def default_category_from_source(src: ResolvedSource) -> str:
    return "imported"

View on GitHub (pinned to f9235ebbf1)

Solutions

1. Ensure the skill bundle includes a SKILL.md at its root.
2. Re-export the skill with its SKILL.md present.

When it happens

Trigger: Triggered when the corresponding server-side validation or runtime check at the recorded location rejects the request or operation and returns this error message to the caller.

Common situations: See trigger scenarios.

AI-assisted analysis of odysseus-dev/odysseus@f9235ebbf1 (2026-08-14). Data as JSON: /api/errors/c55ebde337a668df. Report an issue: GitHub.