fix-urls

Resolve and correct repository URLs from CSV sources using layered resolution and GitHub API.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/noemotiovon/oss-x --skill fix-urls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-urls
Source: https://github.com/noemotiovon/oss-x/tree/main/.claude/skills/fix-urls
Command: npx skills add https://github.com/noemotiovon/oss-x --skill fix-urls

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automates the detection and correction of problematic repository URLs in seed data, reducing manual curation and preventing broken downstream workflows.

Core Features & Use Cases

  • Layered URL resolution: L0 known mappings, L1 URL normalization and retry, L2 GitHub search, L3 Bioconductor → GitHub, L4 mirror detection.
  • Script-first, LLM-last workflow: deterministic steps with fallback verification for unresolved items.
  • Caching and resumability: results are cached to support restart without re-processing.

Quick Start

Run the fix_urls.py script on the cleaned data to generate output/fix_urls.csv and review results.

Frequently Asked Questions about fix-urls

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix broken or misdirected repository URLs in a CSV file?

To fix problematic repository URLs in a CSV file, you can run a deterministic script that applies multi-layer resolution including URL normalization, GitHub search, and mirror detection to normalize your data.

What is mirror detection for GitHub repository URLs?

Mirror detection is a resolution step that flags potential mirror repositories by applying deterministic URL mappings and limited LLM web search to verify unresolved items in your dataset.

Do I need Python and GitHub API access to normalize repository URLs?

Yes, normalizing repository URLs with this script requires Python, access to the GitHub API, and a configured environment to run the fix_urls script and cache results locally.

Can I resume URL validation if my data cleaning pipeline crashes?

Yes, you can resume URL validation because the script caches results to support restart without re-processing, ensuring your pipeline can continue from where it stopped.

How does LLM web search verify unresolved GitHub URLs?

LLM web search acts as a last-resort fallback verification step for unresolved GitHub URLs, operating only after deterministic layers like known mappings, URL normalization, and Bioconductor resolution are exhausted.