zed-industries/zed · error

Paste a GitHub URL that points to a .md file

Error message

Paste a GitHub URL that points to a .md file

What it means

Raised in ensure_markdown_path when the URL's final path segment does not end with .md (case-insensitive). Only markdown skill files can be imported; the file name at fault is the last path segment of the GitHub URL.

Source

Thrown at crates/settings_ui/src/pages/skill_creator.rs:1115

    if *kind != "blob" {
        anyhow::bail!("Paste a GitHub blob URL that points to a .md file");
    }

    ensure_markdown_path(file_path)?;
    Ok(format!(
        "https://raw.githubusercontent.com/{owner}/{repo}/{reference}/{}",
        file_path.join("/")
    ))
}

fn ensure_markdown_path(path_segments: &[&str]) -> Result<()> {
    let Some(file_name) = path_segments.last() else {
        anyhow::bail!("Paste a GitHub .md URL");
    };

    if !file_name.to_ascii_lowercase().ends_with(".md") {
        anyhow::bail!("Paste a GitHub URL that points to a .md file");
    }

    Ok(())
}

fn parse_imported_skill(content: &str, source_url: &str) -> Result<ImportedSkill> {
    if content.trim_start().starts_with("---") {
        let (metadata, body) = parse_skill_file_content(content)?;
        return Ok(ImportedSkill {
            name: metadata.name,
            description: metadata.description,
            body: body.trim().to_string(),
            disable_model_invocation: metadata.disable_model_invocation,
        });
    }

    Ok(ImportedSkill {
        name: derived_skill_name_from_url(source_url).unwrap_or_else(|| "imported-skill".into()),

View on GitHub (pinned to 9d272b0363)

Solutions

1. Link directly to a .md file (e.g. SKILL.md), not a directory or other file type
2. If the skill is split across files, import the SKILL.md entry point

When it happens

Trigger: Thrown at crates/settings_ui/src/pages/skill_creator.rs:1115 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zed-industries/zed@9d272b0363 (2026-08-20). Data as JSON: /api/errors/7bcc8dd752677ecd. Report an issue: GitHub.