Skip to main content
command CX Codex

import-skill — Claude Code command: what it does, how to install

Imports external skills from GitHub into a curated Claude Code plugin repository, rewriting paths and generating required manifests.

CC-BY-SA-4.0 ★ 540 updated 2026-07-14

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/import-skill.md
Open on GitHub

What import-skill does

This slash command packages an external skill repository into a Claude Code plugin directory. It accepts an owner/repo identifier or a GitHub link, runs a Python helper via uv to download the file tree into a temporary folder, and reads the documentation. The routine treats downloaded files as untrusted content, refusing to execute any scripts during the analysis stage.

During transformation, the command replaces environment markers such as $CODEX_HOME and $PI_HOME with {baseDir}/. It strips vendor-specific sandbox directives, splits markdown files exceeding 500 lines into references/, and generates both plugin.json and README.md. Linters like ruff, shellcheck, and shfmt then format and validate all bundled scripts.

The import halts immediately if the local gh CLI tool is unauthenticated.

What it helps with

  • import an external skill repository into a Claude Code plugin structure
  • normalize platform-specific paths like $CODEX_HOME to {baseDir}/
  • split oversized documentation files into smaller reference guides
  • run code linters on imported Python and shell utilities

Example prompts for the agent

  • /import-skill owner/repo
  • /import-skill <url>
  • Convert this external repository using /import-skill <url>

How to install import-skill

Manually: put the files in place

.claude/commands/import-skill.md

Call it with /import-skill. For all projects use ~/.claude/commands/

Questions about import-skill

How to install import-skill in Claude Code?

Place the command definition file into .claude/commands/import-skill.md.

What does import-skill do?

It downloads a skill tree from GitHub, transforms paths and metadata into a valid plugin format, and runs script linters.

What dependencies are required for import-skill?

You need an authenticated gh CLI session, uv to run the helper script, plus ruff, shellcheck, and shfmt.

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set51

The whole set →
skill-extractor skill-extractor turns a finished session into a reusable Claude skill: the cause of a failure, a workaround, the symptom that points to it. CX Codex +1 ★ 540repo stars openai-screenshot openai-screenshot captures desktop screenshots, active windows, or pixel regions directly from Claude Code. Built for OS-level interface inspection. CX Codex +1 ★ 540repo stars openai-develop-web-game openai-develop-web-game guides an agent through building HTML and JavaScript browser games with incremental changes and Playwright-based tests. CX Codex +1 ★ 540repo stars writing-great-skills Use this skill to shape, review, or trim SKILL.md files. It helps when a skill behaves inconsistently or its instructions have grown unwieldy. CX Codex +1 ★ 540repo stars wooyun-legacy wooyun-legacy guides web vulnerability reviews using attack patterns from the WooYun archive. Built for authorized penetration testing, source code audits, and flaw research. CX Codex +1 ★ 540repo stars productivity The productivity plugin for Claude Code brings together four skills for day-to-day agent work: plan interrogation, session handoff, teaching, and skill writing. ★ 540repo stars security-awareness security-awareness instructs agents to detect phishing, verify domains, and stop secret leaks when handling credentials, web browsing, or sensitive data. ★ 540repo stars python-code-simplifier The python-code-simplifier plugin refines recently changed Python code without altering its behavior. Use it after edits to make the code easier to read and maintain. ★ 540repo stars

Project sponsors

Companies that keep this analytics open