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
.claude/commands/import-skill.mdWhat 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_HOMEto{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.mdCall it with /import-skill. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/import-skill.mdCall it with /prompts:import-skill. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/import-skill.prompt.mdManually: put the files in place
.gemini/commands/import-skill.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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.