inspiration-importer

Import GitHub repositories, gists, URLs, and local files into the inspiration directory.

2|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/gjkeller/doctor-ralph --skill inspiration-importer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inspiration-importer
Source: https://github.com/gjkeller/doctor-ralph/tree/main/.cursor/skills/inspiration-importer
Command: npx skills add https://github.com/gjkeller/doctor-ralph --skill inspiration-importer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of bringing external content like GitHub repositories, gists, URLs, and local files into your project's inspiration/ directory for easy review and management.

Core Features & Use Cases

  • Versatile Importing: Supports GitHub repos (full or partial paths), gists, raw URLs, and local files/folders.
  • Automated Organization: Places imported content under inspiration/ with unique, collision-avoiding folder names.
  • Source Tracking: Creates a _SOURCE.md file to record import details and sync status.
  • Content Summarization: Generates a structured summary of imported content, including skills, docs, and other assets.
  • Use Case: Quickly import a relevant open-source project's documentation into your inspiration/ folder to reference its structure and content for your own project.

Quick Start

Import the GitHub repository located at https://github.com/owner/repo into the inspiration directory.

Frequently Asked Questions about inspiration-importer

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

FAQPage Schema
How do I import a GitHub repository into my project for reference?

To import a GitHub repository, the tool clones the source into a unique folder within the `inspiration/` directory. It supports full or partial repository paths and handles git submodules automatically.

Can I download content from a raw URL or gist into my local files?

Yes, you can download content from raw URLs and gists. The tool performs direct downloads of this external content into the `inspiration/` directory while tracking the original source.

What is the best way to organize external knowledge and avoid file name collisions?

Organizing external knowledge is handled automatically by placing imported content into the `inspiration/` directory using unique, collision-avoiding folder names to prevent overwrites.

Does the import process track where the external content originated?

Yes, the import process tracks the source by creating a `_SOURCE.md` file. This file records specific import details and sync status for reviewing where the external content originated.

How do I get a summary of imported files from a URL or local folder?

The tool generates a structured summary of imported files automatically after downloading. This summary includes skills, docs, and other assets from URLs or local folders for quick review.

What happens if I try to import local files to a directory that already has existing imports?

When importing local files to a directory with existing imports, the tool provides options to handle them. It uses collision-avoiding folder names to ensure new content does not overwrite existing data.