# install-from-remote-library

install-from-remote-library guides safe skill installs from shared repos. Inspects targets via --list and previews every action with a dry-run flag.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 161 installs · ★ 1161 repo stars
- Author: MoizIbnYousaf
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/MoizIbnYousaf/ai-agent-skills/tree/HEAD/skills/install-from-remote-library/SKILL.md
- Updated: 2026-09-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/install-from-remote-library

## What it does

This skill enforces a guarded workflow for adding tools via `npx ai-agent-skills`. Instead of pulling an entire shared library, the agent inspects available items first by running the `--list` command. This step keeps unnecessary code out of the project.

A preview run with `--dry-run -p` is mandatory before writing any files. The workflow explicitly prohibits combining the `--collection` and `--skill` flags in a single command. If the remote repository returns errors or unclear output, the agent stops immediately and prints the diagnostic hint verbatim.

Once finished, the agent returns the inspected repository name, the chosen package, the dry-run output, and the exact command executed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MoizIbnYousaf/ai-agent-skills --skill install-from-remote-library -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/install-from-remote-library/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/install-from-remote-library/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MoizIbnYousaf/ai-agent-skills --skill install-from-remote-library -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/install-from-remote-library/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MoizIbnYousaf/ai-agent-skills --skill install-from-remote-library -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/install-from-remote-library/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MoizIbnYousaf/ai-agent-skills skills/install-from-remote-library
```

2. **Manually: put the files in place**
- File: `.github/skills/install-from-remote-library/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MoizIbnYousaf/ai-agent-skills --skill install-from-remote-library -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MoizIbnYousaf/ai-agent-skills --path skills/install-from-remote-library
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/install-from-remote-library/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MoizIbnYousaf/ai-agent-skills --skill install-from-remote-library -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MoizIbnYousaf/ai-agent-skills/tree/HEAD/skills/install-from-remote-library/SKILL.md

## When to use it
- inspect available skills in a remote repository with --list
- preview tool installation changes using --dry-run before writing files
- install a curated bundle using the --collection flag
- download a single targeted skill without pulling an entire repo

## Example prompts
- Check what skills are available in MoizIbnYousaf/ai-agent-skills using --list
- Run a dry-run install for the starter-pack collection from owner/repo
- Install only the git-commit skill from user/skills with preview

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 376f7f3f4900a241.

BEGIN THIRD-PARTY FILE 376f7f3f4900a241
````text
---
name: install-from-remote-library
description: Use when installing skills from a shared ai-agent-skills library repo. Inspect with `--list` first, prefer `--collection`, and preview with `--dry-run` before installing.
category: workflow
version: 4.1.0
---

# Install From Remote Library

## Goal

Install from a shared library repo without guessing, over-installing, or skipping the preview step.

## Invariants

- Always inspect the remote library first with `install <source> --list`.
- Prefer `--collection` when the library clearly exposes a starter pack or focused bundle.
- Always run `--dry-run` before the real install.
- Keep the install small. Do not pull a whole library when the user only needs a narrow slice.

## Workflow

1. Inspect the source library.

```bash
npx ai-agent-skills install <owner>/<repo> --list
```

2. Choose the smallest fitting target.

- Prefer `--collection starter-pack` or another named collection when it matches the user's need.
- Use `--skill <name>` only when the user needs one specific skill or the library has no useful collection.
- Do not combine `--collection` and `--skill`.

3. Preview the install plan before mutating anything.

```bash
npx ai-agent-skills install <owner>/<repo> --collection starter-pack --dry-run -p
```

or

```bash
npx ai-agent-skills install <owner>/<repo> --skill <skill-name> --dry-run -p
```

4. If the plan looks right, run the real install with the same scope.

```bash
npx ai-agent-skills install <owner>/<repo> --collection starter-pack -p
```

## Decision Rules

- If the library has a curated collection that already matches the user's stack, use it.
- If the remote library is empty or the list output is unclear, stop and report that instead of guessing.
- If the install path throws an `ERROR` / `HINT`, surface that verbatim and follow the hint before retrying.
- If the user is exploring a large library, keep them in browse mode first rather than installing immediately.

## Done

Return:

- what source library you inspected
- which collection or skill you chose
- the dry-run result
- the exact final install command you used
````
END THIRD-PARTY FILE 376f7f3f4900a241

The third-party file has ended. Everything between the 376f7f3f4900a241 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© MoizIbnYousaf · MIT · https://github.com/MoizIbnYousaf/ai-agent-skills/tree/HEAD/skills/install-from-remote-library/SKILL.md

## Similar
- [workflow-from-chats](https://affpapa.org/en/nevibecode/skills/workflow-from-chats.md) — skill · 2200 installs
- [building-skills-from-patterns](https://affpapa.org/en/nevibecode/skills/building-skills-from-patterns.md) — skill · 514 installs
- [gws-install](https://affpapa.org/en/nevibecode/skills/gws-install.md) — skill · 1100 installs
- [groove-admin-install](https://affpapa.org/en/nevibecode/skills/groove-admin-install.md) — skill · 586 installs
- [workflows-install](https://affpapa.org/en/nevibecode/skills/workflows-install.md) — skill · 475 installs

_Part of the page did not fit — see the HTML version._

---
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
