odysseus-dev/odysseus · error · SkillImportError

No SKILL.md found — link to a skill folder or SKILL.md on Gi

Error message

No SKILL.md found — link to a skill folder or SKILL.md on GitHub

What it means

Error "No SKILL.md found — link to a skill folder or SKILL.md on GitHub" thrown in odysseus-dev/odysseus.

Source

Thrown at services/memory/skill_importer.py:473

        except Exception:
            pass
        try:
            text = _fetch_text(_raw_url(src, path))
            if path.lower().endswith(".md"):
                files[path] = text
                return files, src
        except Exception:
            pass
        _list_github_dir(src, path, files)
    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. Link to a folder that contains a SKILL.md file.
2. Point the URL directly at the SKILL.md on GitHub.

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/87d2d1a0b9df2b2c. Report an issue: GitHub.