# import-skill

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

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 540 repo stars
- Author: trailofbits
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trailofbits/skills-curated/tree/HEAD/.claude/commands/import-skill.md
- Updated: 2026-07-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/import-skill

## What it 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.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/import-skill.md` — Call it with /import-skill. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/import-skill.md` — Call it with /prompts:import-skill. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/import-skill.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/import-skill.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/trailofbits/skills-curated/tree/HEAD/.claude/commands/import-skill.md

## When to use it
- 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
- /import-skill owner/repo
- /import-skill <url>
- Convert this external repository using /import-skill <url>

## Similar
- [bulk-import-issues](https://affpapa.org/en/nevibecode/commands/bulk-import-issues.md) — command · 129 installs
- [import-issues](https://affpapa.org/en/nevibecode/skills/import-issues.md) — skill · ★ 571 repo stars
- [commit](https://affpapa.org/en/nevibecode/skills/orchestkit-commit.md) — skill · 210 installs
- [nx-import](https://affpapa.org/en/nevibecode/skills/nx-import.md) — skill · 2800 installs
- [prek](https://affpapa.org/en/nevibecode/skills/prek.md) — skill · 762 installs
- [project-bootstrapper](https://affpapa.org/en/nevibecode/skills/project-bootstrapper.md) — skill · 212 installs

From the same set: [trailofbits/skills-curated](https://affpapa.org/en/nevibecode/by/trailofbits/skills-curated.md) — 51 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
