install-skill

Files (3)

• SKILL.md
• install.mjs
• search.mjs

SKILL.md (first lines)

# Install Skill

Search for skills on skills.sh and install them into the project's `skills/` directory. Always project level.

## Scripts

Two scripts are provided in this skill's directory:

### Search: `search.mjs`

```bash
node ${SKILL_DIR}/search.mjs "<query>"
```

Returns JSON array of matching skills:
```json
[{"source": "owner/repo", "id": "skill-name", "name": "skill-name", "installs": 1234}]
```

### Install: `install.mjs`

```bash
node ${SKILL_DIR}/install.mjs <owner/repo> <skill-name> <project-skills-dir>
```

Downloads all skill files from the GitHub repo into `<project-skills-dir>/<skill-name>/`. Returns:
```json
{"ok": true, "skill": "name", "source": "owner/repo", "path": "/full/path", "files": ["SKILL.md", ...]}
```

## Workflow

1. If the user gives a specific repo and skill name, skip to step 3.

2. **Search**: Run `search.mjs` with the user's query. Show the top results as a numbered list with name, repo, and install count. Ask which one they want.

3. **Install**: Run `install.mjs` with the chosen repo, skill name, and the project's `skills/` directory path.

4. **Confirm**: Show what was installed — skill name, source, files downloaded, and path.

Replace `${SKILL_DIR}` with the actual path to this skill's directory when running the scripts.

From NorthIsUp/errandd, MIT.

More from NorthIsUp/errandd