reference-module

Original：🇺🇸 English

Translated

Use when researching another Git repository

5installs

Added on2026-06-02

NPX Install

npx skill4agent add skarian/skills reference-module

Use when the user asks to inspect, compare, or research another Git repository.

Get the repo URL, plus any requested branch, tag, commit, or alias.
Resolve storage from the active
```
SKILL.md
```
: find the nearest parent named
```
skills
```
; its parent is
```
<scope-root>
```
. If unavailable, ask for a storage path.
Store references in
```
<scope-root>/reference-modules/<name>
```
, where
```
<name>
```
is the alias,
```
<owner>/<repo-name>
```
when the URL has an owner or group, or the repo basename when it does not. Strip trailing
```
.git
```
.
If the target exists, ask unless the user already chose:
- use as-is: do not fetch or check out; report current ref/SHA
- update: fetch, then check out the requested ref or remote
```
HEAD
```
- copy: clone into a separate directory; ask for a name unless alias was provided Never modify an unsafe or wrong-repo target without asking.
If the target is missing, clone it. Use remote
```
HEAD
```
unless a ref was requested.

Fetch only for update/copy:

bash

git -C <reference-path> fetch --all --tags --prune

After clone/update/copy, check out the requested ref or remote
```
HEAD
```
, preferably detached. If the user chose use as-is, leave it untouched.
Treat contents as read-only. Do not create submodules, symlinks, or pointer files unless explicitly asked.
Report path, source URL, action taken, checked-out ref, and commit SHA.