Importing the pack into another agent¶

The pack needs no system installation: it is a directory you call by path. "Importing" means two things — a copy of the pack inside the agent's skill root, and a rules line that tells the agent where that copy is and how to prove it is intact.

What is copied¶

install copies AGENTS.md, the root documents, CITATION.cff, and the skills/, tools/, tests/, reference/, docs/, wiki/, .github/ directories, then writes .install.json with a sha256 per file. The tests come along on purpose: without them neither selftest nor any proof that the installed copy behaves as tested is possible.

AutoClaw2¶

Skill root: %USERPROFILE%\.pi\agent\skills; rules: %USERPROFILE%\.pi\agent\AGENTS.md.

git clone https://github.com/paulmann/github-agent.git "$env:USERPROFILE\src\github-agent"
Set-Location "$env:USERPROFILE\src\github-agent"

python tools\ghagent.py install --profile autoclaw --write
python tools\ghagent.py verify-install --profile autoclaw
python tools\ghagent.py snippet --profile autoclaw

Paste the printed block into %USERPROFILE%\.pi\agent\AGENTS.md. The skill list is read at session start, so a new skill appears in the next session, not in the current one.

HARNESS¶

Skill root: %USERPROFILE%\.dsh\skills; rules: %USERPROFILE%\.dsh\AGENTS.md.

python tools\ghagent.py install --profile harness --write
python tools\ghagent.py verify-install --profile harness
python tools\ghagent.py snippet --profile harness

SagaAI¶

There is no measured skill root for SagaAI, so the path is supplied explicitly. If the agent reads rules from the project's AGENTS.md, naming the pack path and the verification command there is enough — the pack is self-contained.

git clone https://github.com/paulmann/github-agent.git <dir>
python tools/ghagent.py install --target <saga-skill-root> --write
python tools/ghagent.py snippet --target <saga-skill-root>

snippet prints text, it does not write a file: where that block belongs is the owner's decision.

Verifying an import¶

python tools/ghagent.py verify-install --profile <autoclaw|harness>   # 0 means the copy is intact
python tools/ghagent.py --version

Outcome	Meaning	Action
`verify.ok`, exit `0`	the copy matches the installation manifest	work
`verify.changed`, exit `1`	a file changed after installation	reinstall
`verify.missing`, exit `1`	a file was deleted	reinstall
`verify.manifest`, exit `1`	the directory was not installed by this pack	do not trust it, install again
`verify.extra`, `info`	a file outside the manifest	check whether it is debris

Updating¶

git -C <pack dir> pull
python tools/ghagent.py install --profile <profile> --write
python tools/ghagent.py verify-install --profile <profile>

install overwrites files and rewrites the manifest, so verify is green again afterwards. The previous copy is not archived: git restores it in one step.

Removing¶

python tools/ghagent.py uninstall --profile <profile> --write

Removal without .install.json is refused: the command has no right to delete a directory another tool created. The rules block in the agent's AGENTS.md is removed by hand — the pack does not edit foreign rule files.